![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 |
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 |
Alert Configurations | [Monitor] Name, Warning Threshold, Critical Threshold, Warning Recovery Threshold, Critical Recovery Threshold | 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:
📝 NoteThis permission is NOT automatically included in the cloned Datadog Read Only Role, and needs to be manually added. This is required so the Hypersync can query metadata from the App Key belonging to the service account.
|
|
|
|
|
|
|
|
|
|
Click Save.
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.