When To Create a Custom OAuth Application

CData embeds OAuth Application credentials with CData branding that can be used when connecting via a desktop application or headless application.

You may choose to use your own OAuth Application credentials when you want to

• control branding of the Authentication Dialog
• control the redirect URI that the application redirects the user to after the user authenticates
• customize the permissions that you are requesting from the user

Creating an OAuth App

Perform the following steps to generate an OAuth app and its associated credentials:

1. Log in to your user account.
2. Navigate to the OAuth app creation page.
3. Click Register an OAuth integration.
4. Give the OAuth application a descriptive name.
5. Specify a callback URL, which can be any localhost URL (such as http://localhost:33333), in the OAuth redirect URL field.
6. Under Scopes, specify the following scopes:
   • data.records:read
   • data.records:write
   • schema.bases:read
7. Under Developer details, you can optionally specify a Client secret. While not required, generating a client secret can enhance security.
8. Copy and save the Client ID and, if generated, the Client secret from the Developer details section. You will use these later in the OAuthClientId and OAuthClientSecret connection properties.
9. Click Save changes.