Connect Okta as an identity provider to Citrix Cloud (Technical Preview)

Citrix Cloud supports using Okta as an identity provider to authenticate subscribers signing in to their workspaces. By connecting your Okta organization to Citrix Cloud, you can provide a common sign-in experience for your subscribers to access resources in Citrix Workspace.

Note:

Okta authentication is currently in Technical Preview. Citrix recommends using technical preview features only in test environments.

Prerequisites

Cloud Connectors

You need at least two (2) servers in your Active Directory domain on which to install the Citrix Cloud Connector software. Cloud Connectors are required for enabling communication between Citrix Cloud and your resource location. Citrix recommends two servers for Cloud Connector high availability. These servers must meet the following requirements:

  • Meets the requirements described in Cloud Connector Technical Details.
  • Does not have any other Citrix components installed, is not an Active Directory domain controller, and is not a machine critical to your resource location infrastructure.
  • Joined to your Active Directory (AD) domain. If your workspace resources and users reside in multiple domains, you must install at least two Cloud Connectors in each domain. For more information, see Deployment scenarios for Cloud Connectors in Active Directory.
  • Connected to a network that can contact the resources that users access through Citrix Workspace.
  • Connected to the Internet. For more information, see Internet Connectivity Requirements.

For more information about installing Cloud Connectors, see Cloud Connector Installation.

Okta domain

When connecting Okta to Citrix Cloud, you must supply the Okta domain for your organization. Citrix supports the following Okta domains:

  • okta.com
  • okta-eu.com
  • oktapreview.com

You can also use Okta custom domains with Citrix Cloud. Review the important considerations for using custom domains in Customize the Okta URL domain on the Okta web site.

For more information about locating the custom domain for your organization, see Finding Your Okta Domain on the Okta web site.

Okta OIDC web application

To use Okta as an identity provider, you must first create an Okta OIDC web application with client credentials you can use with Citrix Cloud. After you create and configure the application, note the Client ID and Client Secret. You supply these values to Citrix Cloud when you connect your Okta organization.

To create and configure this application, see the following sections in this article:

Workspace URL

When creating the Okta application, you must supply your Workspace URL from Citrix Cloud. To locate the Workspace URL, select Workspace Configuration from the Citrix Cloud menu. The Workspace URL is shown on the Access tab.

Important:

If you modify the workspace URL later on, you must update the Okta application configuration with the new URL. Otherwise, your subscribers might experience issues with logging off from their workspace.

Okta API token

Using Okta as an identity provider with Citrix Cloud requires an API token for your Okta organization. Create this token using a Read-Only Administrator account in your Okta organization. This token must be able to read the users and groups in your Okta organization.

To create the API token, see Create an Okta API token in this article. For more information about API tokens, see Create an API Token on the Okta website.

Important:

When you create the API token, make a note of the token value (for example, copy the value temporarily to a plain text document). Okta displays this value only once, so you might create the token just before you perform the steps in Connect Citrix Cloud to your Okta organization.

Sync accounts with the Okta AD agent

To use Okta as an identity provider, you must first integrate your on-premises AD with Okta. To do this, you install the Okta AD agent in your domain and add your AD to your Okta organization. For guidance for deploying the Okta AD agent, see Okta Active Directory agent Deployment on the Okta web site. Afterward, you import your AD users and groups to Okta. When importing, include the SID, UPN, and OID values associated with your AD accounts.

Note:

If you are using Citrix Gateway service with Workspace, you don’t need to synchronize your AD accounts with your Okta organization.

To synchronize your AD users and groups with your Okta organization:

  1. Install and configure the Okta AD agent. For complete instructions, see Install and configure the Okta Active Directory agent on the Okta website.
  2. Add your AD users and groups to Okta by performing a manual import or an automated import. For more information about Okta import methods and instructions, see Import Active Directory Users on the Okta website.

