Folders and files Name Name Last commit message
Last commit date
parent directory
View all files
Custom Integration: Drata
API Client Token with permissions to access the Drata public API.
API URL: https://public-api.drata.com.
Generate an API Client Token from your Drata account.
Refer to the Drata API Documentation for instructions.
Ensure the token has permissions to access the public/assets endpoint and related metadata.
Note down the API URL: https://public-api.drata.com.
Test your API token by querying the /public/assets endpoint using a tool like curl or Postman.
(OPTIONAL) - Make any necessary changes to the script to align with your environment.
Modify API calls as needed to filter assets (e.g., by assetClassType or employmentStatus).
Modify datapoints uploaded to runZero as needed.
Create the Credential for the Custom Integration .
Select the type Custom Integration Script Secrets.
Use the access_secret field for your Drata API Client Token.
For access_key, input a placeholder value like foo (unused in this integration).
Create the Custom Integration .
Add a Name and Icon for the integration (e.g., "drata").
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.
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.
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:drata.
You can’t perform that action at this time.