Integrating Drata
Capabilities
DataGrail's Drata integration provides the following capabilities:
Product | Capability |
---|---|
Live Data Map | System Detection |
Before You Start
To successfully configure this integration, please ensure you have sufficient privileges:
- DataGrail User Role: Super Admin, Connections Manager
- Drata User Role: Admin
Get Drata API Key
- Log in to Drata.
- In the bottom left, select your Account and then Settings.
- Select API Keys.
- Select New API Key and enter the following configuration:
API Key Configuration
Name: DataGrail
(You can use any value)
Expiration Date: Set a value (default: 12 months)
Scopes: Get Managed Connections: Read
- Select Save.
- Copy the API Key and store it in a secure temporary location.
- Select the box for "I have stored this API Key information in a secure location." and then select Done.
Connect to DataGrail
- In DataGrail, navigate to Integrations and select Configure New Integration to search for Drata.
- Enter the API Key.
- Select Configure Integration.
Next Steps
Now that you've successfully connected the integration, check out the following resources:
- Direct Contact Integrations
- Learn more about Live Data Map
- Live Data Map - System Inventory
- Inventory System Reports Overview
Troubleshooting
If you are unable to successfully connect the integration, review these common troubleshooting steps:
Ensure Required Permissions Are Granted on API Keys/Resources
DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.
Review Required Account Types and User Roles
If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.
See Before You Start to review these requirements.
Technical Details
The Drata integration uses the REST API.API Documentation
Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.
Disclaimer: The information contained in this message does not constitute as legal advice. We would advise seeking professional counsel before acting on or interpreting any material.