Guide de configuration de l'authentification unique SAML ASP.NET Framework avec ADFS comme fournisseur d'identité

Pré-requis : Téléchargement Et Installation

A] Installation de NuGet :

• Connectez-vous à http://portal.miniorange.com/ et naviguer vers le Télécharger onglet. À partir de là, repérez votre plugin acheté et cliquez sur Télécharger le plugin pour télécharger le fichier zip du plugin.

• Extrayez le fichier zip téléchargé sur votre machine et placez le fichier de package NuGet (.nupkg) dans un dossier tel que « C:\miniOrangePackages ».
• Exécutez la commande suivante dans votre terminal VS pour l'ajouter comme source de paquet :

• Ouvrez votre projet dans le terminal :

• Installez le package dans votre projet à l'aide de la commande ci-dessous :

OR

• Après avoir placé le package NuGet (fichier .nupkg) dans un dossier local, au lieu d'utiliser le terminal, vous pouvez également l'installer à l'aide de Visual Studio en suivant les étapes ci-dessous :
• Ouvrez votre application .NET dans Visual Studio, cliquez sur Outils dans la barre de navigation supérieure, puis accédez à Gestionnaire de packages NuGet → Gérer les packages NuGet pour la solution.

• Une nouvelle fenêtre s'ouvrira ; cliquez sur le icône engrenage à côté du menu déroulant Source du package.

• Une fenêtre contextuelle s'ouvrira ; sélectionnez Sources des paquets Dans le panneau de navigation de gauche, cliquez sur le plus (+) icône, entrez un Le nom Pour la source du package, indiquez le chemin d'accès au dossier où vous avez placé le package NuGet. Matériau champ, puis cliquez sur Mises à jour et enfin cliquez OK pour enregistrer les modifications, comme indiqué sur l'image.

• Après avoir fermé la fenêtre contextuelle, sélectionnez la source du package nouvellement ajoutée dans le Source du paquet menu déroulant.

• Maintenant, cliquez sur le Explorer onglet, recherchez miniOrange.SAML.SSOSélectionnez le package dans les résultats, puis cliquez sur Installer.

B] Installation manuelle :

• Extrayez le package téléchargé du portail miniOrange. Il contient un Installation manuelle dossier avec miniorange-saml-sso.dll et d'autres fichiers DLL qui doivent être placés dans le répertoire de votre application coffre dossier.
• Placez le saml.config fichier et le miniOrangeContent dossier situé à la racine de votre application.
• Enregistrez le module miniOrange dans votre web.config en suivant les étapes décrites dans le intégration.md.

Accédez au tableau de bord du module

• Après l'installation, ouvrez votre navigateur et parcourez le tableau de bord du module avec l'URL ci-dessous :
  

 http(s)<your-dotnet-application-base-url>?ssoaction=config


• Si la page de connexion s'affiche, vous avez correctement ajouté le module SSO SAML miniOrange à votre application.

• Connectez-vous avec votre compte miniOrange sous licence pour configurer le module.
• Après vous être connecté, le Configuration du compte Le tableau de bord s'ouvrira. Saisissez la clé de licence pour activer l'extension ; vous la recevrez après vous être connecté(e). portail.miniorange.com et naviguer vers Gérer les licences → Clés de licence.

• Ensuite, cochez la case « J'ai lu les deux conditions ci-dessus et je souhaite activer le plugin. », Et cliquez sur le Activer la licence .

A] Utilisation de l'URL de métadonnées SAML ou du fichier de métadonnées

• Dans l' Menu Paramètres du plugin, chercher Paramètres du fournisseur de services. En dessous, vous pouvez trouver l'URL des métadonnées ainsi que la possibilité de télécharger les métadonnées SAML.

• Copiez l'URL des métadonnées ou téléchargez le fichier de métadonnées pour le configurer du côté de votre fournisseur d'identité.

• Vous pouvez vous référer à la capture d'écran ci-dessous :

B] Téléchargement manuel des métadonnées

