|Manuals

Configure SAML with Okta

In this quick tutorial, we will show how to properly configure Okta SAML for Thinfinity Remote Desktop Server.

  1. Navigate to your Okta space, go to the Applications tab, and create a new application using the “Create New App” button :
Okta Applications tab with Create New App button
  1. Choose “SAML 2.0” as the Authentication Method.
Okta application creation dialog with SAML 2.0 selected as authentication method
  1. Assign a name to the application.
Okta SAML General Settings for entering the application name
  1. Configure the “Single sign-on URL” and “Audience URI” .
Okta SAML configuration with Single sign-on URL and Audience URI fields

The “Single Sign-on URL” address should be the following : https://[MyThinfinityWebSite]/SAMLAssertionConsumerService

The Audience URI should be the URI used to connect to Thinfinity : https://[MyThinfinityWebSite]/

  1. Choose the Feedback options that apply to your application :
Okta SAML application Feedback options
  1. Now that the application is created, it should redirect you to the “Settings” window. Select “View Setup Instructions” for further information :
Okta SAML application Settings window with View Setup Instructions link

In here you will get the “Identity Provider Single Sign-on URL”, the Identity Provider Issuer, and the Certificate provided by Okta.

Okta Setup Instructions showing Identity Provider Single Sign-on URL, Identity Provider Issuer, and X.509 Certificate
  1. Now, open the Thinfinity Remote Desktop Server Manager or Thinfinity VirtualUI Server manager, navigate to the “Authentication” tab, press the “Add” option and select “SAML” :
Thinfinity Server Manager Authentication tab with SAML option in the Add menu
  1. In here, you will have to add the different values provided by Okta in order to enable SAML :
SAML authentication configuration dialog with Service Identifier, Service Certificate File, Identification Entity ID, Single Sign-On Service URL, and Partner Certificate File fields

Service Identifier = Audience URI (SP Entity ID)

Service Certificate File = Your certificate’s file.

Service Certificate Password = Your certificate’s password.

Identification Entity ID = Identity Provider Issuer

Single Sign-On Service URL = Identity Provider Single Sign-On URL

Sign-Out URL = This value is optional.

Partner Certificate File = X.509 Certificate provided by Okta.

After you finish adding all those values, press “Ok”.

10 ) Select the “Mappings” tab and then press “Add” under the Authentication ID Mask.

SAML Mappings tab with Authentication ID Mask Add button

Add the email address of the Okta user you want to validate and press “Ok”.

Then, under the “Associated Permissions” field, press on the “Add” button and search for the Active Directory User

SAML Mappings tab with Associated Permissions Add button for selecting an Active Directory user

After you add the appropriate mappings, select the “Apply” button.

  1. Navigate to the z/Anywhere’s landing page, and you should see the “Login With SAML” option listed as an Authentication Method.
z/Scope Anywhere landing page with Login With SAML option