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 Pingboard integration in BetterCloud.
When adding this integration you must enter the following information:
*Please Note: Access to Pingboard’s API is only available on “Company” level plans or above.
Client ID and Client Secret
Only Company Admins can generate client IDs and secrets with necessary permissions to integrate with BetterCloud. Please take the following steps in order to enable and retrieve these pieces of information in Pingboard.
The Pingboard API will first need to be configured and enabled. You can locate the configuration by navigating to “Admin” > “Add-Ons” from the top menu.
The Pingboard API option is available in the “Browse” section.
Enable the API. Once you have enabled the API you will need to configure a service account. From the “Settings” tab in the Pingboard API add-on, select “Manage Service Accounts.”
Create a new service account. This account will be used to take action on behalf of your Pingboard instance.
Name your service account and give it a description (optional). You must enable the “Company Admin” toggle in order for the service account to have the appropriate level of access to integrate with BetterCloud.
Once you have created the service account, you will see further details about the account. This section, which can also be accessed from “Manage Service Accounts” page, contains your Client ID, as well as your Client Secret. Click “Show Secret” to reveal and copy your secret.
For calls to Pingboard’s API, the hostname is “app” (the full URL is https://app.pingboard.com/api/v2/). Please enter “app” in the pingboardHost field.
Once you have successfully added the integration, your Host, Client ID and Client Secret will be available as encrypted environment variables in your integration and can be updated at any time.