Citrix DaaS™

Authentification unique Microsoft Entra

Vous pouvez tirer parti de l’authentification unique (SSO) lorsque vous utilisez les informations d’identification Microsoft Entra ID pour accéder aux applications et bureaux virtuels sur les hôtes de session joints à Microsoft Entra ou joints hybrides à Microsoft Entra.

Infrastructure prise en charge

Voici un aperçu des composants d’infrastructure pris en charge pour l’authentification unique Microsoft Entra :

Identité de la machine Citrix DaaS Citrix DaaS Local Citrix StoreFront Cloud Citrix StoreFront Citrix Gateway Service NetScaler Gateway
Joint à Microsoft Entra Oui Non Oui Non Oui Oui
Joint à Microsoft Entra hybride Oui Oui Oui Oui Oui Oui

REMARQUE :

  • Pour plus de détails sur la configuration de l’authentification unique Microsoft Entra avec Citrix DaaS Local, reportez-vous à la documentation de Citrix DaaS Local.
  • Pour plus de détails sur la configuration de l’authentification unique Microsoft Entra avec StoreFront, reportez-vous à la documentation de StoreFront.

Fournisseurs d’identité pris en charge

Voici un aperçu des fournisseurs d’identité Workspace pris en charge pour l’authentification unique Microsoft Entra :

Identité de la machine Entra ID Active Directory Active Directory + Jeton Okta SAML NetScaler Gateway Authentification adaptative
Joint à Microsoft Entra Oui Non Non Non Oui Non Non
Joint à Microsoft Entra hybride Oui Non Non Non Oui Non Non

REMARQUE

Si vous prévoyez d’utiliser SAML comme votre IdP, vous devez vous assurer que votre fournisseur SAML est correctement configuré pour prendre en charge l’authentification basée sur Entra. Voir SAML utilisant Microsoft Entra ID et les identités Microsoft Entra pour l’authentification de l’espace de travail.

Méthodes d’accès prises en charge

Voici les méthodes d’accès disponibles dans un environnement Citrix :

  • Accès natif : Vous utilisez le client natif de l’application Citrix Workspace pour accéder à votre magasin et établir la connexion de session.
  • Accès par navigateur : Vous accédez à votre magasin via un navigateur et vous vous connectez à l’application virtuelle ou à la session de bureau à l’aide du client Citrix Workspace app pour HTML5.
  • Accès hybride : Vous accédez à votre Store via un navigateur et vous vous connectez à la session d’application virtuelle ou de bureau à l’aide du client natif de l’application Workspace.

Voici un aperçu des méthodes d’accès prises en charge pour l’authentification unique Microsoft Entra :

Méthode d’accès Windows Linux Mac Chrome OS Android iOS
Natif Oui Oui Oui Oui Oui Oui
Navigateur Oui Oui Oui Oui Oui Oui
Hybride Oui Oui Oui Non Non Non

Configuration système requise

Voici la configuration système requise pour utiliser l’authentification unique Microsoft Entra :

  • Plan de contrôle : Citrix DaaS
    • Citrix Cloud Commercial (États-Unis, UE et APS)
    • Citrix Cloud Japan
  • Portail utilisateur : Citrix® StoreFront Cloud
  • Virtual Delivery Agent (VDA)
    • Windows : version 2507 ou ultérieure
  • Application Citrix Workspace
    • Windows : version 2507 ou ultérieure
    • Linux : version 2508 ou ultérieure (version 2601 ou ultérieure requise pour l’accès hybride)
    • Mac : version 2508 ou ultérieure (version 2511 ou ultérieure requise pour l’accès hybride)
    • HTML5 : version 2511 ou ultérieure
    • Chrome OS : version 2511 ou ultérieure
    • Android : version 2511 ou ultérieure
    • iOS : version 2511 ou ultérieure
  • Extension Web Citrix
  • OS de l’hôte de session :

REMARQUE

