Tines

Ensure your user account has the appropriate privileges set for the type of task you need to perform (See <a href="https://docs.extrahop.com/9.3/rest-api-guide/#privilege-levels" target="_blank" rel="nofollow noopener noreferrer">ExtraHop privilege levels</a>)

1. Ensure your user account has the appropriate privileges set for the type of task you need to perform (See <a href="https://docs.extrahop.com/9.3/rest-api-guide/#privilege-levels" target="_blank" rel="nofollow noopener noreferrer">ExtraHop privilege levels</a>)

Next, create resource and credentials in Tines

One resource and two credentials will need to be created:

- Resource: "extrahop_username"
- Text type credential: "extrahop_secret"
- HTTP request type credential: "ExtraHop"

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

Input the values for the ExtraHop resource

1. Name: extrahop_username
2. Description: Optional
3. Builder: your extrahop username

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

1. Navigate to the team that will be using the API and click "Resource"
2. Click "+ New Resource"
3. Input the values for the ExtraHop resource
 1. Name: extrahop_username
 2. Description: Optional
 3. Builder: your extrahop username
4. Optional
 1. Access: What other teams can also use the resource
5. Click "Save resource"

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

Click "+ New Credential" and select "Text"

Input the values for the ExtraHop credential

1. Name: extrahop_secret
2. Description: Optional
3. Value: your secret

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. Login to your Tines tenant
2. Navigate to the team that will be using the API and click "Credential"
3. Click "+ New Credential" and select "Text"
4. Input the values for the ExtraHop credential
 1. Name: extrahop_secret
 2. Description: Optional
 3. Value: your secret
5. 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
6. Click "Save"

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

1. Name: ExtraHop
2. Description: Optional
3. URL: <code>https://&lt;your_ExtraHop_domain&gt;.api.cloud.extrahop.com/oauth2/token</code>
4. Content Type: Form
5. Method: post
6. Payload: Copy the below object and paste into the "Plain code" section: 
 { "grant_type": "client_credentials" }
 
7. Headers: 
 1. Header: Authorization
 2. Value: Basic &lt;&lt;BASE64_ENCODE(LOCAL.creds)&gt;&gt;
8. Local values: Click the "+ Option" button, select "Local values" and paste the below into the "Plain code" section: 
 { "creds": "&lt;&lt;RESOURCE.extrahop_username&gt;&gt;:&lt;&lt;CREDENTIAL.extrahop_secret&gt;&gt;" }
 
9. Click "Run options" and make sure you get a successful response.
10. Location of token from response: <code>&lt;&lt;extrahop.body.access_token&gt;&gt;</code>

1. Click "+ New Credential" and select "HTTP Request"
2. Input the values for the ExtraHop credential
 1. Name: ExtraHop
 2. Description: Optional
 3. URL: <code>https://&lt;your_ExtraHop_domain&gt;.api.cloud.extrahop.com/oauth2/token</code>
 4. Content Type: Form
 5. Method: post
 6. Payload: Copy the below object and paste into the "Plain code" section: 
 { "grant_type": "client_credentials" }
 
 7. Headers: 
 1. Header: Authorization
 2. Value: Basic &lt;&lt;BASE64_ENCODE(LOCAL.creds)&gt;&gt;
 8. Local values: Click the "+ Option" button, select "Local values" and paste the below into the "Plain code" section: 
 { "creds": "&lt;&lt;RESOURCE.extrahop_username&gt;&gt;:&lt;&lt;CREDENTIAL.extrahop_secret&gt;&gt;" }
 
 9. Click "Run options" and make sure you get a successful response.
 10. Location of token from response: <code>&lt;&lt;extrahop.body.access_token&gt;&gt;</code>
3. 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
4. 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 ExtraHop stories in the <a href="https://www.tines.com/story-library?s=extrahop" target="_blank" rel="nofollow noopener noreferrer">story library</a>.

Using the credential and resources in an action

The Header configuration for your ExtraHop credential should be:

"Authorization": "Bearer &lt;&lt;CREDENTIAL.extrahop&gt;&gt;"

Here is an example ExtraHop action you can copy and paste onto your storyboard in Tines:

First, configure account in ExtraHop

Next, create resource and credentials in Tines

Resource

Text type

HTTP request type

Using the credential and resources in an action