OneLogin OAuth

This article will detail how you can use OneLogin OAuth with your FTP Today account.

You will need two browser windows/tabs for these steps.

Create the Identity Service at FTP Today

Log into your FTP Today Site.  Navigate to Settings…Authentication…Identity Service. Click on Add Service.

Image-001

 

Enter a name for the New Service and select “OneLogin OAuth” as the provider and Save.

Image-002

Create the Application at OneLogin

On your FTP Today Site, locate the configuration information.

Image-003

Log into your OneLogin site. Navigate to Applications and select Add App.

Image-004

In the Search field enter “SAML Test”, then select the “OpenId Connect (OIDC)”.

Image-005

Enter a name for the application, upload the icons you previously downloaded and Save.

Image-006

On your OneLogin site, select Configuration. Copy the values from your FTP Today site to the corresponding fields at OneLogin and Save.

Image-007

Select SSO and set the Token Endpoint to “POST” and Save.

Image-008

 

Configure the Identity Service at FTP Today

On your OneLogin site, select “SSO” and select “Show client secret”.  Locate the Client ID and Client Secret. Right-click the V2 Well-known Configuration and select Copy link.

Image-009

On your FTP Today Site, select “I want to use a Well-Known URL to set this configuration.” Paste well-known URL. Copy the Client ID and Client Secret from your OneLogin site, then Save.

Image-010

Assign the user to the application at OneLogin

Identify and select the user to have access to your FTP Today site

Image-011

Select Applications and click the “+” sign.

Image-012

Select your newly created app and Continue.

Image-013

 

Then Save.

Image-014

 

Add the user at FTP Today

In your FTP Today site, navigate to the Users area and select Add User.

Image-015

Enter the username as set up in the One Login service and select the OneLogin service you created.  Complete the rest of the fields as needed and Save.

Image-016

 

OneLogin supports an advanced security feature that offers further user verification. Your may register the user with a unique identifier from OneLogin.  In addition to matching the User Name to identify the user, we will match the OneLogin ID for that user. 

When setting up the user, navigate to the user at OneLogin, select User Info and locate the OneLoginID. Copy that value.

Image-017

Include that value as the IdP User Unique Identifier when you create the user.

Image-018

If the user already exists in your FTP Today site, you may change these settings on the Authentication tab for the user.

                User access through FTP Today

Navigate to the site and enter the username and click Next.

Image-019

 

There will be a brief “Authenticating” message. 

Image-020

If the user does not have an open session with OneLogin, they will have to authenticate.

Image-021

The user will now be logged into your FTP Today Site.

User access at OneLogin

Access the OneLogin portal.  On the home screen, the user can click on the FTP Today application.

Image-022

The user will be directed to the login page for your FTP Today site.  They will then enter their user name and be authenticated as above.

 

Ending the session

When done, the user may log out of the FTP Today site or allow the session to expire.  This will not log the user out of OneLogin or any other services authenticated through OneLogin. 

The user may also log out of OneLogin which will log the user out of your FTP Today Site. This will not close the browser window, but any action taken in the browser window will fail. After a short period, the browser window will reload to the login page.

The session timeout on the FTP Today Site may log the user out of the site even if they are still logged in at OneLogin.  In that case, after reentering their username they will be immediately authenticated to the site.