L’extension Web Citrix n’est nécessaire que si vos utilisateurs exploitent l’accès hybride sur des appareils Windows, Linux ou Mac. Si vos utilisateurs exploitent l’accès natif ou par navigateur, l’extension Web Citrix n’est pas nécessaire.

Considérations

  • Si vos utilisateurs exploitent l’accès hybride, ils doivent utiliser Microsoft Edge ou Google Chrome et installer l’extension Web Citrix. L’authentification unique Microsoft Entra avec accès hybride n’est pas prise en charge avec d’autres navigateurs.
  • La reconnexion automatique du client n’est pas prise en charge lorsque l’authentification unique Microsoft Entra est utilisée pour se connecter à la session. Cette fonctionnalité est automatiquement désactivée lorsque cette méthode de connexion est utilisée. La fiabilité de session est toujours disponible pour la reconnexion automatique en cas de perturbations du réseau.
  • Lorsqu’un bureau virtuel est verrouillé, le comportement par défaut est d’afficher l’écran de verrouillage Windows. Selon vos exigences d’authentification, vous devrez peut-être modifier le comportement de verrouillage de session. Consultez Comportement de verrouillage de session pour plus de détails.
  • Si vous utilisez des hôtes de session joints à Microsoft Entra hybride, l’authentification unique ne fonctionne pas par défaut pour les membres de groupes privilégiés tels que les administrateurs de domaine. Pour l’activer, ajoutez le groupe ou l’utilisateur à la liste d’autorisation du contrôleur de domaine en lecture seule (RODC) pour l’accès Kerberos Microsoft Entra. Consultez Accès Kerberos TGT et contrôle d’accès Active Directory de Microsoft Entra pour plus de détails.
  • Microsoft Entra External ID n’est pas pris en charge pour le moment. Si vous devez fournir un accès aux utilisateurs invités, reportez-vous à SAML utilisant Entra ID pour les identités d’invités et B2B pour l’authentification de l’espace de travail.
  • L’authentification unique Microsoft Entra nécessite que le paramètre Windows Allow Custom SSPs and APs to be loaded into LSASS soit activé (par défaut). Notez que si vous déployez le modèle Security Baseline for Windows 10 and later via Microsoft Intune, ce paramètre est automatiquement désactivé et bloquera l’authentification unique, vous devez donc mettre à jour votre stratégie de configuration d’appareil Intune pour le maintenir activé.

Comment configurer l’authentification unique Microsoft Entra

Vue d’ensemble

La configuration de l’authentification unique Microsoft Entra comprend les étapes suivantes :

  1. Configuration d’Azure et de Microsoft Entra ID
    1. Enregistrer les applications de ressources et clientes Citrix.
    2. Activer le protocole d’authentification des services Bureau à distance Microsoft Entra ID pour l’application de ressources Citrix.
    3. Masquer l’invite de consentement de l’utilisateur.
    4. Approuver l’application cliente.
    5. Créer un objet serveur Kerberos (environnements joints hybrides Microsoft Entra uniquement).
    6. Examiner les stratégies d’accès conditionnel Microsoft Entra.
  2. Configuration Citrix
    1. Provisionner les hôtes de session avec la version de système d’exploitation, le type d’identité et la version de VDA requis.
    2. Configurer Citrix® StoreFront Cloud :
      1. Configurer un fournisseur d’identité approprié.
      2. Activer l’authentification unique Microsoft Entra
    3. Configurer le type d’ouverture de session de vos groupes de mise à disposition si nécessaire.

Les détails de chaque étape de configuration sont fournis dans les sections suivantes.

Configuration d’Azure et de Microsoft Entra ID

Pour tirer parti de l’authentification unique Microsoft Entra, vous devez d’abord autoriser l’authentification Microsoft Entra pour Windows dans votre locataire Microsoft Entra ID, ce qui permet d’émettre les jetons d’authentification requis qui permettent aux utilisateurs de se connecter aux hôtes de session joints à Microsoft Entra et aux hôtes de session hybrides joints à Microsoft Entra.

La personne effectuant la configuration Azure doit se voir attribuer l’un des rôles intégrés Microsoft Entra suivants ou un rôle équivalent au minimum :

