Configuring FME Flow for OneLogin SAML Authentication

Introduction

FME Flow 2022.0+ has incorporated SAML Authentication as a security login. You can configure FME Flow to use a variety of Identity Providers, and our documentation  will give you information on what's required from FME Flow. This article offers a step-by-step configuration for using OneLogin as the Identity Provider, if you would like to use a different provider please see Configuring FME Flow for SAML Authentication for more step-by-step tutorials. 

Requirements

The URL of your FME Flow and the one you set up with your Identity Provider (IdP) does not need to be publicly accessible, however, FME Flow SSL configuration is required. Please follow the documentation to Configure FME Flow for HTTPS.

Step-by-step Instructions

Part 1: Identity Provider Configuration

1. Create App in One Login
   1. In OneLogin, go to Applications on the top menubar, and click Applications. On the top-right, click Add App.
      
   2. Search for the SAML Custom Connector (Advanced), and select it.
      
   3. On the initial setup page, assign a display name for the app and any other additional information. Click Save.
2. In the menu, click Configuration and set the following parameters:​

   Entity ID (Audience URI): 

   https://<FMEFlowWebURL>/fmesaml/saml2/service-provider-metadata/fmeserver

   
   Reply URL (Assertion Consumer Service URL):

   https://<FMEFlowWebURL>/fmesaml/login/saml2/sso/fmeserver

   
   ACS (Consumer) URL Validator:

   ^https:\/\/<FMEFlowWebURL>\/fmesaml\/login/saml2\/sso\/fmeserver$

   Where <FMEFlowWebURL> is the fully-qualified hostname for FME Flow, including both the hostname and domain.
    

3. Set the SAML initiator to Service Provider.
   
4. To download the provider XML metadata file, click More Actions > SAML Metadata.
   
5. By default your users should have access to all applications in your tenancy, however, if you have restricted access please make sure your users have access to the new app.
6. Please ensure that you have enabled Just-in-Time provisioning/Auto-Membership on OneLogin as this is a required setting for user creation. 

Part 2: FME Flow Configuration

1. Logon to FME Flow and Navigate to User Management → SAML Configuration.
2. Import your IdP Metadata or provide the certificate and values.
3. Select the default user role you wish users to have when they log into FME Flow. 

Part 3: Test your Configuration

1. Log out of FME Flow and you should now have the option to Log In With SAML.  Once selected you should be prompted with the OneLogin Sign-in page, proceed with entering your credentials and if the configuration is correct you should be redirected back to the FME Flow home page.
         
2. Confirm that the user can log in and that the role and user information is as expected.