Configurer ADFS en tant que fournisseur SAML pour l’authentification du magasin
Cet article décrit comment configurer l’approbation de partie de confiance requise par Citrix Cloud™ pour se connecter aux magasins ou à Citrix Cloud à l’aide de SAML.
Après avoir terminé les étapes de cet article, vous pouvez configurer la connexion SAML entre votre serveur ADFS et Citrix Cloud comme décrit dans Connecter SAML en tant que fournisseur d’identité dans Citrix Cloud. Pour obtenir des conseils sur la saisie des valeurs ADFS correctes pour votre connexion SAML, consultez Configuration SAML dans Citrix Cloud dans cet article.
Prérequis
Les instructions de cet article supposent que vous disposez d’un déploiement de serveur ADFS opérationnel avec Citrix FAS dans votre environnement. Citrix FAS est requis pour fournir l’authentification unique aux VDA lors du lancement de session.
Pour plus d’informations, reportez-vous aux articles suivants :
- Documentation Citrix FAS :
- Citrix Tech Zone : Architecture de référence : service d’authentification fédérée
Configurer une approbation de partie de confiance pour Citrix Cloud
- Depuis la console de gestion AD FS, développez le nœud AD FS dans le volet gauche.
-
Cliquez avec le bouton droit sur Approbation de partie de confiance et sélectionnez Ajouter une approbation de partie de confiance.

L’assistant Ajouter une approbation de partie de confiance apparaît.
-
Sélectionnez Prise en charge des revendications, puis sélectionnez Suivant.
Assistant d’approbation ADFS avec l’option Prise en charge des revendications sélectionnée(/fr-fr/citrix-cloud/media/saml-adfs-trust-wizard-claims-aware-option.png)
-
Dans Adresse des métadonnées de fédération, saisissez
https://saml.cloud.com/saml/metadata.xml. Sélectionnez Suivant.Assistant d’approbation ADFS avec l’adresse des métadonnées de fédération saisie(/fr-fr/citrix-cloud/media/saml-adfs-trust-wizard-federation-metadata-address.png)
-
Pour le nom d’affichage, saisissez
CitrixCloudProd. Sélectionnez Suivant.Assistant d’approbation ADFS avec le nom d’affichage saisi(/fr-fr/citrix-cloud/media/saml-adfs-trust-wizard-display-name.png)
-
Pour la stratégie de contrôle d’accès, sélectionnez Autoriser tout le monde. Sélectionnez Suivant.
Assistant d’approbation ADFS avec la stratégie de contrôle d’accès mise en surbrillance(/fr-fr/citrix-cloud/media/saml-adfs-trust-wizard-access-control-policy.png)
- Sur l’écran Prêt à ajouter l’approbation, sélectionnez Suivant.
-
Sur l’écran Terminer, sélectionnez Configurer la stratégie d’émission de revendications pour cette application. Sélectionnez Suivant.
Console ADFS avec l’option de menu Modifier la stratégie d’émission de revendications sélectionnée(/fr-fr/citrix-cloud/media/saml-adfs-edit-claim-issuance-policy.png)
- Cliquez avec le bouton droit sur l’approbation de partie de confiance nouvellement créée et sélectionnez Modifier la stratégie d’émission de revendications.
- Cliquez sur Ajouter une règle, puis sélectionnez Envoyer les attributs LDAP en tant que revendications. Sélectionnez Suivant.
- Dans Nom de la règle de revendication, saisissez
CitrixCloud. - Dans Magasin d’attributs, sélectionnez Active Directory.
-
Sous Mappage des attributs LDAP aux types de revendication sortants, ajoutez les attributs LDAP suivants, exactement comme indiqué :
Attribut LDAP Type de revendication sortant User-Principal-Name Name ID User-Principal-Name cip_upn Display-Name displayName Given-Name givenName Surname familyName Important :
Le NameID doit toujours être la première revendication ajoutée à la liste des revendications, sinon la déconnexion unique (SLO) ne fonctionnera pas correctement.

