WatchGuard provides network and endpoint security, secure-WIFI, multi-factor authentication, and network intelligence products and services.
First, get your WatchGuard API Key
Log in to your WatchGuard Cloud account
Select "Administration" and then "Managed Access"
Click "Enable API Access".
Specify the "readwrite" and "readonly" passwords to use as your API access credentials, then check the check box and click "Save"
Once enabled, you will see the following information. Take note of
"Access ID (Read-write)
"Authentication API URL"
"API Key"
Lastly, Create WatchGuard credentials in Tines
HTTP request type to obtain access token
Login to your Tines tenant
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 WatchGuard credential
Name: Required
Description: Optional
URL: The "Authentication API URL, i.e.
https://api.usa.cloud.watchguard.com/oauth/token
.Depending on your WatchGuard Cloud account data storage region, this may different.
Content Type: Form
Method: post
Payload:
{"grant_type": "client_credentials", "scope": "api-access"}
Headers:
{"accept": "application/json"}
{"Authorization": "Basic dXNlcm5hbWU6N3loVHI1RHNkLWg2YTktODVnZS1nNjc4OTNoNmUwdGQ"}
read-write access ID:read-write password encoded into base64
Click "Run options" and double click on the key named
access_token
in the response.Location of token from response: Paste the value copied in the previous step.
Optional
Domains: Ensure this credential can only be used when making HTTP requests to specific domains
Access: What other teams can also use the API
Text type for API Key
Login to your Tines tenant
Navigate to the team that will be using the API and click "Credential"
Click "+ New Credential" and select "Text"
Input the values for the WatchGuard credential
Name: Required
Description: Optional
Value: "API Key"
Optional
Domains: Ensure this credential can only be used when making HTTP requests to specific domains
Access: What other teams can also use the API
For more on creating credentials in Tines, click here.
Using the credential in an action
When you make an API request, include the HTTP request type credential in the Authorization
header after "Bearer" like:
Bearer <<CREDENTIAL.watchguard_token>>
and the text type credential in the WatchGuard-API-Key
header like:
<<CREDENTIAL.watchguard_api_key>>
An example action you can copy and paste onto your storyboard:
{"standardLibVersion":"29","actionRuntimeVersion":"4","agents":[{"disabled":false,"name":"Get account information","description":"Created from cURL command","options":"{\"url\":\"https://api.usa.cloud.watchguard.com/rest/platform/accounts/v1/accounts/<<account_id>>\",\"method\":\"get\",\"payload\":{\"fields\":\"contacts,addresses\"},\"headers\":{\"Authorization\":\"Bearer <<CREDENTIAL.watchguard_token>>\",\"Content-Type\":\"application/json\",\"WatchGuard-API-Key\":\"<<CREDENTIAL.watchguard_api_key>>\"}}","position":{"x":1065,"y":-810},"type":"httpRequest","timeSavedUnit":"minutes","timeSavedValue":0,"monitorAllEvents":false,"monitorFailures":false,"monitorNoEventsEmitted":null,"recordType":null,"recordWriters":[],"form":null,"cardIconName":null,"createdFromTemplateGuid":null,"createdFromTemplateVersion":null}],"links":[],"diagramNotes":[]}