Authorizing the Coveo Connector to Access Your Basecamp Content
The OAuth 2.0 protocol is a protocol used for granting access to external applications without exposing the user's real credentials. For the connector to be able to connect to the content of your managed users, it must acquire a client ID, a client secret and a refresh token.
To authorize the Coveo connector to access your Basecamp content
Note: This topic describes a procedure using Google Chrome and the Advanced Rest Client extension. However, it can be done with other browsers and extensions, such as Firefox and the RESTClient plugin.
-
Create an application using an Basecamp administrator account:
-
Access Your Applications page.
-
Log into your Basecamp account with an administrator account.
-
In the Your Applications page, click Register one now.
-
In the New application page:
-
In the About Your application section:
-
In the first box, enter the Name of your application.
Example: Coveo Connector
-
In the second box, enter Your company's name.
-
In the third box, enter Your website URL.
-
-
In the Integration section, select the Basecamp check box.
-
In the OAuth 2 authorization section, in the Redirect URI, enter https://127.0.0.1.
-
Click Register this app.
-
-
Back in the Your Applications page:
-
Take note of the following values:
-
Client ID
-
Client Secret
You need this value when configuring the Basecamp source (see Configuring and Indexing a Basecamp Source).
-
-
Click Preview authorization dialog.
-
-
In the Integrate with [Your App Name] page, click Yes, I'll allow access to receive an authorization code from Basecamp.
-
In your browser address bar, take note of the authorization code returned by the Basecamp API.
Important: An authorization code can only be used once before it expires.
Example: https://127.0.0.1/?code=[AUTHORIZATION_CODE]
-
Make an API call for an access token and an refresh token:
-
Access the Advanced REST client Google Chrome extension page, and then click the + Free button.
Note: You are asked to download Google Chrome if you did not have the browser installed on your computer already.
-
In the Confirm New App dialog box, click Add.
-
In the Apps page, open the Advanced REST client plugin.
-
In the Request tab:
-
In the URL box, enter https://launchpad.37signals.com/authorization/token.
-
In the method list, select the POST check box.
-
Next to Payload, select Form.
-
In the box under Payload, enter the following keys and values:
Keys Values type web_server code The authorization code you retrieved previously (see Authorization Code). client_id The client ID obtained from the application configuration (see Client ID). client_secret The client secret obtained from the application configuration (see Client Secret). redirect_uri https://127.0.0.1 -
Click Send to receive an answer.
-
-
At the bottom of the page, in the Response box, take note of the refresh token value. You need this value when configuring your Basecamp source (see Configuring and Indexing a Basecamp Source).
-
-
What's Next?
Create a Basecamp source (Configuring and Indexing a Basecamp Source).