Connectors / Service / OneLogin

(updated: 1608216379755)

OneLogin

Identity & Access Management for the Hybrid Enterprise.
All operations

Overview

OneLogin is a complete Identity & Access Management system.

Authentication

  • Access OneLogin as an account owner or administrator.

  • Go to Developers > API Credentials.

  • On the API Access page, click New Credential.

  • Give your credential a name.

    Osnelogin-new-api-credential

  • Click Save.

  • Copy the client secret and client ID

    Osnelogin-new-api-credential

  • Open the tray workflow, click on New Authentication

  • Paste the client secret and client ID

  • Click Next to save the authentication

The OneLogin Trigger

The OneLogin trigger allows you to trigger a workflow when an event occurs, for example when a user role is updated.

To setup the trigger, get the Public URL of your Tray Workflow, which can be found by clicking on the wheel in the top-left corner of the workflow editor:

onelogin-workflow-settings

  • Copy the Public URL

  • Access OneLogin as an account owner or administrator.

  • Go to Developers > Webhooks

  • Set the format type to JSON Array

  • Set the Listener URL to the Workflow Public URL

  • Click Save

    onelogin-broadcaster-settings

Example

In this example we build a simple workflow to send a slack message when a user is added to a new role. Create a new workflow with the OneLogin Trigger, and select the Specific event operation, with the event type set to USER_ASSIGNED_ROLE. Add the slack service from the list on the left.

onelogin-trigger-example

You can then send the username to a Slack channel by using the Slack connector and setting its Message property value to a JSONpath of the Webhook's Request Query Parameters.

onelogin-slack-connector

All Operations

Latest version:

2.1

Authenticate user

Delegate authentication of a user to OneLogin.

Create user

Create a user in OneLogin.

Delete user

Delete a user by ID.

Assign user role

Assign one or more existing roles to a user.

List apps by user

Retrieve a list of apps for a user.

List available authentication factors

Returns a list of the authentication factors available to enroll a user with.

List available authentication factors DDL

List custom attributes

Retrieve a list of custom attributes.

List custom attributes DDL

List enrolled authentication factors

Returns a list of the authentication factors a user is enrolled on.

List enrolled authentication factors DDL

List groups

Retrieve a list of groups.

List groups DDL

List roles

Retrieve list of roles.

List roles DDL

List roles by user

Retrieve a list of roles by user ID.

Update password

Update password for a user (non-hash value).

Update password hashed

Update password for a user (with a hash value). Cannot validate password.

Update user

Update a user in OneLogin.

Update user state

Update the state for a user.

Activate authentication factor

Activates an authentication factor for a particular user. Necessary if `needs_trigger` was returned as `true` when the factor was enrolled.

Enroll authentication factor

Enrolls an authentication factor for a particular user. Currently only available for OneLogin SMS and OneLogin Voice authentication factors.

Generate authentication factor token

Generates a one-time password (OTP) token for an authentication factor.

Get group

Retrieve a single group by its ID.

Get rate limit

Get current rate limit details about an access token.

Get role

Retrieve a single role by its ID.

Get user

Retrieve a single user by its ID.

List users

Retrieve a list of all users.

List users DDL

Lock user account

Lock a user account until specified time.

Log user out

Logs user out of any and all sessions.

Raw HTTP request (advanced)

Perform a raw HTTP request with some pre-configuration and processing by the connector, such as authentication.

Remove authentication factor

Removes an authentication factor enrollment from a user.

Remove user role

Remove role from a user.

Verify authentication factor

Verifies an authentication factor for a particular user.