Dropbox signs users in with their Dropbox account. It suits products that also read or write files there, where one authorization covers both sign-in and access.
Copy the redirect URI
In the Authdog console, select the project and environment, open Authentication > Providers, find Dropbox, and click Enable. Copy the redirect URI shown in the form:
https://identity.authdog.com/api/v1/callback/<connectionId>Create the application
- Open the Dropbox App Console and select Create app.
- Choose Scoped access, then an access type — App folder is enough for sign-in.
- Name the app and create it.
- On the Settings tab, add the redirect URI from Authdog under OAuth 2 Redirect URIs.
- On the Permissions tab, enable
account_info.readand submit. - Copy the App key and App secret from Settings.
Configure Authdog
| Field | Value |
|---|---|
| Client ID | The Dropbox App key |
| Client Secret | The Dropbox App secret |
Save, then toggle the connection active.
What Dropbox returns
Authdog requests the account_info.read scope and reads the profile from https://api.dropboxapi.com/2/users/get_current_account.
The account endpoint returns the account ID, display name, email and its verified flag, and the account type.
Dropbox apps start in Development mode, capped at a small number of linked accounts. Apply for production status before opening sign-in to the public.
Test it
- Open your environment's hosted sign-in page, or link to
https://identity.authdog.com/api/v1/signin/<connectionId>. - Select the Dropbox button and complete the flow.
- Confirm the user appears under Users in the console with a Dropbox identity linked.
Troubleshooting
| Symptom | Cause |
|---|---|
missing_scope |
The permission was enabled after the app was authorized — reauthorize |
| Development-mode cap reached | The app needs production approval from Dropbox |
| Redirect or callback URL error | The URI registered with the provider does not match Authdog's exactly |
| Works in one environment only | Each environment has its own connectionId, and so its own redirect URI to register |
Related
| Read | To learn how to |
|---|---|
| Connectors | Set up any other social provider |