La configuration peut être effectuée via le portail Azure, à l’aide du SDK Microsoft Graph PowerShell ou de l’API Microsoft Graph. Les sections suivantes fournissent des détails sur la façon d’effectuer la configuration via le portail Azure. Si vous préférez utiliser le SDK Microsoft Graph PowerShell ou l’API Microsoft Graph, reportez-vous à la section Configuration Azure de l’authentification unique Microsoft Entra.

Enregistrer les applications Citrix

L’authentification unique Microsoft Entra nécessite une application de ressource Entra ID et une application cliente Entra ID. L’application de ressource représente le système d’exploitation Windows lors de la demande du jeton d’accès RDP. L’application cliente représente l’application Citrix Workspace.

Vous pouvez enregistrer les applications Citrix Resource et Citrix Client via le portail Citrix Cloud :

  1. Ouvrez le menu dans le coin supérieur gauche et sélectionnez Identity and access management.

  2. Sur la page Authentication, recherchez le fournisseur d’identité Microsoft Entra ID pour lequel vous souhaitez activer l’authentification unique Microsoft Entra.

  3. Ouvrez le menu des options et sélectionnez Set up Microsoft Entra SSO.

    Enregistrement de l'application Entra 1

  4. Cliquez sur Register à côté de Enregistrer l’application de ressource.

    Enregistrement de l'application Entra 2

  5. Acceptez les autorisations demandées pour l’application de ressource Citrix.

    Enregistrement de l'application Entra 3

  6. Cliquez sur Register à côté de Enregistrer l’application cliente.

    Enregistrement de l'application Entra 4

  7. Acceptez les autorisations demandées pour l’application cliente Citrix.

    Enregistrement de l'application Entra 5

Vous pouvez également utiliser les URL de consentement suivantes pour enregistrer les applications. Assurez-vous d’enregistrer d’abord l’application de ressource, puis l’application cliente.

  • Citrix Cloud US, EU, APS
    • Application de ressource : https://login.microsoftonline.com/common/adminconsent?client_id=3a510bb1-e334-4298-831e-3eac97f8b26c
    • Application cliente : https://login.microsoftonline.com/common/adminconsent?client_id=85651ebe-9a8e-49e4-aaf2-9274d9b6499f
  • Citrix Cloud Japan
    • Application de ressource : https://login.microsoftonline.com/common/adminconsent?client_id=0027603f-364b-40f2-98be-8ca4bb79bf8b
    • Application cliente : https://login.microsoftonline.com/common/adminconsent?client_id=0fa97bc0-059c-4c10-8c54-845a1fd5a916

Voici les autorisations des applications :

Application de ressources Citrix

Un principal de service est créé avec les autorisations suivantes :

Nom de l’API Valeur de la revendication Autorisation Type
Microsoft Graph User.Read Se connecter et lire le profil utilisateur Délégué

Pour Citrix Cloud US, EU et APS, l’application est appelée Citrix-Workspace-Resource (ID d’application 3a510bb1-e334-4298-831e-3eac97f8b26c).

Pour Citrix Cloud Japan, l’application est appelée Citrix-Workspace-Resource-JP (ID d’application 0027603f-364b-40f2-98be-8ca4bb79bf8b).

Application cliente Citrix

Un principal de service est créé avec les autorisations suivantes :

Nom de l’API Valeur de la revendication Autorisation Type
Citrix-Workspace-Resource
Citrix-Workspace-Resource-JP
user_impersonation
Citrix Entra ID SSO
Délégué
Microsoft Graph User.Read Se connecter et lire le profil utilisateur Délégué

Pour Citrix Cloud US, EU et APS, l’application est appelée Citrix-Workspace (ID d’application 85651ebe-9a8e-49e4-aaf2-9274d9b6499f).

Pour Citrix Cloud Japan, l’application est appelée Citrix-Workspace-JP (ID d’application 0fa97bc0-059c-4c10-8c54-845a1fd5a916).

Activer le protocole d’authentification des services Bureau à distance Microsoft Entra ID