Create an Okta OIDC web application

  1. From the Okta management console, under Applications, select Applications.
  2. Click Add Application and then click Create New App.
  3. In Sign in method, select OpenID Connect and then click Create. The Platform default value (Web) is unchanged.
  4. Enter an application name.
  5. In Login redirect URIs, enter https://accounts.cloud.com/core/login-okta.
  6. In Logout redirect URIs, enter your Workspace URL from Citrix Cloud.
  7. Click Save.

Configure the Okta OIDC web application

In this step, you configure your Okta OIDC web application with the settings required for Citrix Cloud. Citrix Cloud requires these settings to authenticate your subscribers through Okta when they sign in to their workspaces.

  1. From the Okta application configuration page, in General Settings, click Edit.
  2. In Allowed grant types, select the following options:
    • Authorization Code
    • Refresh Token
    • Implicit (Hybrid)
    • Allow ID Token with implicit grant type
    • Allow Access Token with implicit grant type
  3. Click Save.
  4. Allow user or group access to the application:
    1. From the Assignments tab, select Assign and then select Assign to People or Assign to Groups.
    2. Select the users or groups you want to have access to workspaces. To allow access for all users, select Assign to Groups and then select Everyone.
  5. Click Done.
  6. Add application attributes. These attributes are case-sensitive.
    1. From the Okta console menu, select Directory > Profile Editor.
    2. Locate the Okta user profile and select Profile. Under Attributes, select Add attribute.
    3. Enter the following information:
      • Display Name: cip_sid
      • Variable Name: cip_sid
      • Description: AD User Security Identifier
      • Attribute Length: Greater than 1
      • Attribute Required: Yes
    4. Click Save and Add Another.
    5. Enter the following information:
      • Display Name: cip_upn
      • Variable Name: cip_upn
      • Description: AD User Principal Name
      • Attribute Length: Greater than 1
      • Attribute Required: Yes
    6. Click Save and Add Another.
    7. Enter the following information:
      • Display Name: cip_oid
      • Variable Name: cip_oid
      • Description: AD User GUID
      • Attribute Length: Greater than 1
      • Attribute Required: Yes
    8. Click Save.
  7. Edit attribute mappings for the application:
    1. From the Okta console, select Directory > Directory Integrations.
    2. Select the AD you previously integrated. For more information, see Sync accounts with the Okta AD agent
    3. On the Settings tab, select Edit Mappings.
    4. Map the following attributes:
      • Select appuser.objectSid and map to the cip_sid attribute.
      • Select appuser.userName and map to the cip_upn attribute.
      • Select appuser.externalId and map to the cip_oid attribute.
    5. Click Save Mappings.
    6. Click Apply updates now.

Create an Okta API token

  1. Sign in to the Okta console using a Read-Only Administrator account.
  2. From the Okta console menu, select Security > API.
  3. Select the Tokens tab and then select Create Token.
  4. Enter a name for the token.
  5. Click Create Token.
  6. Copy the token value. You supply this value when you connect your Okta organization to Citrix Cloud.

Connect Citrix Cloud to your Okta organization

  1. Sign in to Citrix Cloud at https://citrix.cloud.com.
  2. From the Citrix Cloud menu, select Identity and Access Management.
  3. Locate Okta and select Connect from the ellipsis menu.
  4. In Okta URL, enter your Okta domain.
  5. In Okta API Token, enter the API token for your Okta organization.
  6. In Client ID and Client Secret, enter the credentials for your Okta application. To copy these values from the Okta console, select Applications and locate your Okta application. Under Client Credentials, use the Copy to Clipboard button for each value.
  7. Click Test and Finish. Citrix Cloud verifies your Okta details and tests the connection.

Enable Okta authentication for workspaces

  1. From the Citrix Cloud menu, select Workspace Configuration > Authentication.
  2. Select Okta. When prompted, select I understand the impact on the subscriber experience.
  3. Click Accept to accept the permissions request.