Skip to content

Files

Latest commit

tdiderichtdiderich
README clean up
Mar 5, 2025
9fce776 · Mar 5, 2025

History

History

digital-ocean

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
README.md
README.md
Mar 5, 2025
custom-integration-digital-ocean.star
custom-integration-digital-ocean.star
Mar 5, 2025

README.md

Custom Integration: Digital Ocean

runZero requirements

Digital Ocean requirements

  • API Client Token (Personal Access Token) with appropriate permissions.
  • API URL: https://api.digitalocean.com/v2/.

Steps

Digital Ocean configuration

  1. Generate a Personal Access Token from the API Tokens page in your Digital Ocean account.
    • Ensure the token has the required permissions to access droplets and associated metadata.
  2. Note down the API URL: https://api.digitalocean.com/v2/.
  3. Test your API token by making a sample request using a tool like curl or Postman to verify access.

runZero configuration

  1. (OPTIONAL) - Make any necessary changes to the script to align with your environment.
    • Modify API calls as needed to filter assets.
    • Modify datapoints uploaded to runZero as needed.
  2. Create the Credential for the Custom Integration.
    • Select the type Custom Integration Script Secrets.
    • Use the access_secret field for your Digital Ocean API token.
    • For access_key, input a placeholder value like foo (unused in this integration).
  3. Create the Custom Integration.
    • Add a Name and Icon for the integration (e.g., "digital-ocean").
    • Toggle Enable custom integration script to input the finalized script.
    • Click Validate to ensure it has valid syntax.
    • Click Save to create the Custom Integration.
  4. Create the Custom Integration task.
    • Select the Credential and Custom Integration created in steps 2 and 3.
    • Update the task schedule to recur at the desired timeframes.
    • Select the Explorer you'd like the Custom Integration to run from.
    • Click Save to kick off the first task.

What's next?

  • You will see the task kick off on the tasks page like any other integration.
  • The task will update the existing assets with the data pulled from the Custom Integration source.
  • The task will create new assets for when there are no existing assets that meet merge criteria (hostname, MAC, etc).
  • You can search for assets enriched by this custom integration with the runZero search custom_integration:digital-ocean.