Vous devez activer le protocole d’authentification des services Bureau à distance Microsoft Entra ID dans l’application Citrix Resource. Pour ce faire :

  1. Dans Azure Portal, accédez à Microsoft Entra ID > Devices > Manage > Remote connection configuration.

    Configuration de l'application Entra 1

  2. Sélectionnez Citrix-Workspace-Resource.

  3. Activez le protocole d’authentification des services Bureau à distance Microsoft Entra ID.

    Configuration de l'application Entra 2

  4. Poursuivez pour masquer l’invite de consentement de l’utilisateur.

Masquer la boîte de dialogue d’invite de consentement de l’utilisateur

Par défaut, les utilisateurs sont invités à autoriser la connexion Bureau à distance lorsqu’ils se connectent à un hôte de session joint à Microsoft Entra ou joint à Microsoft Entra hybride avec l’authentification unique Microsoft Entra activée, auquel cas ils doivent sélectionner Oui pour autoriser l’authentification unique. Microsoft Entra se souviendra de jusqu’à 15 hôtes de session uniques pendant 30 jours avant de demander à nouveau.

Vous pouvez masquer cette boîte de dialogue en configurant une liste de périphériques cibles. Pour configurer la liste des périphériques, vous devez créer un ou plusieurs groupes dans Microsoft Entra ID qui contiennent les hôtes de session joints à Microsoft Entra et/ou joints à Microsoft Entra hybride, puis autoriser les groupes dans l’application de ressource, jusqu’à un maximum de 10 groupes.

Une fois que vous avez activé le protocole d’authentification des services Bureau à distance Microsoft Entra ID et que les groupes ont été créés :

  1. Cliquez sur le lien pour ajouter les groupes d’appareils cibles et sélectionnez les groupes appropriés.

    Configuration de l'application Entra 3

REMARQUE

Il est fortement recommandé de créer un groupe dynamique pour simplifier la gestion des membres du groupe. Bien que les groupes dynamiques se mettent normalement à jour en 5 à 10 minutes, les grands locataires peuvent prendre jusqu’à 24 heures.

Les groupes dynamiques nécessitent la licence Microsoft Entra ID P1 ou la licence Intune pour l’éducation. Pour plus d’informations, consultez Règles d’appartenance dynamique pour les groupes.

Approuver l’application cliente

Vous devez ajouter explicitement l’application Citrix Client en tant que client approuvé dans l’application Citrix Resource :

  1. Cliquez sur le lien pour ajouter vos applications clientes approuvées.

    Configuration de l'application Entra 4

  2. Sélectionnez l’application Citrix Client.

    Configuration de l'application Entra 5

  3. Sélectionnez Enregistrer pour appliquer les modifications de configuration à l’application Citrix Resource.

    Configuration de l'application Entra 6

Créer un objet serveur Kerberos

Si vos hôtes de session sont joints à Microsoft Entra hybride, vous devez configurer un objet de serveur Kerberos dans le domaine Active Directory où résident les comptes d’utilisateur et d’ordinateur. Pour plus de détails, consultez Créer un objet de serveur Kerberos.

Vérifier les stratégies d’accès conditionnel de Microsoft Entra

Si vous utilisez ou prévoyez d’utiliser les stratégies d’accès conditionnel de Microsoft Entra, celles-ci doivent être appliquées à l’application de ressources Citrix.

Pour des conseils détaillés sur la configuration de l’accès conditionnel lors de l’utilisation de l’authentification unique Microsoft Entra pour DaaS, reportez-vous à la documentation Microsoft. N’oubliez pas que les paramètres d’accès conditionnel requis doivent être appliqués à l’application de ressources Citrix, et non à l’application cliente Citrix ou aux applications Microsoft.

Configuration Citrix

Hôtes de session Citrix

Assurez-vous que les exigences système pour les hôtes de session sont respectées :

  1. Assurez-vous que les hôtes de session sont soit joints à Microsoft Entra, soit joints à Microsoft Entra hybride.
  2. Installez la version et la build du système d’exploitation requises, comme spécifié dans les exigences système.
  3. Installez la version VDA requise, comme spécifié dans les exigences système.
