Use DropBox Application Authentication with DropBox Online
This article will help a user configure the Cyturus Application Suite to utilize DropBox Application Authentication to authenticate with a DropBox Online user account
This initial configuration is a one-time setup for those customers who wish to use the DropBox repository with the Cyturus Application Suite. This setup is necessary to open the communication channel between DropBox and Cyturus.
There are a couple of steps here. First the one-time setup piece needs to be completed, and then the repository configuration needs to occur.
Much of the following was derived from official DropBox documentation, and clarified for use with the Cyturus application. The original document information can be found here:
https://www.dropbox.com/developers/reference/getting-started#app%20console
Creating the DropBox App
- Navigate to the following: https://www.dropbox.com/developers/
- Log in with your DropBox credentials:

- Once logged in, click on the Create App button.

- Once you've clicked the Create App button, it will ask for three items to the process started:
- The first item it will ask is Choose an API. Select Scoped Access if not already selected.
- The second item it will ask is Choose the type of access you need. Select App Folder Type.
- The last item it will ask for is to Name your app. it will offer three options of app types to create. You can name your app whatever is rememberable.

- Click the Create app button to continue.
- On the next screen, on the Settings tab, find the OAuth 2 > Redirect URIs section. In the Redirect URI field you will enter the base URL of your PBC application and append the action method (/DropBox/AuthCallBackAsync) as shown in the example: https://example.crtportal.com/DropBox/AuthCallBackAsync.

- Finally, on the same Configuration tab, you will see an area called OAuth 2.0 Credentials. You will need the Client ID and Client Secret values to enter into the Cyturus application configuration in the following steps.

Configuring the DropBox Connector App in Cyturus
This step involves taking the Client ID and Client Secret from the previous section, and entering them into the application configuration section of Cyturus.
Please note: To perform this action you must have one of the following Product Security Roles (PSR):
- Instance Admin
- Organization Admin
- Client Admin
AND/OR have the following entitlements:
- Client Technical Admin
- Technical Admin
- First, log in to the Cyturus application with your credentials.
- Next, in the left hand menu, select Administration > Manage Clients. This will open the Application Settings area.

- Once within the Manage Clients area, choose the Client which you would like to configure and click the green pencil icon to edit that Client.

- Once in the Add/Edit Client screen, click the File Repository tab.

- Then, within the specific module tab you wish to configure, click the green pencil icon to Edit the DropBox repository connector.

- Next, you will use the Client ID and Client Secret from earlier steps to configure the application connector. The following fields are used and will need to be completed. Once all fields are completed click the Save button:
- Name - This can be whatever you choose to name this connector. Something that is memorable.
- Client ID - This will be the Client ID value from previous steps.
- Client Secret - This will be the Client Secret value from previous steps
- Redirect URL - This is the Redirect URI value from earlier steps.

- When the Save button is clicked you will be directed to the DropBox authorization page. This will ask you to sign in with the account you wish to utilize as the repository.