![Hyperproof.Io [Test] Help Center](https://downloads.intercomcdn.com/i/o/xgk1dxp2/757668/427b255f2659cc7e0853d6a00ec1/628914ae2617199b7d999ba797a5305a.png)
Note: Hyperproof connects to many third-party systems that frequently change, including the system interface. Contact your System Administrator or the third-party provider for assistance in meeting the requirements to integrate with Hyperproof and collect the proof you need.
When you create a Hypersync between Hyperproof and Datadog, you can automatically collect the following proof types:
Datadog proof types and fields
Proof type | Fields | Testable |
Alert Configurations | Name, Critical Threshold, Warning Threshold, Critical Recovery Threshold, Warning Recovery Threshold | Yes |
List of Active Users | Name, Email, Roles, Created On | Yes |
List of Hosts | Name, Platform, Status, CPU, IO Wait, Load 15, Apps | Yes |
List of Monitors | Priority, Status, Name, Tags | Yes |
List of Incidents | State, Severity, Title, Created Date, Detected Date, Resolved Date | Yes |
Additional documentation
Note: You only need to connect Hyperproof to the app once, and then you can create as many Hypersyncs as you need.
Additionally, you can create multiple Hypersyncs for a single control or label.
Connection configuration
Authentication type: Custom
Custom authentication parameters: Application Key, API Key, Site URL
To connect to Datadog and collect proof, your Datadog configuration must meet the following requirements.
Step One: Create a new Hypersync role
Sign in to your Datadog account.
In the bottom left-corner, hover over your name.
From the Organization settings, select Roles.
Highlight Datadog Read Only Role, then click the Clone icon.
Add a name for the new role, i.e. Hyperproof/Hypersync Role.
Configure the minimum required permissions for the Hypersync to work, then click Save.
Note: The User App keys permission is NOT automatically included in the cloned Datadog Read Only Role and must be manually added. This is required so the Hypersync can query metadata for the App Key associated with the service account.
|
|
|
|
|
|
|
|
|
|
Step Two: Create a service account
From the left menu, navigate to Identity & Accounts > Service Accounts.
Click New Service Account.
Enter a name, i.e., Hyperproof/Hypersync Account, and a company email.
From the Assign Roles drop-down menu, select Hyperproof/Hypersync Role.
Click Create Service Account.
Step Three: Create the App Key
Select your newly created service account.
In the right pane, click New Key.
Enter a name, i.e., Hyperproof/Hypersync App Key.
Click Create Key. The App Key has the permissions of the user who created it.
Copy your newly created Application Key using the Copy button.
Note: Do not skip this step!
Store your key securely, and then click Finish.
Note: Ensure that your Application Key is Not Scoped. Application Key permissions are inherited directly from the originating service account.
Step Four: Create the API Key
A Datadog administrator can create new API Keys.
From the left menu, navigate to Access > API Keys.
Click New Key.
Enter a name, i.e., Hyperproof/Hypersync API Key.
Click Create Key.
Copy your newly created API Key using the Copy button.
Note: Do not skip this step!
Store your key securely, and then click Finish.