When integrating a new application with your BetterCloud instance, the overall installation process is consistent. However, each integration is different, and may require varying levels and types of authentication. This article provides instructions for configuring and collecting all the information you need in order to add the Deputy integration in BetterCloud.
BetterCloud requires the following authentication type when integrating with Deputy:
- API Token
You will also need to enter the following additional environment variable in order to successfully connect:
*Please Note: Only users with a System Administrator access level can carry out the necessary steps to add the Deputy integration.
In order to provide BetterCloud with access to your Deputy instance, you will need to create a permanent access token. To reach the OAuth Client page, add the following text to the end of your URL: “/exec/devapp/oauth_clients” as in the example below.
Create a new OAuth Client.
You will be asked to provide a name and a Redirect Uri. Provide a name you will be able to reference later. The Redirect Uri can be set to anything for our purposes - Deputy does not use what you enter when using a permanent access token, only when authenticating through OAuth 2.0.
Once your OAuth Client is created, you will be able to create an access token by clicking “Get An Access Token.”
Your access token will be revealed. Copy this into the API Token field when adding the integration in BetterCloud.
Your domain name in Deputy is unique to your instance, and will determine where we direct API calls that come from BetterCloud. To find this URL, navigate to “My Account” from the dropdown in the top right corner of the page.
Click on “Settings” under the appropriate business.
You will see the “Unique URL” under the business name. Copy the URL. In the example below, this does not include the part of the URL that reads “na.deputy.com.”
This information is also available in your browser’s URL when accessing the business in Deputy.
Once you have successfully added the integration, your Environment URL and API Token can be updated at any time from the integration’s settings.