A cloud infrastructure agent that can automate the creation and management of servers (Droplets), configure networking, and manage storage volumes.

​
Connect DigitalOcean to Auth0

1

DigitalOcean setup

  1. Sign up for a DigitalOcean account if you don’t already have one.
  2. Visit the OAuth Applications page in your DigitalOcean control panel.
  3. Click Register OAuth Application to create a new OAuth application.
  4. Fill in the application details:
    • Name: Enter a descriptive name for your integration
    • Homepage URL: https://YOUR_AUTH0_DOMAIN
    • Application description: Brief description of your application
    • Callback URL: https://YOUR_AUTH0_DOMAIN/login/callback
    You can find the Auth0 domain in the Auth0 Dashboard.You can find this under Applications > [Your Application] > Settings > Basic Information > Domain.If you are using the custom domains feature, your Auth0 domain is the custom domain. You can find this under Branding > Custom Domains.
  5. Click Register OAuth Application and note your Client ID and Client Secret.
To learn more about DigitalOcean OAuth setup, read the DigitalOcean OAuth API documentation.
2

Auth0 setup

  1. In the Auth0 Dashboard, go to Authentication > Social.
  2. Select Create Connection, then choose DigitalOcean.
  3. Click Continue.
  4. In General:
    1. Enter the Client ID and Client Secret from your DigitalOcean OAuth app.
    2. Under Scopes, select the scope(s) required for your application. These determine what permissions your application can request from DigitalOcean, whether for authentication (such as accessing basic profile details) or for API access (such as connecting to the provider's APIs).
    3. Add any additional scopes your application requires in the Additional Scopes field.
  5. In Advanced, Enable Token Vault. This lets the connection retrieve and securely store access tokens for third‑party APIs. Learn more in Configure Token Vault.
  6. Click Create.
  7. After creation, you are redirected to the Applications page. Select the application(s) to enable this connection for.
    Note: In a new Auth0 tenant, you can select the Default App.
  8. Once you have created your DigitalOcean social connection, test your connection to ensure the setup is working correctly before using it in your application.
This guide walks you through setting up the DigitalOcean connection in Auth0. For an end-to-end example that shows how to set up your app to call third-party APIs on the user's behalf using a connection like this, read the Call Other's APIs on User's Behalf Quickstart.

​
Token Vault configuration example

To configure the Token Vault for your DigitalOcean connection, you can use the following code snippet in your application: 
const auth0AI = new Auth0AI();

export const withDigitalOceanConnection = auth0AI.withTokenForConnection({
  connection: "digitalocean",
  scopes: ["account:read", "droplet:create", "kubernetes:read", ...],
  refreshToken: getAuth0RefreshToken(),
});

​
Next steps