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 Asana integration in BetterCloud.
BetterCloud requires the following authentication type when integrating with Asana:
- API Token
You will also need to enter the following additional environment variable in order to successfully connect:
When adding the Asana integration you must enter a valid API token. To generate an API token, please take the following steps within Asana:
Select your profile from the top right corner of the page, and navigate to “My Profile Settings.”
Select the Apps tab.
Click Manage Developer Apps.
Find the “New access token” option.
Name and create your token.
On the next page you will be presented with your API token. Be sure to copy it here, since you will not be able to access it again.
When entering your Asana API token in BetterCloud, be sure to prepend the required "Bearer" prefix:
Your workspace GID is the unique ID associated with the Asana workspace you are going to be integrating with BetterCloud, and must be entered as the environment variable called asanaWorkspaceGid. There are a few ways to retrieve your ID, but the following method is the most reliable. It will consist of making a simple get call in the Asana API explorer to retrieve the workspace ID.
To start, navigate to the Asana developer portal. From here you will need to head to the “Explorer” tab, and authorize the API explorer.
Once you’ve granted permissions you are ready to run your call. Leaving the rest of the information on the page as-is, scroll down to the attribute parameters. Verify that the correct workspace is selected, and click “Submit."
The response will reveal the “gid” for the workspace. Copy this value.
Once you have successfully added the integration, your workspace GID will be available as an encrypted environment variable in your integration and can be updated at any time. Your API token can also be updated from the basic information section.