Tines

Digital Guardian is an American data loss prevention software company that offers products to detect and prevent malicious actions by users and malware on endpoints. Its software is designed for both individual users and corporate networks, servers, databases, and the cloud.

You will need to have the following (found in your DGMC environment by navigating "System" -&gt; "Configuration" -&gt; "Cloud Services" from the DGMC menu. 

- Access Gateway Base URL
- Authorization Server URL
- API Access ID
- API Access Secret

Lastly, create a Digital Guardian resource and credential in Tines

One HTTP request type credential: "Digital Guardian" 

- One resource: "Digital Guardian URL"
- One HTTP request type credential: "Digital Guardian" 

Navigate to the team that will be using the API and click "Resource"

Input the values for the Digital Guardian resource

1. Name: Digital Guardian URL
2. Description: Optional
3. Builder: Your "Access Gateway Base URL"

1. Access: What other teams can also use the resource

1. Login to your Tines tenant
2. Navigate to the team that will be using the API and click "Resource"
3. Click "+ New Resource"
4. Input the values for the Digital Guardian resource
 1. Name: Digital Guardian URL
 2. Description: Optional
 3. Builder: Your "Access Gateway Base URL"
5. Optional
 1. Access: What other teams can also use the resource
6. Click "Save resource"

Navigate to the team that will be using the API and click "Credential"

Click "+ New Credential" and select "HTTP Request"

Input the values for the Digital Guardian credential

1. Name: Digital Guardian
2. Description: Optional
3. URL: Your "Authorization Server URL, i.e. <code>https://authsrv.msp.digitalguardian.com/as/token.oauth2</code>.
4. Content Type: Form
5. Method: post
6. Payload: Replace <code>&lt;&lt;api_access_id&gt;&gt;</code> with your "API Access ID" ​ ​
 { "client_id": "&lt;&lt;api_access_id&gt;&gt;," "client_secret": "&lt;&lt;secret&gt;&gt;", "grant_type": "client_credentials", "scope": "client" }
 
7. Secret: Your "API Access Secret"
8. Click "Save"

Click "Run request" and double-click on the <code>access_token</code> key to copy the path.

Location of token from response: Paste the path to the token in the value pill, <code>digital_guardian.body.access_token</code>

1. Domains: Ensure this credential can only be used when making HTTP requests to specific domains
2. Access: What other teams can also use the API

1. Navigate to the team that will be using the API and click "Credential"
2. Click "+ New Credential" and select "HTTP Request"
3. Input the values for the Digital Guardian credential
 1. Name: Digital Guardian
 2. Description: Optional
 3. URL: Your "Authorization Server URL, i.e. <code>https://authsrv.msp.digitalguardian.com/as/token.oauth2</code>.
 4. Content Type: Form
 5. Method: post
 6. Payload: Replace <code>&lt;&lt;api_access_id&gt;&gt;</code> with your "API Access ID" ​ ​
 { "client_id": "&lt;&lt;api_access_id&gt;&gt;," "client_secret": "&lt;&lt;secret&gt;&gt;", "grant_type": "client_credentials", "scope": "client" }
 
 7. Secret: Your "API Access Secret"
 8. Click "Save"
4. Click "Run request" and double-click on the <code>access_token</code> key to copy the path.
5. Location of token from response: Paste the path to the token in the value pill, <code>digital_guardian.body.access_token</code>
6. Optional
 1. Domains: Ensure this credential can only be used when making HTTP requests to specific domains
 2. Access: What other teams can also use the API
7. Click "Save"

Your credential should look like the following:

For more on creating credentials in Tines, click <a href="https://explained.tines.com/en/articles/6877578-what-are-credentials-in-tines">here</a>.

You can find a selection of Digital Guardian stories in the <a href="https://www.tines.com/story-library?s=digital+guardian" rel="nofollow noopener noreferrer" target="_blank">story library</a>.

First, get Digital Guardian credentials

Lastly, create a Digital Guardian resource and credential in Tines

Resource

HTTP request type