# OneLogin integration overview

> Connect OneLogin to Persona with an API credential to fetch employee records in Workflows and match verified identity data against directory attributes.

Source: https://help.withpersona.com/articles/5XUEX40WhyDPCaOAuxemMH/
Section: Marketplace and 3rd-Party Integrations > Authentication > OneLogin

## OneLogin Integration Overview

## Overview

[OneLogin](https://www.onelogin.com/) is a cloud-based identity and access management (IAM) platform that provides secure, one-click access to enterprise applications. It simplifies user provisioning, strengthens security with multi-factor authentication, and centralizes access control. Persona’s integration with OneLogin enables workforce identity verification (IDV) directly within IAM workflows.

By connecting Persona as an identity verification provider, organizations can ensure that the individual authenticating through OneLogin is the same employee on record. This protects against account takeovers, insider threats, and compliance risks. This integration is particularly useful for companies that need to validate employee identity during sensitive account actions such as a password reset or when contacting the IT helpdesk.

## Benefits

**Stronger Workforce Authentication**: Verify that employees logging in through OneLogin match their records via Persona’s IDV checks.

**Automated Data Matching**: Compare user attributes from government-issued IDs (e.g., name, DOB, address) against employee records stored in OneLogin.

## Integration Features

Persona’s OneLogin integration supports enriching your Persona workflows with data from OneLogin. Key capabilities include:

- **User Retrieval**: List or fetch employee records from OneLogin and associated attributes.
- **Attribute Matching**: Automatically compare identity data from Persona verification against OneLogin directory attributes for stronger workforce authentication.

## Setting up the OneLogin Integration

### Prerequisites

To set up the OneLogin integration, ensure you have:

- Admin access to your OneLogin account
- A valid OneLogin API credential (Client ID and Client Secret)

### Setting up OneLogin Credentials

1.  In the Persona Dashboard, navigate to **Integrations > Marketplace** and select **OneLogin**.
2.  Click **Add Credential** at the top of the page.
3.  Enter a nickname for your credential in the modal and click **Continue**.
4.  Provide your OneLogin Client ID and Client Secret.
5.  Save the credential to enable the integration.

### Using the OneLogin Integration in a Workflow

1.  Create a new workflow, or open an existing workflow you’d like to update.
2.  Add a new **Action Step > Integrations**.
3.  Select the **OneLogin integration** and choose the desired endpoint (`List Users` or `Get User`).
4.  Configure the input fields to pass the correct information (see configuration options below).
5.  Save and publish the workflow.

## OneLogin Operations Overview

### List Users

Retrieve a list of employees from your OneLogin account. Supports flexible filtering to narrow down results.

Read [OneLogin API documentation](https://developers.onelogin.com/api-docs/2/users/list-users) for a full list of configuration options.

### Get User

Retrieve detailed employee information from OneLogin using a specific `user_id`. This data can be mapped against Persona verification results for validation.

Read [OneLogin API documentation](https://developers.onelogin.com/api-docs/2/users/get-user) for more information.

## FAQs

**What data can be compared between Persona and OneLogin?**

Standard fields (e.g., name, email) and any custom attributes available in your OneLogin directory.

**How else can Persona interact with OneLogin?**

Persona can be added to OneLogin as a Trusted Identity Provider (TIdP) which allows Persona identity verification to be triggered directly from within OneLogin. Please contact your Persona account team to learn more about this functionality.

## Plans Explained

### OneLogin Integration by plan

|                      | Startup Program | Essential Plan | Growth Plan | Enterprise Plan |
| -------------------- | --------------- | -------------- | ----------- | --------------- |
| OneLogin Integration | Not Available   | Not Available  | Limited     | Available       |

[Learn more about pricing and plans](https://withpersona.com/pricing?utm_source=product&utm_medium=referral&utm_audience=a&utm_campaign=cm_gen_ds_hc-plan-table).