--- title: "OneLogin" slug: "onelogin" updated: 2025-02-19T14:06:04Z published: 2025-02-19T14:06:04Z canonical: "docs.databee.buzz/onelogin" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt > Use this file to discover all available pages before exploring further. # OneLogin OneLogin is an identity and access management (IAM) platform that offers single sign-on (SSO), multi-factor authentication (MFA), user provisioning, and directory integration. It helps organizations securely manage user access to applications and data. More information can be found at [Onelogin website](https://www.onelogin.com/). **Integration Method:** API **Tables:** Account Change (3001), Application lifecycle (6002), Authentication (3002), User Access Management (3005), User Inventory Info (5003). List of events supported by this integration. | **Events** | **Description** | | --- | --- | | Events | Retrieve a list of events. | | Apps | Retrieve a list of applications. | | Users | Retrieve a list of users along with their role details, manager details, and manager's role details. | | User Apps | Retrieve a list of user applications along with user details. | | User MFA Devices | Retrieve a list of user devices along with user details. | This integration supports the following versions | Onelogin API version | v1.0 & v2.0 | | --- | --- | This integration has been tested with OneLogin APIs, using version **v1.0 for Events** and version **v2.0 for Apps, Users, User Apps, and User MFA Devices**. # Prerequisites - User should have access to the OneLogin Administration Portal using the user account credentials having **Super User** privileges. - User should have access to the DataBee console. # Configuration Overview 1. Generate API credentials on the OneLogin console with the required scopes 2. Create [Onelogin Data Feed](/docs/onelogin#_DataBee_Configuration) in the DataBee console with the required Client credentials. | **DataBee Feed Parameter** | **Onelogin Parameter** | | --- | --- | | Client Key | [Client ID](/docs/onelogin#onelogin_creds) | | Client Secret | [Client Secret](/docs/onelogin#onelogin_creds) | | Token URL: | [Onelogin Instance](/docs/onelogin#onelogin_instance) | | API Base URL: | [Onelogin Instance](/docs/onelogin#onelogin_instance) | # OneLogin Configuration 1. Log on to **OneLogin Administration Portal** using the user account credentials with **Super User** privileges. 2. Get the Onelogin **instance** from the URL as highlighted below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-uywv0m5h.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) 1. Navigate to **Developers > API Credentials.** The **API Access** page window will appear. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-irbyt3a5.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) 1. On **API Access** page, click on the **New Credentials** button. The **Create new API credential** form will pop up. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-ni2lnyob.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) 1. On **Create new API credential** form: 1. Enter an appropriate **name** for the API credentials. 2. Select **Read all** option. Click on the **Save** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-nr1px7sg.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) 1. Once it is successfully saved, you will see the **Client ID** and **Client Secret** credentials in the popup. 1. **Copy** these credentials for later use. 2. Click on the **Done** button to complete credentials creation process ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-h0fru8wp.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) # DataBee Configuration 1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-a7iucg16.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) 1. Search for the **OneLogin** and select it. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-7n3n3cb3.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) 1. Click on the **API Ingest.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-xp7ldm2a.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) 1. Enter basic contact information in the contact form and click on the **Next** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-1jybjqar.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) 1. In the configuration dialog, enter the following: - **API Base URL:** Replace the placeholder with your [Onelogin instance](/docs/onelogin#Bookmark1) - **Client Key:** Paste the [Client ID](/docs/onelogin#Bookmark2) generated previously - **Client Secret:** Paste the [Client Secret](/docs/onelogin#Bookmark2) generated previously - **Token URL**: Replace the placeholder with your [Onelogin instance](/docs/onelogin#Bookmark1) - Select the **event types.** It is prepopulated with all supported event types. 2. Click **Submit** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/onelogin-feb-2025-image-4vp964f7.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A30%3A35Z&se=2026-10-30T12%3A30%3A35Z&sr=c&sp=r&sig=CajjIaJPuFTHufugTzzhgJZxkr5hWPxvLEqPomkI85o%3D) # Troubleshooting Tips - **Verify Client Credentials and Instance** Ensure the client key, client secret, and instance URL are correctly pasted. Since the client key and secret are only visible at the time of creation, recreate them if needed. Copy the newly generated credentials to a text editor to check for extra spaces or unexpected characters. Once verified, reconfigure the DataBee feed with the correct credentials. - **Verify OneLogin Scope** Check that the OneLogin API credentials have the necessary scope. If needed, update the API credentials' scope in the OneLogin Console, save the changes, and retry the integration. #