• Extrait du Paramètres du fournisseur de services Dans cette section, vous pouvez copier manuellement les métadonnées du fournisseur de services, comme ID d'entité SP, URL ACS, URL de déconnexion uniqueet partagez-le avec votre fournisseur d'identité pour la configuration.
• Vous pouvez également télécharger le certificat SP en cliquant sur Télécharger SP Cert et fournissez-le à votre fournisseur d'identité si nécessaire.
• En vertu des Normes sur l’information et les communications, les organismes doivent rendre leurs sites et applications Web accessibles. Ils y parviennent en conformant leurs sites Web au niveau AA des Web Content Accessibility Guidelines (WCAG). Certificat de cryptage Dans cette section, sélectionnez le type de certificat approprié en fonction de vos besoins.
• Après avoir effectué les étapes ci-dessus, cliquez sur Enregistrer pour appliquer la configuration.

• Vous pouvez vous référer à la capture d'écran ci-dessous :

Étapes de configuration du fournisseur d'identité ADFS

• Tout d'abord, recherchez Gestion ADFS application sur votre serveur ADFS.

• Dans Gestion ADFS, sélectionnez Confiance de la partie de confiance et cliquez sur Ajouter une approbation de partie de confiance.

• Sélectionner Revendications conscientes à partir de l'assistant de confiance de partie de confiance et cliquez sur Commencer .

Sélectionnez la source de données

• Dans Sélectionner une source de données, sélectionnez la source de données pour ajouter une approbation de partie de confiance.

• URL de métadonnées
• Fichier XML de métadonnées
• Configuration manuelle

• Accédez à Métadonnées du fournisseur de services section du module ASP.NET SAML et copiez le URL de métadonnées.
• Sélectionner Importer des données sur la partie utilisatrice publiées en ligne ou sur le réseau local option, et ajoutez l'URL des métadonnées (à partir de Étape 1a) dans le champ d'adresse des métadonnées de la Fédération.
• Cliquez sur Suivant.

• Accédez à Métadonnées du fournisseur de services section du module ASP.NET SAML et cliquez sur le Télécharger les métadonnées XML bouton pour télécharger le fichier de métadonnées du plugin.
• Sélectionner Importer des données sur la partie utilisatrice à partir d'un fichier option et téléchargez le fichier de métadonnées téléchargé depuis Étape 1a
• Cliquez sur Suivant.

• Accédez à la Métadonnées du fournisseur de services section du module ASP.NET SAML (comme détaillé dans Étape 1B) pour obtenir les points de terminaison nécessaires à la configuration manuelle du fournisseur de services.
• In Assistant d'ajout d'approbation de partie de confiance sélectionner une option Saisir manuellement les données sur la partie utilisatrice et cliquez sur Suivant.

Spécifiez le nom d'affichage

• Entrer Nom du profil et cliquez sur Suivant.

Configurer le certificat (fonctionnalité Premium)

• Téléchargez le certificat sur Onglet Métadonnées du fournisseur de services.
• Téléchargez le certificat et cliquez sur Suivant.

Configurer l'URL

• Sélectionner Activer la prise en charge du protocole SAML 2.0 WebSSO option et entrez URL ACS du plugin Métadonnées du fournisseur de services Languette.
• Cliquez sur Suivant.

Configurer les identifiants

• Dans l' Identifiant de confiance de la partie de confiance, ajouter le SP-EntityID / Émetteur du plugin Métadonnées du fournisseur de services languette.

Choisissez la politique de contrôle d'accès

• Sélectionner Autoriser tout le monde comme politique de contrôle d'accès et cliquez sur Suivant.

Prêt à ajouter de la confiance

• In Prêt à ajouter de la confiance cliquez sur Suivant et alors Fermer.

Modifier la politique d'émission de réclamation

• Dans la liste des Confiance de la partie de confiance, sélectionnez l'application que vous avez créée et cliquez sur Modifier la politique d'émission de réclamation.

• Dans l'onglet Règle de transformation d'émission, cliquez sur Ajouter une règle .

Choisissez le type de règle

• Sélectionner Envoyer des attributs LDAP en tant que revendications et cliquez sur Suivant.

Configurer la règle de réclamation

• Ajouter un Nom de la règle de revendication et sélectionnez le Magasin d'attributs comme requis dans la liste déroulante.
• Sous Mappage des attributs LDAP aux types de réclamations sortantes, Sélectionnez Attribut LDAP comme Adresses mail et type de réclamation sortante comme Nom ID.

• Une fois les attributs configurés, cliquez sur Finition.
• Après avoir configuré ADFS en tant qu'IDP, vous aurez besoin du Métadonnées de la Fédération pour configurer votre fournisseur de services.
• Pour obtenir les métadonnées de la fédération ADFS, vous pouvez utiliser cette URL
  https://< ADFS_Server_Name >/federationmetadata/2007-06/federationmetadata.xml
