Creating a Custom OAuth Application

CData embeds OAuth Application Credentials with CData branding that can be used when connecting to Reckon Accounts Hosted via a desktop application or a headless machine. If you want to use the embedded OAuth application, all you need to do to connect is to:

• set AuthScheme to OAuth,
• get and set the OAuthAccessToken, and
• set the necessary configuration parameters.

(For information on getting and setting the OAuthAccessToken and other configuration parameters, see the Desktop Authentication section of "Connecting to Reckon Accounts Hosted".)

However, you must create a custom OAuth application to connect to Reckon Accounts Hosted via the Web. And since custom OAuth applications seamlessly support all three commonly-used auth flows, you might want to create custom OAuth applications (use your own OAuth Application Credentials) for those auth flows anyway.

Custom OAuth applications are useful if you want to:

• control branding of the authentication dialog;
• control the redirect URI that the application redirects the user to after the user authenticates; or
• customize the permissions that you are requesting from the user.

Procedure

To register a custom OAuth application and obtain the OAuthClientId and OAuthClientSecret:

1. Got to the ReckonAccountsHosted Developer Portal.
2. To create a developer account, click Sign Up.
   The Reckon Accounts Hosted Developer site displays a series of prompts that you can use to register a custom OAuth application.
3. Complete the registration. If this will be a web application, set CallbackURL to a trusted URL where users return after they authorize your application.
   Note the redirectURI for future use.
4. Submit the application form.
   The Reckon Accounts Hosted Developer site sends an email containing the Client ID and Client Secret to the user whose login was specified during application creation. The Client ID and Client Secret are used to configure the OAuthClientId and OAuthClientSecret properties.