Connecter SAML en tant que fournisseur d'identité à NetScaler Console

Dernière publication : Sep 25, 2026
NetScaler Console prend en charge l'utilisation de SAML (Security Assertion Markup Language) en tant que fournisseur d'identité pour authentifier les administrateurs et les abonnés se connectant à leur NetScaler Console. Vous pouvez utiliser le fournisseur SAML 2.0 de votre choix avec votre Active Directory (AD) sur site.
Pour la plupart des fournisseurs SAML, utilisez les informations de cet article pour configurer l'authentification SAML. Si vous souhaitez utiliser l'authentification SAML avec votre Azure AD, vous avez la possibilité d'utiliser l'application Citrix Cloud™ SAML SSO de la galerie d'applications Azure AD.

Prérequis

L'authentification SAML avec NetScaler Console présente les exigences suivantes :
  • Fournisseur SAML prenant en charge SAML 2.0
  • Domaine AD sur site
  • Deux Cloud Connectors déployés sur un emplacement de ressources et joints à votre domaine AD sur site. Les Cloud Connectors sont utilisés pour garantir que Citrix Cloud peut communiquer avec votre emplacement de ressources.
  • Intégration d'AD avec votre fournisseur SAML.

Cloud Connectors

Vous devez disposer d'au moins deux (2) serveurs sur lesquels installer le logiciel Citrix Cloud Connector™. Il est recommandé d'avoir au moins deux serveurs pour la haute disponibilité des Cloud Connectors. Ces serveurs doivent répondre aux exigences suivantes :
  • Respecte les exigences système décrites dans les Détails techniques du Cloud Connector.
  • Ne doit pas avoir d'autres composants Citrix installés, ne doit pas être un contrôleur de domaine AD et ne doit pas être une machine critique pour l'infrastructure de votre emplacement de ressources.
  • Joint au domaine où résident vos ressources. Si les utilisateurs accèdent à des ressources dans plusieurs domaines, vous devez installer au moins deux Cloud Connectors dans chaque domaine.
  • Connecté à un réseau pouvant contacter les ressources auxquelles les abonnés accèdent via Citrix Workspace.
  • Connecté à Internet.

Active Directory

Avant de configurer l'authentification SAML, effectuez les tâches suivantes :
  • Les champs Prénom, Nom de famille et E-mail sont obligatoires pour les utilisateurs d'Active Directory afin d'importer les utilisateurs vers l'instance Okta.
  • Vérifiez que vos abonnés d'espace de travail disposent de comptes utilisateur dans Active Directory (AD). Les abonnés sans compte AD ne peuvent pas se connecter à leurs espaces de travail si l'authentification SAML est configurée.
  • Assurez-vous que les propriétés utilisateur des comptes AD de vos abonnés sont renseignées. Citrix Cloud a besoin de ces propriétés pour établir le contexte utilisateur lorsque les abonnés se connectent à Citrix Workspace. Si ces propriétés ne sont pas renseignées, les abonnés ne peuvent pas se connecter. Ces propriétés incluent :
    • Adresse e-mail
    • Nom d'affichage (facultatif)
    • Nom commun
    • Nom de compte SAM
    • Nom d'utilisateur principal
    • GUID d'objet
    • SID
  • Connectez votre Active Directory (AD) à votre compte Citrix Cloud en déployant des Cloud Connectors dans votre AD sur site.
  • Synchronisez vos utilisateurs AD avec le fournisseur SAML. Citrix Cloud a besoin des attributs utilisateur AD pour vos abonnés d'espace de travail afin qu'ils puissent se connecter avec succès.

Configuration SSO SAML