Hôtes de session joints à Microsoft Entra hybride

Si vous déployez des hôtes de session joints à Microsoft Entra hybride avec Citrix Machines Creation Services, Citrix Provisioning ou Windows 365, vous pouvez passer à la section suivante. Si vous provisionnez des hôtes joints à Microsoft Entra hybride à l’aide de tout autre outil ou méthode, vous devez ajouter la valeur de registre suivante à vos hôtes de session :

  • Clé : HKLM\SYSTEM\CurrentControlSet\Control\Citrix
  • Type de valeur : DWORD
  • Nom de la valeur : AzureADJoinType
  • Données : 1
Comportement de verrouillage de session

Lorsqu’un bureau virtuel est verrouillé, le comportement par défaut consiste à afficher l’écran de verrouillage Windows. À ce stade, les méthodes d’authentification prises en charge pour déverrouiller le bureau sont le nom d’utilisateur et le mot de passe ou la carte à puce.

REMARQUE

La connexion web Citrix (aperçu) vous permet de déverrouiller votre bureau à l’aide de l’authentification Entra basée sur le web. Pour plus de détails, consultez Connexion web.

Si vous avez un déploiement sans mot de passe où les utilisateurs ne connaissent pas leurs mots de passe, il est recommandé de configurer le comportement de verrouillage de session pour déconnecter la session au lieu d’afficher l’écran de verrouillage.

  • Hôtes de session multi-session

    Vous pouvez configurer ce comportement en activant le paramètre Déconnecter la session à distance lors du verrouillage pour l’authentification de la plateforme d’identité Microsoft via Intune ou une stratégie de groupe. Pour des étapes détaillées, consultez Configurer le comportement de verrouillage de session pour Azure Virtual Desktop.

  • Hôtes de session à session unique

    Si vous utilisez la version 2603 ou ultérieure du VDA, vous pouvez configurer ce comportement en activant le paramètre Déconnecter la session à distance lors du verrouillage pour l’authentification de la plateforme d’identité Microsoft via Intune ou une stratégie de groupe. Pour des étapes détaillées, consultez Configurer le comportement de verrouillage de session pour Azure Virtual Desktop.

    Si vous utilisez la version 2511 ou antérieure du VDA, le paramètre Déconnecter la session à distance lors du verrouillage pour l’authentification de la plateforme d’identité Microsoft n’est pas pris en charge. Cependant, vous pouvez obtenir le même comportement en créant une tâche planifiée Windows.

    L’exemple de script suivant crée une tâche planifiée sur les hôtes à session unique qui exécute cmd.exe /c tsdiscon lorsque le bureau est verrouillé :

     # Create the TaskService COM object
     $service = New-Object -ComObject "Schedule.Service"
     $service.Connect()
    
     # Get the root folder and create a new task definition
     $rootFolder = $service.GetFolder("\")
     $taskDef = $service.NewTask(0)
    
     # Registration info
     $taskDef.RegistrationInfo.Description = "Disconnect session when workstation is locked"
    
     # Principal (Users group, least privilege)
     $principal = $taskDef.Principal
     $principal.GroupId = "S-1-5-32-545"
     $principal.RunLevel = 0  # 0 = LeastPrivilege
    
     # Settings
     $settings = $taskDef.Settings
     $settings.Enabled = $true
     $settings.AllowDemandStart = $true
     $settings.DisallowStartIfOnBatteries = $false
     $settings.StopIfGoingOnBatteries = $false
     $settings.AllowHardTerminate = $false
     $settings.StartWhenAvailable = $false
     $settings.RunOnlyIfNetworkAvailable = $false
     $settings.IdleSettings.StopOnIdleEnd = $true
     $settings.IdleSettings.RestartOnIdle = $false
     $settings.Hidden = $false
     $settings.RunOnlyIfIdle = $false
     $settings.DisallowStartOnRemoteAppSession = $false
     $settings.UseUnifiedSchedulingEngine = $true
     $settings.WakeToRun = $false
     $settings.ExecutionTimeLimit = "PT0S"   # Unlimited
     $settings.Priority = 7
     $settings.MultipleInstances = 1         # IgnoreNew
    
     # Trigger: SessionLock
     $trigger = $taskDef.Triggers.Create(11)  # 11 = TASK_TRIGGER_SESSION_STATE_CHANGE
     $trigger.StateChange = 7                 # 7 = SessionLock
     $trigger.Enabled = $true
    
     # Action: tsdiscon
     $action = $taskDef.Actions.Create(0)     # 0 = Exec
     $action.Path = "cmd.exe"
     $action.Arguments = "/c tsdiscon"
    
     # Register the task
     $rootFolder.RegisterTaskDefinition(
         "Disconnect on Lock",  # Task name
         $taskDef,
         6,                     # TASK_CREATE_OR_UPDATE
         $null, $null,          # No specific user/password
         3                      # TASK_LOGON_GROUP
     ) | Out-Null
     <!--NeedCopy-->
    

    Si vous devez ultérieurement supprimer la tâche planifiée, vous pouvez exécuter la commande suivante :

     Unregister-ScheduledTask -TaskName "Disconnect on Lock" -Confirm:$false
     <!--NeedCopy-->
    

Plan de contrôle et d’accès Citrix

Authentification Workspace

Vous devez configurer Citrix® StoreFront Cloud pour utiliser Microsoft Entra ID ou SAML comme IdP. Veuillez consulter la documentation Citrix® StoreFront Cloud pour plus de détails.

REMARQUE

Si vous prévoyez d’utiliser SAML comme IdP, vous devez vous assurer que votre fournisseur SAML est correctement configuré pour prendre en charge l’authentification basée sur Entra. Voir SAML utilisant Microsoft Entra ID et les identités Microsoft Entra pour l’authentification.

Gestion de l’accès à Workspace

Si vos utilisateurs accèdent à leur magasin via un navigateur web, aucune configuration supplémentaire n’est requise. Si vous souhaitez imposer un accès natif, vous pouvez configurer Citrix® StoreFront Cloud pour Require end users to access their store from the Citrix client app sous la configuration d’accès du magasin.

Activation de l’authentification unique Microsoft Entra dans Workspace

Une fois l’authentification configurée, vous devez activer l’utilisation de l’authentification unique Microsoft Entra :

  1. Créer un principal de service dans Citrix Cloud :
    1. Accédez à Gestion des identités et des accès > Accès API > Principaux de service.
    2. Cliquez sur Créer un principal de service.
    3. Saisissez un nom pour le principal de service et cliquez sur Suivant.
    4. Définir l’accès pour le principal de service :
      1. Sélectionnez Accès complet, ou
      2. Sélectionnez Accès personnalisé > Général > Citrix® StoreFront Cloud, puis cliquez sur Suivant.
    5. Définissez l’heure d’expiration du secret et cliquez sur Suivant.
    6. Cliquez sur Terminer.
    7. Enregistrez le secret et l’ID.
  2. Téléchargez et extrayez le module PowerShell Citrix® StoreFront Cloud sur votre poste de travail, ou sur toute machine que vous pouvez utiliser à des fins administratives.
  3. Ouvrez PowerShell sur la machine sur laquelle vous avez téléchargé le module PowerShell Citrix® StoreFront Cloud.
  4. Exécutez les commandes suivantes :

    Import-Module -Name “<extractedPath>\Citrix.Workspace.StoreConfigs.psm1”
    Set-StoreConfigurations -StoreUrl "https://<yourPrimaryStore>.cloud.com" -ClientId "<clientId>" -ClientSecret "<clientSecret>" -AzureAdSsoEnabled $True
    <!--NeedCopy-->
    

    REMARQUE :

    Il s’agit d’un paramètre global qui sera appliqué à tous les magasins de votre locataire Citrix Cloud. Actuellement, il n’est pas possible d’activer ou de désactiver ce paramètre sur des magasins spécifiques en fonction de l’URL du magasin fournie dans la commande.

  5. Exécutez la commande suivante pour vérifier que le paramètre a été configuré correctement :

    Get-StoreConfigurations -StoreUrl "https://<yourPrimaryStore>.cloud.com" -ClientId "<clientId>" -ClientSecret "<clientSecret>"
    <!--NeedCopy-->
    
Configuration du groupe de mise à disposition
  1. Si vos hôtes de session sont joints à Microsoft Entra hybride, attribuez les applications virtuelles et/ou les bureaux aux utilisateurs ou groupes Microsoft Entra appropriés. Toutes les attributions existantes aux utilisateurs ou groupes Active Directory peuvent être supprimées, mais ce n’est pas obligatoire.
  2. Si vous provisionnez vos hôtes de session joints à Microsoft Entra avec autre chose que Citrix Machine Creation Services, Citrix Provisioning ou Windows 365, vous devrez configurer le type d’ouverture de session pour les groupes de mise à disposition. Si vous utilisez des hôtes de session joints à Microsoft Entra hybride, le type d’ouverture de session pour le groupe de mise à disposition doit être configuré quelle que soit la méthode de provisionnement.
    1. Si vous n’avez pas déjà le SDK PowerShell distant Citrix installé, téléchargez-le et installez-le sur votre poste de travail, ou sur toute machine que vous pouvez utiliser à des fins administratives.
    2. Ouvrez une invite PowerShell sur la machine sur laquelle vous avez installé le SDK PowerShell distant Citrix.
    3. Exécutez les commandes suivantes :

      Joint à Microsoft Entra

      asnp citrix*
      Get-XDAuthentication
      Get-BrokerDesktopGroup -Name <dgName> | Set-BrokerDesktopGroup -MachineLogOnType "AzureAd"
      <!--NeedCopy-->
      

      Joint à Microsoft Entra hybride

      asnp citrix*
      Get-XDAuthentication
      Get-BrokerDesktopGroup -Name <dgName> | Set-BrokerDesktopGroup -MachineLogOnType "HybridAzureAd"
      <!--NeedCopy-->
      
Configuration de l’authentification unique Microsoft Entra sur le VDA

Par défaut, l’authentification unique Microsoft Entra est activée sur le VDA. Pour activer ou désactiver cette fonctionnalité pour un sous-ensemble d’hôtes de session, utilisez le paramètre de stratégie d’authentification unique Microsoft Entra.

Appareil client

Assurez-vous que les exigences système pour les appareils clients sont respectées :

  1. Installez la version requise de l’application Citrix Workspace comme spécifié dans les exigences système.
  2. Si vos utilisateurs tireront parti de l’accès hybride, assurez-vous que l’extension Web Citrix est installée. Si vos utilisateurs utiliseront l’accès natif ou par navigateur, l’extension Web Citrix n’est pas nécessaire.

Dépannage

Problèmes connus

  • Après avoir activé l’authentification unique Microsoft Entra, les utilisateurs peuvent rencontrer l’erreur Microsoft AADSTS293005 lors du lancement de leur bureau virtuel, indiquant RDP protocol is not enabled for the requested resource application. Please configure the RemoteDesktopSecurityConfiguration property on resource service principal to enable RDP protocol. Pour résoudre ce problème, redémarrez l’application Citrix Workspace.
  • Les utilisateurs peuvent rencontrer un délai de 30 secondes lors du lancement de sessions si leur application Citrix Workspace ne prend pas en charge l’authentification unique Microsoft Entra ou s’ils utilisent l’accès hybride sans l’extension Web Citrix.
  • Les utilisateurs peuvent rencontrer un délai de 30 secondes lors du lancement de sessions si l’authentification unique Microsoft Entra est activée sur Citrix® StoreFront Cloud et que la configuration Azure requise n’a pas été effectuée.
  • Si le paramètre Authentification de reconnexion automatique du client est activé, l’authentification unique échouera. Pour contourner ce problème, désactivez ce paramètre sur les hôtes de session concernés.
  • Si Rester connecté (KMSI) est désactivé dans Entra ID, l’authentification unique échoue sur les appareils clients Linux et macOS.

Lorsque l’authentification unique échoue

Si l’authentification unique échoue lors de l’accès aux bureaux ou applications virtuels, procédez comme suit :

  1. Confirmez que l’authentification unique Microsoft Entra est activée dans Citrix® StoreFront Cloud.

  2. Confirmez que la méthode d’accès utilisée par l’utilisateur est prise en charge.

  3. Si l’utilisateur utilise l’accès hybride, confirmez que l’extension web Citrix est installée.

  4. Confirmez que le périphérique client exécute la version requise de l’application Citrix Workspace.

  5. Confirmez que vos hôtes de session exécutent la version de Windows requise.

  6. Confirmez que vos hôtes de session exécutent la version de VDA requise.

  7. Assurez-vous que le paramètre Windows Always prompt for password upon connection n’est pas activé sur les hôtes de session.

    Ce paramètre est désactivé par défaut et peut être configuré via une stratégie de groupe ou Intune sous Computer Configuration\Administrative Templates\Windows Components\Remote Desktop Services\Remote Desktop Session Host\Security.

    Vous pouvez vérifier dans le registre si le paramètre est activé en recherchant la valeur fPromptForPassword sous HKLM\SOFTWARE\Policies\Microsoft\Windows NT\Terminal Services. Si la valeur est définie sur 1, le paramètre est activé et l’authentification unique ne sera pas disponible. Si la valeur est manquante ou définie sur 0, le paramètre est désactivé.

  8. Assurez-vous que le paramètre Windows Allow Custom SSPs and APs to be loaded into LSASS est activé sur les hôtes de session. Ce paramètre est activé par défaut et peut être configuré via une stratégie de groupe ou Intune sous Computer Configuration\System\Local Security Authority.

  9. Confirmez que le paramètre AzureADJoinType est configuré correctement sur les hôtes de session :
    • Clé : HKLM\SYSTEM\CurrentControlSet\Control\Citrix
    • Type de valeur : DWORD
    • Nom de la valeur : AzureADJoinType
    • Données de valeur : 1 (joint à Microsoft Entra hybride) ; 2 (joint à Microsoft Entra)
  10. Assurez-vous que les bureaux virtuels ou les applications sont attribués à des identités Microsoft Entra au lieu d’identités Active Directory dans Citrix Studio.

  11. Confirmez que le type de connexion des groupes de mise à disposition est configuré correctement en exécutant la commande PowerShell suivante :

    Get-BrokerDesktopGroup -Name <deliveryGroupName>
    <!--NeedCopy-->
    

    Pour les hôtes de session joints à Microsoft Entra, MachineLogOnType doit être défini sur AzureAd. Pour les hôtes de session joints à Microsoft Entra hybride, MachineLogOnType doit être défini sur HybridAzureAd.

  12. Si vous utilisez un IdP SAML, confirmez que la configuration nécessaire a été implémentée.

  13. Confirmez que les applications Citrix Resource et Client sont enregistrées dans le locataire Microsoft Entra.

  14. Confirmez que le protocole d’authentification RDS Microsoft Entra ID est activé sur l’application Citrix Resource.

  15. Confirmez que l’application Citrix Client a été ajoutée en tant qu’application cliente approuvée dans l’application Citrix Resource.

  16. Si vos hôtes de session sont joints à Microsoft Entra hybride, confirmez qu’un objet serveur Kerberos a été créé dans le domaine Active Directory où résident les comptes d’utilisateur et d’ordinateur.

  17. Examinez vos stratégies d’accès conditionnel Microsoft Entra. Assurez-vous qu’aucune stratégie n’est appliquée à l’application Citrix Client et que toutes les stratégies appliquées à l’application Citrix Resource ou aux hôtes de session sont configurées correctement afin qu’elles n’affectent pas l’expérience d’authentification unique.
Authentification unique Microsoft Entra