Integrating OneLogin with BetterCloud

Follow

Contents

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.

Getting Started

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.

OneLogin-1.png

Scroll down to the card for OneLogin.

OneLogin-IC.png

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." 

OneLogin-3.png

The first step in the installation process is naming your integration. This name will be used to identify your OneLogin integration throughout the app.

OneLogin-4.png

The next screen asks for three pieces of data that allow BetterCloud to properly authenticate on behalf of your domain.

OneLogin-8.png

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.”

OneLogin-1.png

Create a new credential.

OneLogin-2.png

Name your new credential so you can identify it later. We require Manage All permissions in order to successfully authenticate.

OneLogin-3-1.png

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.

OneLogin-4.png

OneLogin Region

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.

Finish

Once you have all the required information, enter it into the fields. Clicking "Finish" will complete the installation with the provided credentials.

OneLogin-6.png

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!

OneLogin-7.png

You will now be able to utilize all of the OneLogin integration's functionality. Read more on OneLogin events, conditions, and actions in workflows, or get started with building your own 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 be 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. 

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request