Dans une instance Okta, accédez à Intégrations d'annuaire > Ajouter Active Directory.
Instance Okta(/en-us/netscaler-console-service/media/saml-okta-navigation.png)
Pour une intégration réussie, le fournisseur d'identité SAML doit transmettre à Citrix Cloud certains attributs Active Directory de l'utilisateur dans l'assertion SAML. Plus précisément,
  • Identificateur de sécurité (SID)
  • objectGUID (OID)
  • Nom d'utilisateur principal (UPN)
  • Courrier (Email)
  1. Connectez-vous à Okta avec des informations d'identification d'administrateur.
  2. Sélectionnez Annuaire > Éditeur de profil et sélectionnez le profil Utilisateur Okta (par défaut). Okta affiche la page de profil utilisateur.
    Okta(/en-us/netscaler-console-service/media/saml-okta-edituser.png)
  3. Sous Attributs, sélectionnez Ajouter des attributs et ajoutez les champs personnalisés.
    • cip_sid
    • cip_upn
    • cip_oid
    • cip_email
      Attributs
    Cliquez sur Enregistrer et ajouter un autre et répétez le processus pour créer 4 attributs personnalisés.
    Vous pouvez afficher les détails suivants après avoir créé 4 attributs personnalisés :
    Attributs personnalisés
  4. Mappez les attributs Active Directory aux attributs personnalisés. Sélectionnez l'Active Directory que vous utilisez sous Utilisateurs > Répertoires.
  5. Modifiez les mappages d'attributs :
    1. Depuis la console Okta, accédez à Répertoire > Éditeur de profil.
    2. Localisez le profil active_directory de votre AD. Ce profil peut être étiqueté en utilisant le format myDomain User, où myDomain est le nom de votre domaine AD intégré.
    3. Sélectionnez Mappages. La page Mappages de profils utilisateur de votre domaine AD apparaît et l'onglet pour le mappage de votre AD à l'utilisateur Okta est sélectionné.
      Mappage de profil
    4. Dans la colonne Profil utilisateur Okta, mappez les attributs Active Directory aux attributs personnalisés que vous avez créés :
      1. Pour cip_email, sélectionnez l'e-mail dans la colonne Profil utilisateur de votre domaine. Une fois sélectionné, le mappage apparaît comme appuser.email.
      2. Pour cip_sid, sélectionnez objectSid dans la colonne Profil utilisateur de votre domaine. Une fois sélectionné, le mappage apparaît comme appuser.objectSid.
      3. Pour cip_upn, sélectionnez userName dans la colonne Profil utilisateur de votre domaine. Une fois sélectionné, le mappage apparaît comme appuser.userName.
      4. Pour cip_oid, sélectionnez externalId dans la colonne Profil utilisateur de votre domaine. Une fois sélectionné, le mappage apparaît comme appuser.externalId.
        Mappage de profil
  6. Connectez-vous à Citrix Cloud à l'adresse https://citrix.cloud.com.
  7. Dans le menu Citrix Cloud, sélectionnez Gestion des identités et des accès.
  8. Recherchez SAML 2.0 et cliquez sur Connecter.
    La page Configurer SAML s'affiche.
    Configurer SAML
    Téléchargez le fichier xml et ouvrez le fichier à l'aide de n'importe quel éditeur de fichiers. Vous devrez revenir à cette page après avoir terminé la configuration supplémentaire dans Okta.
  9. Dans Okta, accédez à Application > Créer une intégration d'application.
  10. Dans la page Ajouter une application, cliquez sur Créer une nouvelle application.
  11. Dans la page Créer une nouvelle intégration d'application, sélectionnez SAML 2.0 et cliquez sur Créer.
  12. Fournissez des détails tels que le nom de l'application, le logo de l'application (facultatif), définissez la visibilité de l'application, puis cliquez sur Suivant.
  13. Dans l'onglet Configuration SAML, vous devez utiliser les détails du fichier xml téléchargé :
    1. Fournissez les détails de l'URL pour URL d'authentification unique comme https://saml-internal.cloud.com/saml/acs et URI d'audience (ID d'entité SP) comme https://saml-internal.cloud.com.
      Remarque :
      Si Citrix Cloud est externe, l'URL doit être https://saml.cloud.com/saml/acs et https://saml.cloud.com au lieu du domaine https://saml-internal.cloud.com.
    2. Sélectionnez Non spécifié pour Format d'ID de nom.
    3. Sélectionnez Nom d'utilisateur Okta pour Nom d'utilisateur de l'application.
    4. Cliquez sur Afficher les paramètres avancés et assurez-vous que Réponse et Assertion sont sélectionnés avec Signé.
      URL Okta
    5. Ajoutez des déclarations d'attributs comme indiqué dans l'image suivante.
      Attributs
    6. Vous pouvez laisser toutes les autres options par défaut et cliquer sur Suivant.
    7. Sélectionnez Je suis un client Okta ajoutant une application interne, puis cliquez sur Terminer.
  14. L'application Okta est maintenant créée, cliquez sur Afficher les instructions de configuration.
    Instructions de configuration
    La page Comment configurer SAML 2.0 pour l'application de test s'affiche avec les détails que vous devez à nouveau ajouter dans Citrix Cloud.
    Téléchargez le certificat pour le télécharger dans Citrix Cloud.
  15. Vous devez maintenant revenir à la page Configurer SAML dans Citrix Cloud et terminer la configuration restante comme mentionné ci-dessous :
    Étapes restantes
    Utilisez le certificat téléchargé et renommez l'extension de fichier de .cert en .crt pour le télécharger sur Citrix Cloud.
  16. Après avoir téléchargé le certificat, utilisez toutes les autres options par défaut :
    Aperçu SAML
  17. Ensuite, vous devez vous assurer que appuser.userName est défini dans Directory-integrations > Active Directory -> Provisiong > To okta.
    Nom d'utilisateur SAML
    Remarque :
    Parfois, vous devez utiliser user.cip_upn, au lieu de appuser.cip_upn. Assurez-vous de vérifier la définition de votre application dans l'intégration OKTA, comme indiqué dans cette image.
  18. Vous devez maintenant essayer d'ajouter des utilisateurs dans Okta à cette application SAML. Vous pouvez attribuer des utilisateurs de plusieurs manières.
    Méthode 1 :
    1. Connectez-vous à Okta avec des informations d'identification d'administrateur
    2. Accédez à Applications > Applications
    3. Sélectionnez l'application SAML que vous avez créée
    4. Cliquez sur Attribuer > Attribuer à des personnes
      Ajouter un utilisateur
    5. Cliquez sur Attribuer, puis sélectionnez Enregistrer et revenir.
    6. Cliquez sur Terminé.
    Méthode 2 :
    1. Accédez à Applications > Applications.
    2. Cliquez sur Attribuer des utilisateurs à l'application.
      Attribuer des utilisateurs à l'application
    3. Sélectionnez l'application et les utilisateurs, puis cliquez sur Suivant.
      Attribuer des utilisateurs
    4. Cliquez sur Confirmer les attributions.
    Méthode 3 :
    1. Accédez à Répertoire > Personnes.
    2. Sélectionnez un utilisateur.
    3. Cliquez sur Attribuer des applications et attribuez l'application SAML à l'utilisateur.
  19. Après avoir attribué les utilisateurs, connectez-vous à Citrix Cloud.
  20. Dans le menu Citrix Cloud, sélectionnez Gestion des identités et des accès.
  21. Dans l'onglet Administrateurs, cliquez sur Ajouter un administrateur/groupe.
  22. Sélectionnez Active Directory - dans la liste, sélectionnez le domaine, puis cliquez sur Suivant.
    SAML AD
  23. Spécifiez les autorisations d'accès.
  24. Vérifiez que tout est correct et cliquez sur Envoyer l'invitation.
  25. Dans l'onglet Authentification, vous pouvez afficher l'URL de connexion pour SAML 2.0. Voici un exemple :
    Exemple SAML