How to authenticate DigitalOcean for Site24x7 monitoring

To monitor your DigitalOcean resources with Site24x7, you need to provide valid credentials that allow Site24x7 to authenticate with your DigitalOcean account and discover your cloud resources.

Site24x7 supports two authentication methods. Choose the method that best fits your environment:

• Token-based authentication: Personal Access Token (PAT) for straightforward setups
• Site24x7 OAuth provider: OAuth-application-based access for environments that require a higher level of security

Prerequisites

• An active DigitalOcean account with Resource Viewer permissions to view team resources such as Droplets, Kubernetes clusters, Load Balancers, and Databases
• API access enabled on your DigitalOcean account
• Access to the DigitalOcean Control Panel or the Developer API portal
• A Site24x7 account with sufficient licenses to add cloud monitors

Method 1: Token-based authentication

Use a manually generated PAT if OAuth access is not suitable for your environment, for example, in straightforward or non-restricted setups.

Step 1: Sign in to the DigitalOcean console

1. Go to https://cloud.digitalocean.com/login.
2. Sign in with your DigitalOcean credentials.

Step 2: Navigate to API settings

1. In the left navigation panel, click API.
   
   
2. Under the Tokens section, select Generate New Token.

Step 3: Generate a PAT

1. Enter a name for the token, for example, site24x7-monitoring.
2. Under Permissions, select Read. For Site24x7 monitoring, read access is sufficient.
   
   
3. Click Generate Token.

Step 4: Add the DigitalOcean monitor in Site24x7

1. Log in to your Site24x7 account.
2. Navigate to Admin > Monitor > Add Monitor > DigitalOcean.
3. Verify that the following prerequisites are met for the PAT:
   • Read permission granted on the token.
   • The DigitalOcean account has Resource Viewer permissions.
   • API access is enabled.
   • Access to the DigitalOcean Control Panel or Developer API is confirmed.
4. Paste the token copied in step three into the Access Token field.
   
   

Once the credentials are saved, Site24x7 will authenticate with your DigitalOcean account, auto-discover the monitored resources, and begin collecting performance metrics shortly.

Method 2: Site24x7 OAuth provider

Use OAuth-application-based access for more secured environments, such as restricted enterprise setups. Site24x7 provides an OAuth provider option that lets you register a DigitalOcean OAuth application and use it for monitoring.

Step 1: Register the OAuth application in DigitalOcean

1. Sign in to DigitalOcean Cloud at https://cloud.digitalocean.com.
2. Open the API / OAuth section via Console > API > OAuth Applications, then click Register OAuth Application.
   
   
3. Fill in the registration form with the following details:
   • Name: Site24x7 - DigitalOcean Integration (example)
   • Homepage URL: https://www.site24x7.cn
   • Description: Site24x7 integration for DigitalOcean monitoring (example)
   • Callback / Redirect URL: https://www.site24x7.cn/app/OAuth2CallBack (this must match exactly with your OAuth provider)
4. Click Save. DigitalOcean will provide a Client ID and a Client Secret. Store the Client Secret in a secure secrets manager and do not commit it to source control.

Step 2: Add the OAuth provider in Site24x7

1. In the Site24x7 console, navigate to Admin > Configuration Profiles > OAuth Providers > Add OAuth Provider.
2. Set the Provider Name to DigitalOcean OAuth.
3. Set the OAuth Flow as Authorization Code.
4. In the Authorization Endpoint URL field, enter:
   https://cloud.digitalocean.com/v1/oauth/authorize
5. In the Token Endpoint URL field, enter: https://cloud.digitalocean.com/v1/oauth/token
6. Enter the Client ID and Client Secret generated in step one.
7. Ensure that the Redirect URI matches exactly what was registered in DigitalOcean: https://www.site24x7.eu/app/OAuth2CallBack
8. Leave the Query Parameters section empty. No additional parameters are required for DigitalOcean OAuth.
9. Under Authenticated Request Method, select Request header. Confirm the header format is: Authorization: Bearer ${access.token}
10. Keep the Refresh Interval at the default of 60 minutes unless a shorter refresh window is required.
11. Select the appropriate User Alert Groups to receive OAuth refresh failure notifications.
12. Click Authorize and complete the DigitalOcean consent screen to generate the initial access token.
13. Once authorization succeeds, click Check Configuration to validate token retrieval and refreshing.
    
    

Step 3: Add the DigitalOcean monitor in Site24x7

1. In the Site24x7 console, navigate to Admin > Monitor > Add Monitor > DigitalOcean.
2. Under Authentication, select the Site24x7 OAuth Provider configured in step two.
3. Select the Provider name drop-down. Site24x7 will list the DigitalOcean resources automatically once it has been added.
4. Authorize Site24x7 to access your DigitalOcean cloud resources and complete the monitor setup.
   
   

Once the OAuth provider is linked, Site24x7 will authenticate with your DigitalOcean account, auto-discover the monitored resources, and begin collecting performance metrics shortly.

Related articles

• DigitalOcean services monitored by Site24x7