Vous pouvez configurer le correctif cumulatif 3 d'Active Directory Federation Services (AD FS) 2.0 et AD FS 3.0 sur le système d'exploitation Microsoft Windows Server en tant que fournisseur d'identités pour les identifiants de connexion d'entreprise dans Portal for ArcGIS. Le processus de configuration comporte deux étapes principales : l'enregistrement du fournisseur d'identités d'entreprise auprès de Portal for ArcGIS et l'enregistrement de Portal for ArcGIS auprès du fournisseur d'identités d'entreprise.
Informations requises
Portal for ArcGIS requiert la réception de certaines informations attributaires de la part du fournisseur d'identités lorsqu'un utilisateur se connecte à l'aide d'identifiants d'entreprise. L'attribut NameID est obligatoire. Il doit être envoyé par votre fournisseur d'identités dans la réponse SAML afin que la fédération fonctionne avec Portal for ArcGIS. Puisqu’Portal for ArcGIS utilise la valeur de NameID pour identifier de manière unique un utilisateur nommé, il est recommandé d’utiliser une valeur constante qui identifie l’utilisateur de manière unique. Lorsqu'un utilisateur IDP se connecte, un nouvel utilisateur nommé NameID est créé par Portal for ArcGIS dans son magasin d'utilisateurs. Les caractères autorisés pour la valeur envoyée par l’attribut NameID sont les caractères alphanumériques, le trait de soulignement (_), (le point) et @ (le symbole arobase). Tous les autres caractères seront désactivés pour contenir des traits de soulignement dans le nom d'utilisateur créé par Portal for ArcGIS.
Portal for ArcGIS prend en charge le flux des attributs givenName et email address de l'identifiant de connexion d'entreprise provenant du fournisseur d'identités d'entreprise. Lorsqu'un utilisateur se connecte à l'aide des informations de connexion d'entreprise et si Portal for ArcGIS reçoit des attributs avec les noms givenname et email ou mail (quelle que soit la casse), Portal for ArcGIS renseigne le nom complet et l'adresse électronique du compte de l'utilisateur avec les valeurs reçues de la part du fournisseur d'identités. Il est conseillé de transmettre l'adresse électronique (email address) reçue du fournisseur d'identités d'entreprise afin que l'utilisateur puisse recevoir les notifications.
Enregistrer AD FS en tant que fournisseur d'identités d'entreprise auprès de Portal for ArcGIS
Connectez-vous au site web du portail en tant qu'administrateur de votre organisation et cliquez sur Organisation > Modifier les paramètres > Sécurité.
Dans la section Enterprise Logins (Identifiant de connexion d'entreprise), sélectionnez l’option One Identity Provider (Un fournisseur d’identités), cliquez sur le bouton Set Enterprise Login (Définir l’Identifiant de connexion d'entreprise) et saisissez le nom de votre organisation dans la fenêtre qui apparaît (par exemple, City of Redlands). Lorsque les utilisateurs accèdent au site web du portail, ce texte est intégré dans le nom de l'option de connexion SAML (par exemple, Utilisation de votre compte Ville de Redlands).
Indiquez si vos utilisateurs peuvent rejoindre l'organisation automatiquement ou après l'ajout des comptes au portail. Sélectionnez la première option pour permettre aux utilisateurs de se connecter à l'organisation avec leur identifiant de connexion d'entreprise sans intervention de l'administrateur. Leur compte est automatiquement enregistré auprès de l'organisation lors de leur première connexion. La seconde option suppose que l'administrateur enregistre les comptes nécessaires auprès de l'organisation à l'aide d'un utilitaire de ligne de commande ou d'un exemple de script Python. Une fois les comptes enregistrés, les utilisateurs peuvent se connecter à l'organisation.
Astuce:
Nous vous recommandons de désigner au moins un compte d'entreprise pour administrer votre portail et de rétrograder ou de supprimer le compte d'administrateur initial. Nous vous conseillons également de désactiver le bouton Créer un compte et la page de connexion (signup.html) sur le site web du portail pour empêcher les utilisateurs de créer leurs propres comptes. Pour obtenir des instructions complètes, reportez-vous à la rubrique Configuration d'un fournisseur d'identités compatible avec SAML avec votre portail.
Indiquez des informations de métadonnées concernant le fournisseur d'identités à l'aide d'une des options ci-dessous :
URL : si l'URL des métadonnées de la fédération AD FS est accessible, sélectionnez cette option et entrez l'URL (par exemple, https://<adfs-server>/federationmetadata/2007-06/federationmetadata.xml).
Remarque :
Si votre fournisseur d'identités d'entreprise inclut un certificat auto-signé, vous pouvez rencontrer une erreur en essayant de spécifier l'URL HTTPS des métadonnées. Cela se produit parce que Portal for ArcGIS ne peut pas vérifier le certificat auto-signé du fournisseur d'identités. Vous pouvez également utiliser HTTP dans l'URL, une des autres options ci-dessous ou configurer votre fournisseur d'identités avec un certificat approuvé.
Fichier : sélectionnez cette option si l'URL n'est pas accessible. Téléchargez ou obtenez une copie du fichier de métadonnées de la fédération auprès d'AD FS et téléchargez le fichier vers Portal for ArcGIS via l'option Fichier.
Paramètres : sélectionnez cette option si l'URL ou le fichier de métadonnées de la fédération n'est pas accessible. Entrez les valeurs manuellement et fournissez les paramètres demandés : l’URL de connexion et le certificat, chiffrés au format BASE 64. Contactez votre administrateur AD FS pour les connaître.
Configurez les paramètres avancés comme il convient :
Chiffrer l'assertion : sélectionnez cette option pour chiffrer les réponses d'assertion SAML d'AD FS.
Activer la demande signée : sélectionnez cette option pour que Portal for ArcGIS signe la demande d'authentification SAML envoyée à AD FS.
Propager la déconnexion au fournisseur d'identités : sélectionnez cette option pour que Portal for ArcGIS utilise une URL de déconnexion pour déconnecter l'utilisateur d'AD FS. Indiquez l'URL à utiliser dans le paramètre URL de déconnexion. Si le fournisseur d'identités exige que l'URL de déconnexion soit signée, vous devez sélectionner l'option Activer la demande signée.
Remarque :
Puisque, par défaut, AD FS exige que les demandes de déconnexion soient signées avec la fonction de hachage SHA-256, vous devez sélectionner les options Activer la demande signée et Ouvrir une session avec SHA256.
Update profiles on sign in (Mettre à jour les profils lors de la connexion) : sélectionnez cette option afin que Portal for ArcGISmette à jour les attributs givenName et email address des utilisateurs si ces attributs ont changé depuis la dernière fois que les utilisateurs se sont connectés.
Enable SAML based group membership (Activer l’adhésion au groupe SAML) : sélectionnez cette option pour autoriser les membres de l’organisation à relier des groupes d’entreprises SAML spécifiés à des groupes Portal for ArcGIS pendant le processus de création de groupe.
URL de déconnexion : l'URL du fournisseur d'identités à utiliser pour déconnecter l'utilisateur actuellement connecté.
ID d'entité : mettez cette valeur à jour pour utiliser un nouvel ID d'entité qui identifie de manière unique votre portail auprès d'AD FS.
Les paramètres Chiffrer l'assertion et Activer la demande signée utilisent le certificat samlcert dans le KeyStore du portail. Pour utiliser un nouveau certificat, supprimez le certificat samlcert, créez un nouveau certificat avec le même alias (samlcert) en suivant la procédure indiquée dans la rubrique Importer un certificat dans le portail, puis redémarrez le portail.
Enregistrer Portal for ArcGIS en tant que fournisseur de services approuvé auprès d'AD FS
Ouvrez la Console de gestion AD FS.
Choisissez Relying Party Trusts (approbations des parties de confiance) > Add Relying Party Trust (ajouter une approbation de la partie de confiance).
Dans l'Assistant Add Relying Party Trust (ajout d'une approbation de la partie de confiance), cliquez sur le bouton Start (démarrer).
Dans Select Data Source (Sélectionner la source de données), choisissez une option d'obtention des données concernant la partie de confiance : importation à partir d'une URL, importation à partir d'un fichier ou saisie manuelle. Les options d'URL et de fichier nécessitent que vous obteniez les métadonnées auprès de votre organisation. Si vous n'avez pas accès à l'URL ou au fichier de métadonnées, vous pouvez saisir ces informations manuellement. Dans certains cas, la saisie manuelle de données peut être l'option la plus facile.
Importer des données concernant la partie de confiance publiées en ligne ou sur un réseau local
Cette option utilise les métadonnées de l'URL de votre organisation Portal for ArcGIS. L'URL est https://webadaptorhost.domain.com/webadaptorname/sharing/rest/portals/self/sp/metadata?token=<token>, par exemple, https://samltest.domain.com/arcgis/sharing/rest/portals/self/sp/metadata?token=G6943LMReKj_kqdAVrAiPbpRloAfE1fqp0eVAJ-IChQcV-kv3gW-gBAzWztBEdFY. Vous pouvez générer un jeton avec https://webadaptorhost.domain.com/webadaptorname/sharing/rest/generateToken. Lorsque vous saisissez l'URL sur la page
Générer un jeton, indiquez le nom de domaine complet du serveur AD FS dans le champ URL de l'application web. Ne sélectionnez pas d'autre option, telle que Adresse IP ou Adresse IP de l'origine de cette requête, au risque de générer un jeton incorrect.
Remarque :
La partie arcgis de l'URL d'exemple ci-dessus est le nom par défaut de l'adaptateur web. Si le nom de votre adaptateur Web est différent de arcgis, remplacez cette partie de l'URL par le nom de votre adaptateur Web.
Importer des données concernant la partie de confiance à partir d'un fichier
Cette option utilise un fichier metadata.xml provenant de votre organisation Portal for ArcGIS. Vous pouvez obtenir un fichier XML de métadonnées de deux manières :
Dans la section Sécurité de la page Modifier les paramètres de votre organisation, cliquez sur le bouton Obtenir un fournisseur de services. Vous obtenez ainsi les métadonnées de votre organisation, que vous pouvez enregistrer au format XML sur votre ordinateur.
Ouvrez l'URL des métadonnées de votre organisation Portal for ArcGIS et enregistrez-la sous forme de fichier XML sur votre ordinateur. L'URL est https://webadaptorhost.domain.com/webadaptorname/sharing/rest/portals/self/sp/metadata?token=<token>, par exemple, https://samltest.domain.com/arcgis/sharing/rest/portals/self/sp/metadata?token=G6943LMReKj_kqdAVrAiPbpRloAfE1fqp0eVAJ-IChQcV-kv3gW-gBAzWztBEdFY. Vous pouvez générer un jeton avec https://webadaptorhost.domain.com/webadaptorname/sharing/rest/generateToken. Lorsque vous saisissez l'URL sur la page
Générer un jeton, indiquez le nom de domaine complet du serveur AD FS dans le champ URL de l'application web. Ne sélectionnez pas d'autre option, telle que Adresse IP ou Adresse IP de l'origine de cette requête, au risque de générer un jeton incorrect.
Remarque :
La partie arcgis des URL d'exemple ci-dessus est le nom par défaut de l'adaptateur web. Si le nom de votre adaptateur Web est différent de arcgis, remplacez cette partie de l'URL par le nom de votre adaptateur Web.
Entrer manuellement des données concernant la partie de confiance
Avec cette option, l'Assistant d'ajout d'une approbation de la partie de confiance présente des fenêtres supplémentaires dans lesquelles vous pouvez saisir manuellement les données. Ces fenêtres font l'objet d'une explication dans les étapes 6 à 8 ci-dessous.
Pour Specify Display Name (spécifier le nom complet), entrez le nom complet.
Le nom complet permet d'identifier la partie de confiance dans AD FS. Il n'a aucune signification en dehors de ce contexte. Il doit être défini sur ArcGIS ou sur le nom de l'organisation au sein d'ArcGIS, par exemple, ArcGIS—SamlTest.
Astuce:
l'image ci-dessus présente la fenêtre Specify Display Name avec les étapes d'importation de la source de données à partir d'une URL ou d'un fichier. Si vous avez opté pour la saisie manuelle des informations sur la source de données, des étapes supplémentaires apparaissent dans la partie gauche de l'assistant. Elles font l'objet d'une explication dans les étapes 6 à 8 ci-dessous. Si vous avez sélectionné une URL ou un fichier, vous pouvez passer à l'étape 9.
(Source de données manuelle uniquement) Pour Choix d'un profil, sélectionnez Profil AD FS 2.0 (ou une version AD FS ultérieure si cela est approprié à votre environnement).
(Source de données manuelle uniquement) Pour Configure URL (Configurer l'URL), cochez la case Enable support for the SAML 2.0 webSSO protocol (Activer la prise en charge du protocole webSSO SAML 2.0) et entrez l'URL du service SSO SAML 2.0 de la partie de confiance.
L'URL de la partie de confiance doit être l'URL à laquelle AD FS envoie la réponse SAML après l'authentification de l'utilisateur. Il doit s'agir d'une URL HTTPS : https://webadaptorhost.domain.com/webadaptorname/sharing/rest/oauth2/saml/signin.
Remarque :
La partie arcgis de l'URL d'exemple ci-dessus est le nom par défaut de l'adaptateur web. Si le nom de votre adaptateur Web est différent de arcgis, remplacez cette partie de l'URL par le nom de votre adaptateur Web.
(Source de données manuelle uniquement) Pour Configure Identifiers (configurer les identifiants), saisissez l'URL de l'identifiant de l'approbation de la partie de confiance.
Ce doit être portal.domain.com.arcgis.
Pour Choose Issuance Authorization Rules (choisir les règles d'autorisation d'émission), sélectionnez Permit all users to access this relying party (autoriser tous les utilisateurs à accéder à cette partie de confiance).
Astuce:
l'image ci-dessus présente la fenêtre Choose Issuance Authorization Rules avec les étapes d'importation de la source de données à partir d'une URL ou d'un fichier. Si vous avez opté pour la saisie manuelle des informations sur la source de données, des étapes supplémentaires apparaissent sur la gauche de l'assistant.
Dans la zone Ready to Add Trust (Prêt pour l'ajout d'une approbation), examinez tous les paramètres de la partie de confiance. L'URL des métadonnées est renseignée uniquement si vous avez choisi d'importer la source de données à partir d'une URL. L'image ci-dessous montre la fenêtre Ready to Add Trust si vous avez choisi de saisir manuellement les informations sur la source de données. (Prêt pour l'ajout d'une approbation)
Cliquez sur Next (Suivant).
Astuce:
Si l'option Monitor relying party (Surveiller la partie de confiance) est activée, AD FS vérifie régulièrement l'URL des métadonnées de fédération et la compare à l'état actuel de l'approbation de la partie de confiance. Cependant, la surveillance échoue lorsque le jeton dans l'URL des métadonnées de fédération expire. Les échecs sont consignés dans le journal des événements AD FS. Pour supprimer ces messages, il est conseillé de désactiver la surveillance ou de mettre à jour le jeton.
Pour Finish (terminer), cochez la case afin d'ouvrir automatiquement la boîte de dialogue Edit Claim Rules (modifier les règles de revendication) après avoir cliqué sur le bouton Close (fermer).
Astuce:
l'image ci-dessus présente la fenêtre Finish avec les étapes d'importation de la source de données à partir d'une URL ou d'un fichier. Si vous avez opté pour la saisie manuelle des informations sur la source de données, des étapes supplémentaires apparaissent sur la gauche de l'assistant.
Pour définir les règles de revendication, ouvrez l'assistant Edit Claim Rules (Modifier les règles de revendication) et cliquez sur Add Rule (ajouter une règle).
Dans Select Rule Template (sélectionner un modèle de règle), sélectionnez le modèle Send LDAP Attributes as Claims (envoyer les attributs LDAP sous forme de revendications) pour la règle de revendication que vous voulez créer, puis cliquez sur Next (suivant). (choisir un type de règle)
Dans Configure Claim Rule (Configurer la règle de revendication), donnez un nom à la règle, par exemple, DefaultClaims.
Pour Attribute store (magasin d'attributs), sélectionnez Active Directory.
Pour Mapping of LDAP attributes to outgoing claim types (mappage des attributs LDAP avec les types de revendications sortantes), sélectionnez l'attribut LDAP contenant les noms d'utilisateurs (par exemple, SAM-Account-Name) pour LDAP Attribute (attribut LDAP) et NameID pour Outgoing Claim Type (type de revendication sortante).
Remarque :
NameID est l'attribut qui doit être envoyé par AD FS dans la réponse SAML afin que la fédération fonctionne avec ArcGIS. Lorsqu'un utilisateur IDP se connecte, un nouvel utilisateur nommé NameID est créé par Portal for ArcGIS dans son magasin d'utilisateurs. Les caractères autorisés pour la valeur envoyée par l'attribut NameID sont les caractères alphanumériques et le trait de soulignement (_). (le point) et @ (le symbole arobase). Tous les autres caractères seront désactivés pour contenir des traits de soulignement dans le nom d'utilisateur créé par Portal for ArcGIS.
givenNamePortal for ArcGIS prend en charge le flux des attributs email address et group de l’identifiant de connexion d’entreprise provenant du fournisseur d’identités d’entreprise. Lorsqu'un utilisateur se connecte à l'aide des informations de connexion d'entreprise et si Portal for ArcGIS reçoit des attributs avec les noms givenname et email ou mail (quelle que soit la casse), Portal for ArcGIS renseigne le nom complet et l'adresse électronique du compte de l'utilisateur avec les valeurs reçues de la part du fournisseur d'identités. Si vous avez sélectionné l’option Enable SAML based group membership (Activer l’adhésion au groupe SAML) lors de l’enregistrement d’AD FS comme fournisseur d’identités d’entreprise, l’adhésion pour chaque utilisateur est obtenue via la réponse d’assertion SAML reçue du fournisseur d’identités chaque fois que l’utilisateur se connecte avec succès.
Suivez les instructions ci-après pour modifier les règles de revendication.
Dans la colonne Attribut LDAP, sélectionnez Nom complet (ou un attribut différent dans la liste sur la deuxième ligne) et faites-le correspondre au Nom donné dans la colonne Type de revendication sortante.
Dans la colonne LDAP Attribute (Attribut LDAP), sélectionnez l’option E-Mail-Addresses (Adresses électroniques) et faites-la correspondre à l’Adresse électronique (E-Mail Address) dans la colonne Outgoing Claim Type (Type de revendication sortante).
Dans la colonne LDAP Attribute (Attribut LDAP), sélectionnez l’option Token-Groups - Qualified by Domain Name (Jeton-groupes - Qualifié par nom de domaine) et faites-la correspondre au Groupe (Group) dans la colonne Outgoing Claim Type (Type de revendication sortante).
Avec cette revendication, AD FS envoie les attributs portant les noms givenname et email à Portal for ArcGIS après avoir authentifié l’utilisateur. Portal for ArcGIS utilise ensuite les valeurs reçues dans les attributs givenname et email pour indiquer le nom complet et l’adresse électronique du compte utilisateur. Les valeurs dans l’attribut de groupe sont utilisées pour mettre à jour l’adhésion de l’utilisateur au groupe. Pour obtenir des informations sur la liaison de groupes d’entreprises, reportez-vous à la rubrique Création de groupes.
Il est conseillé de transmettre l'adresse électronique reçue du fournisseur d'identités d'entreprise à Portal for ArcGIS. Cela peut s'avérer utile si l'utilisateur devient plus tard administrateur. Le fait d'avoir une adresse électronique dans le compte autorise l'utilisateur à recevoir des notifications concernant les activités administratives et à envoyer des invitations à d'autres utilisateurs pour rejoindre l'organisation.
Cliquez sur Terminer pour terminer la configuration du fournisseur d'identités AD FS visant à inclure Portal for ArcGIS comme partie de confiance.
