Okta (SAML2.0) - Web Console

This guide details authentication between Genian ZTNA (Service Provider), and Okta (Identity Provider).

SSO is achieved by invoking Okta authentication using the SAML2.0 protocol on the Genian ZTNA web console page and checking Okta for administrator authentication.

Prerequisites

Supported features

The Okta SAML integration currently supports the following features:

  • SP-initiated SSO
  • IdP-initiated SSO
  • JIT (Just-In-Time) provisioning
  • Single Logout (SLO)
  • Signed Requests

For more information on the listed features, visit the https://help.okta.com/okta_help.htm?type=oie&id=ext_glossary

Configuration steps

The following steps provide only a basic integration, which will be automatically applied after the first setup.

Step 1: Register an Okta account (If needed)

  1. Go to https://www.Okta.com/free-trial/ and apply for a trial account.

    • Select your information and country you want to use for authentication.

  2. Check the authentication mail received at the email address you requested.

    • An account information confirmation mail will be sent to the requested email address under the title 'Activate your Okta account'.

  3. Click the Activate Okta Accout button for activating your account.

    • When you log in, you will see a screen that sets the initial password change, security image, and security questions.
    • Okta console connection requires OTP 2factor authentication and requires iPhone, Android OTP app installation and OTP registration.
    • Once you have completed OTP registration and login, SAML APP setup for interworking will now begin.

Step 2: Add and set up SAML APP for authentication integration

  1. In the menu, navigate to Applications > Applications.

  2. From the Browse App Catalog menu, search for the Genians ZTNA application and select application.

  3. Click the "Add Integration".

  4. Enter an application label.

  5. In the Base URL field, enter the URL of the ZTNA policy server, as shown in the example below.

    • e.g. https://test.genians.net/mc2

  6. Select the Sign On tab

  7. Click the Settings > Sign on methods > SAML 2.0 > More details button to view IdP information.

  8. Copy and paste the following details into the Genian ZTNA Web Console > Preferences > General > Console > SAML2 Authentication > Identity Provider (IdP).

    • IdP SSO URL - the Identity Provider Sign on URL from Okta.
    • IdP Entity ID - the Identity Provider Issuer from Okta.
    • x509 Certificate - download the Signing Certificate from Okta and copy and paste the contents of the file.

  9. To enable JIT provisioning, you need to set up 'On' JIT provisioning in ZTNA

    • In the ZTNA UI, JIT provisioning > Additional columns , click the Add button to set the Username and Email for the user account. The Username attribute will be used to populate the first and last name of the Genian ZTNA account that is provisioned. The Email attribute will be used to populate both the username and email for the account.

      • For User Name, enter: {firstName} {lastName}.

        • Brackets are required for multiple attributes

      • For Email, enter: email.

        • The above attributes are already defined on okta and will be used during account provisioning..
        • Attributes other than the predefined ones can be added using the Attributes (Optional) menu.

    • In the ZTNA UI, JIT provisioning > Administrator Roles, Click the Add button to add an administrative role.

      • Please enter the name _ADMINROLE_superAdmin, which is set in the Configured SAML Attributes section of okta.

      • To add other administrative roles, you'll need to set up other role groups through Group Attribute Statements by clicking Attributes (Optional) in okta.

      • To enable JIT provisioning, you need to set up Group Attributes.

        • You must specify this by prefixing the name with _ADMINROLE_, as shown in the example below.

        • The name after _ADMINROLE_ must be the same (case sensitive) as the Administrator Role ID created in ZTNA (e.g. superAdmin, auditor).

        • The Configured SAML Attributes entry has _ADMINROLE_superAdmin set. You can do this by setting up a Group that roles as superAdmin.

          Name Filter
          _ADMINROLE_superAdmin Equals superAdmin

        • Please refer to the Step 3 Add Group description below for the group name.

  10. To enable Single Logout(SLO), you need to set up 'On' Single Logout(SLO) in ZTNA

    • In okta, go to Sign on > Settings and check Enable Single Logout.

    • Download the SP X.509 certificate and upload it to Signature Certificate in okta. You need the SP's certificate to use the SLO feature.

    • IdP SLO URL - the Identity Provider Single Logout URL from Okta.

      • If the Single Logout URL is not visible on the okta screen, please ensure that the Enable Single Logout setting is checked and then click the Save button.
      • Return to the Sign On tab and verify the Single Logout URL.

  11. To enable Signed Requests, you need to set up 'On' Signed Requests in ZTNA

    • For Signed Requests, you need to set up SAML through okta's Applications > Create App Integration to enable the feature.
    • Download the SP X.509 certificate and upload it to Signature Certificate in okta. You need the SP's certificate to use the Signed Requests feature.
    • Set up the Signed Requests entry in okta's SAML Settings.

  12. In Sign in button text, enter the text that will appear on the SAML authentication button in the ZTNA Web Console Authentication page.

  13. Click the Update button at the bottom of the Genian ZTNA Web Console Settings screen.

Note

Make sure that you entered the correct value in the Base URL field under the Sign On tab. Using the wrong value will prevent you from authenticating via SAML to ZTNA. e.g. https://test.genians.net/mc2

Step 3: Adding and assigning accounts for Okta Authentication Integration

If you are already registered, go to number 5

  1. Go to the Okta Console screen menu Directory > Groups.

  2. Click the Add Group button in the middle of the screen to create a group.

    • For JIT provisioning functionality, you need to create an Administrator Role Group. (e.g. superAdmin)

      ID description
      superAdmin Super administrator
      auditor Audit administrator

      You can see all the administrative roles offered by ZTNA in Preferences > User Authentication > Administrator Role.

  3. Go to the Okta Console Screen Menu Directory > People

  4. Click the Add Person button in the middle of the screen to add users.

    • For users who require JIT provisioning, you should select the Group created in step 2.

    Note

    The Password entry selects whether the administrator should specify a password to create or change it at the user's initial login.

  5. Go to the Okta Console screen menu Application > Application.

  6. Click the triangle icon on the right side of the APP that you registered above and click Assign to Users

  7. On the pop-up screen, click the Assign button on the right side of the account to be used for authentication integration through the APP to assign it to the APP.

Authentication Integration Test

How to test on Okta My Apps (IdP-initiated SSO)

  1. Connect to the Okta My Apps and click the ZTNA SAML App.

How to use App Embed Link (IdP-initiated SSO)

  1. Moving to the bottom of the General tab screen in okta provides an App Embed Link.
  2. You can sign into ZTNA through that link.

How to test on the Genian ZTNA Admin Web Console page (SP-initiated SSO)

  1. Connect to the Genian ZTNA Admin Web Console sign in page.
  2. Click the SAML Login button on the sign in page.
  3. A new pop-up window displays the Okta authentication page and authenticates by entering your username and password.

How to test Single Logout (SLO)

  1. Enable the SLO feature.
  2. Authenticate using the SSO functionality.
  3. Log out using the logout button at the top of the web console.
  4. If you're prompted to enter your Okta account information when you try SAML authentication again, the SLO worked correctly.

Note

After setting up the authentication link, you must add the OKTA IdP domain to the enforcement policy permissions to display the authentication link window even in the blocked state.

1. To add permissions
2. Go to Policy > Object > Network
3. Click Task > Create
4. Enter general information
5. Condition > FQDN > Enter IdP Domain (e.g. genians.okta.com)
6. Click Create
7. Go to Permission
8. Create permissions using network objects that you create
9. Assign permissions that you create in a enforcement policy