• Vous avez configuré avec succès ADFS en tant qu'IdP SAML (fournisseur d'identité) pour réaliser la connexion à authentification unique (SSO) ADFS.

SSO Windows (facultatif)

Suivez les étapes ci-dessous pour configurer Windows SSO

• Étapes pour configurer ADFS pour l'authentification Windows
  • Ouvrez l'invite de commande élevée sur le serveur ADFS et exécutez la commande suivante :
    setspn -a HTTP/##FQDN du serveur ADFS## ##Compte de service de domaine##
  • Le FQDN est un nom de domaine complet (Exemple : adfs4.example.com)
  • Le compte de service de domaine est le nom d'utilisateur du compte dans AD.
  • Exemple : setspn -a HTTP/adfs.example.com nom d'utilisateur/domaine.

• Ouvrez la console de gestion AD FS, cliquez sur Services et aller à la Méthodes d'authentification section. A droite, cliquez sur Modifier les méthodes d'authentification principales. Vérifiez l'authentification Windows dans la zone Intranet.

• Ouvrez Internet Explorer. Accédez à l'onglet Sécurité dans les Options Internet.
• Ajoutez le nom de domaine complet d'AD FS à la liste des sites dans l'intranet local et redémarrez le navigateur.
• Sélectionnez « Personnaliser le niveau de sécurité ». Dans la liste des options, sélectionnez Connexion automatique uniquement dans la zone intranet.

• Ouvrez le PowerShell et exécutez les deux commandes suivantes pour activer l'authentification Windows dans le navigateur Chrome.

 Set-AdfsProperties -WIASupportedUserAgents ((Get-ADFSProperties | Select -ExpandProperty  WIASupportedUserAgents) + "Chrome")
 Get-AdfsProperties | Select -ExpandProperty WIASupportedUserAgents;


• Vous avez configuré avec succès ADFS pour l’authentification Windows.

• Cliquez sur le Ajouter un nouveau fournisseur d'identité bouton pour configurer un nouveau fournisseur d'identité.

• En vertu des Normes sur l’information et les communications, les organismes doivent rendre leurs sites et applications Web accessibles. Ils y parviennent en conformant leurs sites Web au niveau AA des Web Content Accessibility Guidelines (WCAG). Paramètres Plugin , sélectionnez ADFS comme fournisseur d'identité parmi la liste affichée.

Il existe deux manières détaillées ci-dessous avec lesquelles vous pouvez configurer les métadonnées de votre fournisseur d'identité SAML dans le module.

A] Téléchargez les métadonnées à l'aide du bouton Télécharger les métadonnées IDP :

• Si votre fournisseur d'identité vous a fourni l'URL ou le fichier de métadonnées (au format .xml uniquement), vous pouvez simplement configurer les métadonnées du fournisseur d'identité dans le module à l'aide de Télécharger les métadonnées IDP option.

• Copiez l'URL des métadonnées ou téléchargez le fichier de métadonnées pour le configurer du côté de votre fournisseur d'identité.

• Vous pouvez vous référer à la capture d'écran ci-dessous :

• Vous pouvez choisir l’une des options en fonction du format de métadonnées dont vous disposez.

B] Configurez manuellement les métadonnées du fournisseur d'identité :

• Après avoir configuré votre Fournisseur d'identité, il vous fournira ID d'entité IDP, URL d'authentification unique IDP et Certificat SAML X509 champs respectivement.

• Cliquez à nouveau Enregistrer pour enregistrer vos informations IDP.

• Après avoir téléchargé les détails des métadonnées, accédez à la Paramètres du fournisseur d'identité section. Survolez la section Sélectionner des actions liste déroulante et cliquez sur Configuration du test.

• La capture d'écran ci-dessous affiche un résultat de test positif. Veuillez cliquer sur cliquez ici pour terminer les étapes d'intégration SSO restantes.

• Si vous rencontrez une erreur au niveau du module, une fenêtre similaire à celle ci-dessous s'affichera.

• Pour résoudre l'erreur, vous pouvez suivre les étapes ci-dessous :
• Sous Résolution des problèmes , activez la bascule pour recevoir les journaux du plugin.

