When to Create a Custom OAuth App

CData embeds OAuth Application Credentials with CData branding that can be used when connecting via either a Desktop Application or from a Headless Machine. Creating a custom OAuth application is, however, required when using a web application.

You may choose to create 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

Follow the steps below to create a custom OAuth app and obtain the connection properties in a specific OAuth authentication flow.

Create a Custom OAuth App

Register your Basecamp app on integrate.37signals.com to obtain the following connection properties:

• OAuthClientId
• OAuthClientSecret
• CallbackURL (desktop only)

The only difference between desktop applications, web applications, and headless machines is what you set the Redirect URI to:

• Desktop Applications: Set the Redirect URI to http://localhost:portnumber and set CallbackURL to match. You can specify any port available.
• Web Applications: Set the Redirect URI to a page on your website. This page is what users return to after granting permissions to the application.
• Headless Machines: Set the Redirect URI to http://localhost:portnumber. You can specify any port available.