-
Sélectionnez Terminer.
-
Cliquez avec le bouton droit sur la confiance de partie de confiance nouvellement créée appelée « CitrixCloudProd » et sélectionnez propriétés.
-
Sélectionnez l’onglet Points de terminaison et cliquez sur Ajouter SAML.
-
Sélectionnez Déconnexion SAML dans la liste déroulante du type de point de terminaison.
-
Sélectionnez POST dans la liste déroulante de liaison.
-
Saisissez
https://saml.cloud.com/saml/logout/callback>dans les champs URL approuvée : et URL de réponse :
- Cliquez sur OK et Appliquer.
Modifier une approbation de partie de confiance Citrix Cloud à l’aide de PowerShell
Si vous avez configuré votre serveur ADFS à l’aide de la configuration par défaut « prête à l’emploi », les étapes de cette section vous permettent de la mettre à jour afin qu’elle réponde à la configuration recommandée par Citrix. Cette tâche est nécessaire pour résoudre un problème où la déconnexion unique SAML de Citrix Cloud ou du magasin échoue si l’attribut nameidentifier n’est pas inclus dans l’ensemble de règles de revendication ou n’est pas le premier attribut SAML de l’ensemble de règles de revendication.
Remarque :
Vous n’avez pas besoin d’effectuer cette tâche si vous avez créé votre ensemble de règles de revendication en suivant les étapes de Configurer une approbation de partie de confiance pour Citrix Cloud dans cet article.
Pour effectuer cette tâche, vous remplacez l’ensemble de règles existant par un nouvel ensemble de règles de revendication à l’aide de PowerShell. La console de gestion ADFS ne prend pas en charge ce type d’opération.
- Sur le serveur ADFS, recherchez le PowerShell ISE. Cliquez avec le bouton droit et sélectionnez Exécuter en tant qu’administrateur.
-
Sauvegardez vos règles de revendication ADFS existantes dans un fichier texte :
Get-ADFSRelyingPartyTrust -name "CitrixCloudProd" | Select-Object -ExpandProperty IssuanceTransformRules | Out-File "$env:USERPROFILE\desktop\claimrulesbackup.txt" <!--NeedCopy--> - Téléchargez le fichier claimrules.txt fourni par Citrix à l’adresse https://github.com/citrix/sample-scripts/tree/master/citrix-cloud.
- Copiez le fichier claimrules.txt sur votre bureau.
-
Importez les règles de revendication requises à l’aide du fichier claimrules.txt :
Set-ADFSRelyingPartyTrust -Name "CitrixCloudProd" ` -MetadataUrl "https://saml.cloud.com/saml/metadata" ` -AutoUpdateEnabled $True ` -IssuanceTransformRulesFile "$env:USERPROFILE\desktop\claimrules.txt" ` -SignedSamlRequestsRequired $True ` -SamlResponseSignature "MessageAndAssertion" ` -Enabled $True <!--NeedCopy-->
Mettre à jour les paramètres de signature SAML pour l’approbation de partie de confiance à l’aide de PowerShell
Par défaut, les approbations de partie de confiance ADFS ont les paramètres suivants :
- EncryptClaims: True
- SignedSamlRequestsRequired: False
- SamlResponseSignature: AssertionOnly
Pour une sécurité accrue, Citrix recommande d’utiliser des requêtes SAML signées pour l’authentification unique (SSO) et la déconnexion unique. Cette section explique comment mettre à jour les paramètres de signature d’une approbation de partie de confiance existante à l’aide de PowerShell afin qu’ils correspondent à la configuration recommandée par Citrix.
-
Obtenez la configuration actuelle de RelyingPartyTrust sur votre serveur ADFS.
Get-ADFSRelyingPartyTrust -TargetName "CitrixCloudProd" <!--NeedCopy--> -
Mettez à jour les paramètres d’approbation de partie de confiance CitrixCloudProd.
Set-ADFSRelyingPartyTrust -Name "CitrixCloudProd" ` -SignedSamlRequestsRequired $True ` -SamlResponseSignature "MessageAndAssertion" <!--NeedCopy-->
Configuration SAML dans Citrix Cloud
Lorsque vous configurez la connexion SAML dans Citrix Cloud (comme décrit dans Ajouter les métadonnées du fournisseur SAML à Citrix Cloud), vous saisirez les valeurs pour ADFS comme suit :
Utilisez les valeurs par défaut recommandées pour la connexion SAML dans Gestion des identités et des accès > Authentification > Ajouter un fournisseur d’identité > SAML.
| Dans ce champ de Citrix Cloud | Saisissez cette valeur |
|---|---|
| ID d’entité |
https://adfs.YourDomain.com/adfs/services/trust, où YourDomain.com est le domaine de votre serveur ADFS. |
| Signer la demande d’authentification | Oui |
| URL du service SSO |
https://adfs.YourDomain.com/adfs/ls, où YourDomain.com est le domaine de votre serveur ADFS. |
| Mécanisme de liaison SSO | HTTP Post |
| Réponse SAML | Signer la réponse ou l’assertion |
| Contexte d’authentification | Non spécifié, Exact |
| URL de déconnexion |
https://adfs.YourDomain.com/adfs/ls, où YourDomain.com est le domaine de votre serveur ADFS. |
| Signature de la demande de déconnexion | Oui |
| Mécanisme de liaison SLO | HTTP Post |
Exportez le certificat de signature ADFS depuis la console de gestion ADFS MMC. Consultez la capture d’écran ci-dessous pour savoir lequel des 3 certificats est le bon à télécharger dans Citrix Cloud dans le cadre de la connexion SAML.

Dans cet article
- Prérequis
- Configurer une approbation de partie de confiance pour Citrix Cloud
- Modifier une approbation de partie de confiance Citrix Cloud à l’aide de PowerShell
- Mettre à jour les paramètres de signature SAML pour l’approbation de partie de confiance à l’aide de PowerShell
- Configuration SAML dans Citrix Cloud