(Example) How to Get the Access Token Credentials from Dropbox

To get the access token credentials from Dropbox, do the procedure in this topic.

Prerequisites

OAuth 2.0 access tokens require a 2-way exchange of credentials between AgilePoint NX and the external service. This means that you must get the credentials from the third-party service to paste in the AgilePoint NX access token, and get the redirect URI from AgilePoint NX to paste in the external service. This requires you to open both the AgilePoint NX access token and the third-party service at the same time, so you can copy and paste from one screen to the other.
This topic shows the suggested procedure for Dropbox. The exact procedure for your access token depends on whether you already have a connection (usually called an app) configured in the external service.
This topic gives one example. The procedure may vary depending on your configuration and account settings in the third-party service.
Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation. It is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business use cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, or other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

First, create a new access token in AgilePoint NX for Dropbox.

There is more than one way to create an access token.
For more information, refer to Access Token for Dropbox.

In AgilePoint NX, open the access token configuration screen for Dropbox.

Do not configure the access token credentials.

Keep the access token configuration screen open in AgilePoint NX, but do not save it.

Next, create an app in Dropbox.

In a new web browser tab, sign in to your Dropbox account:
- https://www.dropbox.com/developers.

On the My apps section, click Create App.
On the Choose an API section, select Dropbox API.
If you have a Dropbox Business account, select Dropbox Business API.
On the Choose the type of access you need section, select Full Dropbox.
If you want to give access to a specific folder within your app, select App folder.
On the Name your app section, in the text box, enter an app name.
AgilePoint recommends you use an app name associated with your AgilePoint NX app or the way you want to use the app in AgilePoint NX.
Click Create app.

The Dropbox opens the new app.

Next, copy the Dropbox app credentials to your AgilePoint NX access token.

In one web browser tab, on the My apps screen, open the app you created in Dropbox.
For more information, refer to Create an App in DropBox.
In a different web browser tab, in AgilePoint NX, open the Dropbox access token configuration screen.

In Dropbox, on the Settings tab, in the App key section, copy the App key value.
In AgilePoint NX, on the Dropbox Access Token Configuration screen, in the App Key field, paste the App key value from Dropbox.
In Dropbox, to show the app secret, on the Settings tab, in the App secret section, click Show.
Copy the App secret value.
In AgilePoint NX, on the Dropbox Access Token Configuration screen, in the App Secret field, paste the App secret value from Dropbox.

Next, configure the Redirect URI in the Dropbox app that connects your AgilePoint NX app.

In one web browser tab, in AgilePoint NX, open the Dropbox access token configuration screen.
In a different web browser tab, open the Dropbox app configuration screen.
For more information, refer to Copy the Dropbox App Credentials.

In AgilePoint NX, on the Dropbox Access Token Configuration screen, in the Redirect URI field, copy the value.
This is an example value. In a production environment, copy the actual Redirect URI from AgilePoint NX.
In Dropbox, on the Settings tab, in the Redirect URIs field, paste the Redirect URI value from AgilePoint NX.
Click Add.

Next, complete the AgilePoint NX access token configuration for Dropbox.

In AgilePoint NX, on the Dropbox Access Token Configuration screen, in the Token Name field, enter a name for the access token.
Click Get OAuth2 Access Token.

A new tab or window opens in your web browser.
On the new tab, in the Before you connect this app screen, click Continue.
On the Dropbox screen, click Allow.

The new tab or window closes in your web browser, and the Dropbox access token screen shows the OAuth 2.0 access token in the OAuth 2.0 Access Token field.
Click Done.