BetterCloud's Integration Center allows you to pair other third-party apps with your BetterCloud instance, supporting integration and automation across multiple platforms used by your organization in a single interface.
When adding a new integration to your BetterCloud instance, there are several general steps in BetterCloud that provide a consistent experience. However, each integration is different, occasionally requiring differing levels of access and approval, or reciprocal steps on the integration's end.
We recommend using a OneLogin service account when installing this integration. This will prevent an interruption in service in the case that an installing user loses the necessary permissions to authenticate in the future. This account must be a OneLogin super user or account owner.
Any level of OneLogin subscription will allow you to connect OneLogin to BetterCloud.
*Please Note: If you have added the previous version of the OneLogin integration that contained actions but not alerts and assets, you will need to accept an update in order for BetterCloud to enable the full scope of the integration's functionality. You will see the integration's card marked with an "Upgrade Required" dialog in the "Installed" tab of the Integration Center. Click on the card, and then click "Update", which will walk you through a similar process to the one found below.
To begin the process of installing OneLogin, navigate to the Integration Center from the left navigation menu, and make sure you are in the "Discover" tab.
Scroll down to the card for OneLogin.
The following screen gives an overview of the available actions, alerts, and assets included with the integration. Take a moment to explore the use cases and automations you will be able to add after integrating OneLogin with your BetterCloud instance. When you are ready to begin the installation, click "Install."
The first step in the installation process is naming your integration. This name will be used to identify your OneLogin integration throughout the app.
The next screen asks for three pieces of data that allow BetterCloud to properly authenticate on behalf of your domain.
Continue reading for instructions on creating and locating these credentials within OneLogin.
OneLogin Client ID and Client Secret
The client ID and client secret are unique keys that give BetterCloud access to take action in your OneLogin instance. In order to generate these keys you must have super user privileges in OneLogin.
To start, log in to OneLogin and navigate to “Administration” > “Developers” > “API Credentials.”
Create a new credential.
Name your new credential so you can identify it later. We require Manage All permissions in order to successfully authenticate.
Once you’ve created the credential, your Client Secret and Client ID will be revealed. Copy these values. OneLogin allows you to view and copy these at any time.
Your OneLogin region determines the first part of the URL we will use to make API calls on behalf of your domain, and is also referred to as a base URL. Base URL for OneLogin is determined by region. Please select your region from the dropdown.
Once you have all the required information, enter it into the fields. Clicking "Finish" will complete the installation with the provided credentials.
Congratulations! You reached the final step with adding your OneLogin integration.
Now that you’ve successfully added your OneLogin integration to your BetterCloud instance, you can get started right away by using the Alerts button to begin adding alerts to your domain, and set up Workflows for automation.
Clicking on the blue “Visit Alerts” button will redirect you to the Alerts Manager page. And selecting the blue “Visit Workflows” button guides you straight to the Workflow Builder to get started on your very first OneLogin Workflow!
Removing a OneLogin Integration
To disconnect a OneLogin integration that is no longer needed in your BetterCloud instance, please see our steps for removing an integration.
Viewing and Managing Integrations
Once integrations have been added to your BetterCloud instance, they will appear in new ways throughout our app, and will be distinguished by name. Please see our "Viewing, Managing, and Deleting Integrations" article for more information about how integrations will appear throughout BetterCloud.