• Une fois activé, vous pourrez récupérer les journaux du plugin en accédant à Paramètres Plugin onglet et en cliquant sur Configuration du test.
• Téléchargez le fichier journal du Résolution des problèmes Appuyez sur l'onglet pour voir ce qui s'est mal passé.
• Vous pouvez partager le fichier journal avec nous à aspnetsupport@xecurify.com et notre équipe vous contactera pour résoudre votre problème.

• Après avoir testé la configuration, faites correspondre les attributs de votre application avec les attributs du fournisseur d'identité (IdP).

• Dans le menu de gauche du module miniOrange ASP.NET SAML SSO, cliquez sur Cartographie des attributs/rôles onglet comme indiqué dans l'image.
• Cartographiez les éléments requis attributs du fournisseur d'identité (tels que le nom d'utilisateur, l'adresse e-mail, le prénom et le nom de famille) reçus dans la réponse SAML à leurs champs correspondants.

• À noter: Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.
• Une fois les attributs mappés, cliquez sur Enregistrer le mappage d'attributs appliquer des modifications.

Mappage d'attributs personnalisés

• Si vous souhaitez transmettre des attributs supplémentaires de votre IdP, saisissez le nom de l'attribut et la valeur de l'attribut correspondant sous Mappage d'attributs personnalisés.
• Extrait du Valeur de l'attribut (affirmation) Dans le menu déroulant, sélectionnez l'une des revendications que vous avez reçues dans les résultats de la configuration de test. Par exemple : NameID.
• Ces revendications correspondent aux attributs envoyés par votre fournisseur d'identité (IdP).

• Ces revendications correspondent aux attributs envoyés par votre fournisseur d'identité (IdP).

• Dans l' Nom d'attribut Dans ce champ, saisissez le nom de l'attribut tel que vous souhaitez qu'il apparaisse ou soit utilisé dans votre application .NET.
• Vous pouvez ajouter plusieurs mappages si votre application nécessite plusieurs attributs en cliquant sur le + .
• Après avoir défini tous les mappages requis, cliquez sur Enregistrer le mappage d'attributs pour enregistrer la configuration.

• Le module va maintenant traduire les revendications SSO entrantes de votre fournisseur d'identité (IdP) en noms d'attributs personnalisés définis ici.

Mappage des rôles

• Dans l' Mappage des rôles section, entrez la Nom de l'attribut du groupe exactement comme configuré dans votre fournisseur d'identité pour récupérer les informations sur le groupe d'utilisateurs.
• Entrer le Nom de rôle reçu du fournisseur d'identité et l'associer à l'élément approprié Valeur du rôle Dans le champ Valeur du rôle, saisissez les rôles définis dans votre application .NET.
• Par exemple : associez le groupe IdP Group1 ou Group10 reçu sous l’attribut UserGroups au rôle correspondant configuré dans votre application .NET.
• Après avoir ajouté les correspondances requises, cliquez sur Sauvegarder la cartographie des rôles pour enregistrer la configuration avec succès.

Restriction de domaine

• Cette fonctionnalité permet de restreindre l'accès des utilisateurs au site en fonction du domaine de leur attribut « Email » associé.
• Dans l' Attribut d'e-mail Dans ce champ, saisissez le nom de l'attribut qui contient l'adresse électronique de l'utilisateur telle que reçue de votre fournisseur d'identité (IdP).

• Dans l' Services Dans ce champ, saisissez le ou les domaines que vous souhaitez autoriser ou restreindre, séparés par des virgules si vous ajoutez plusieurs domaines.
• Activez la Basculement de restriction en fonction de votre besoin de configurer l'accès par liste noire ou liste blanche.
• Une fois la configuration terminée, cliquez sur Sauvegarder les domaines pour enregistrer les paramètres avec succès.

• Ces étapes vous permettent de récupérer les informations de l'utilisateur SSO dans votre application sous forme de session.
• Vous pouvez également regarder le visite d'installation pour comprendre comment l'intégration SSO fonctionnerait dans votre application de module ASP.NET.
• Il vous suffit de copier-coller ce fragment de code à l'endroit où vous souhaitez accéder aux attributs de l'utilisateur.

• Survolez Sélectionner des actions et cliquez sur Copier le lien SSO.

• Utilisez l’URL suivante comme lien dans l’application à partir de laquelle vous souhaitez effectuer l’authentification unique :

• Par exemple, vous pouvez l'utiliser comme :

• Utilisez l'URL suivante comme lien vers votre application à partir de laquelle vous souhaitez effectuer le SLO :

• Par exemple, vous pouvez l'utiliser comme :