Guide de configuration de l'authentification unique SAML pour ASP.NET Framework avec WSO2 comme fournisseur d'identité (IdP).
Marché
Module d'authentification unique (SSO) ASP.NET SAML donne la possibilité d'activer Authentification unique SAML pour vos applications ASP.NET. En utilisant Authentification unique vous ne pouvez utiliser qu'un seul mot de passe pour accéder à votre Application ASP.NET et services. Notre module est compatible avec tous les Fournisseurs d'identité compatibles SAML. Ici, nous allons parcourir un guide étape par étape pour configurer Single Sign-On (SSO) entre ASP.NET et WSO2 considérant WSO2 en tant qu'IdP.
Prise en charge de la plateforme: Le module ASP.NET SAML SSO prend en charge les frameworks ASP.NET 3.5 et supérieurs.
Pré-requis : Téléchargement Et Installation
- Pour installer le Paquet NuGet miniOrange SAML SSO dans votre application .NET, installez simplement le package miniOrange NuGet sur votre application.
Package NuGet
CLI .NET
PM> NuGet\Install-Package miniOrange.SAML.SSO
- 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 d'inscription ou la page de connexion s'affiche, vous avez ajouté avec succès le module miniOrange SAML SSO dans votre application.
- Inscrivez-vous ou connectez-vous avec votre compte en cliquant sur le S'enregistrer bouton pour configurer le module.
- Après une inscription réussie, vous recevrez une clé de licence d'essai sur votre adresse e-mail enregistrée.
- Pour activer le module, vous pouvez soit :
- Entrer le clé de licence reçu par e-mail dans le champ de saisie prévu.
- Téléchargez le fichier de licence que vous avez téléchargé en cliquant sur le Cliquez ici .
OR
- Ensuite, cochez la case « J'ai lu les conditions ci-dessus et je souhaite activer le module », et cliquez sur le bouton Activer la licence .
Étapes de configuration
1. Fournir les métadonnées de l'application .NET au fournisseur d'identité WSO2
Il existe deux méthodes détaillées ci-dessous avec lesquelles vous pouvez obtenir les métadonnées SAML SP à configurer sur votre fournisseur d'identité.
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 section, vous pouvez copier manuellement les métadonnées du fournisseur de services comme ID d'entité SP, URL ACS, URL de déconnexion unique et partagez-le avec votre fournisseur d'identité pour la configuration.
- Vous pouvez vous référer à la capture d'écran ci-dessous :
- Se connecter à votre Console d'administration WSO2.
- Dans le menu de navigation de gauche, sélectionnez Ajouter sous Prestataire de services languette.
- Dans l' Ajouter un nouveau fournisseur de services page, configurez les éléments suivants :
- Sélectionnez le mode: Configuration manuelle
- Nom du fournisseur de servicesApplication ASP.NET
- Description du fournisseur de services: (Facultatif) Saisissez une description
- Cliquez sur S'enregistrer.
Information basique
- Sélectionnez le type de certificat SPUtilisez le point de terminaison JWKS du SP
- Application SaaS : Coché (Facultatif)
Configuration des réclamations
- Sélectionner le dialecte de mappage de revendication: Utiliser le dialecte de revendication locale
- Cliquez sur Ajouter un URI de revendication pour lequel vous pouvez ajouter plusieurs revendications/attributs. Cartographie d'attributs (comme adresse e-mail, prénom, nom, numéro de téléphone, etc.).
- URI de la revendication du sujet: https://wso2.org/claims/fullname
Configuration des rôles/autorisations
- Développez la section Configuration des rôles/autorisations, puis développez le Permissions la Mappage des rôles sections.
- Cliquez à nouveau Ajouter une autorisation et spécifiez l'autorisation spécifique du fournisseur de services que vous souhaitez ajouter.
- Cliquez à nouveau Ajouter un mappage de rôles et entrez les valeurs appropriées pour le rôle local ainsi que pour le rôle du fournisseur de services.
Configuration de l'authentification entrante
- Allez dans Configuration de l'authentification unique Web SAML2.
- Cliquez sur Configurer.
- In Enregistrer un nouveau fournisseur de services page, sélectionnez Mode comme Configuration des URL.
- Copiez le URL de métadonnées à partir de Paramètres du fournisseur de services onglet dans le module.
- Collez l'URL dans la zone de texte sous Télécharger les métadonnées du fournisseur de services à partir de l'URL.
- Cliquez sur le Télécharger une présentation .
- Cliquez sur le OK .
Métadonnées du fournisseur d'identité
- Sous Configuration de l'authentification entrante, cliquer sur Configuration de l'authentification unique Web SAML2.
- Cliquez à nouveau Modifier en plus de l'émetteur de votre fournisseur de services.
- Vous pouvez vérifier les détails de votre fournisseur de services ici.
- Vérifiez la Activer le profil d'attribut et Inclure toujours l'attribut dans la réponse pour Cartographie d'attributs.
- Cliquez sur le Télécharger les métadonnées IDP Appuyez sur le bouton et conservez les métadonnées IDP à portée de main, car elles seront nécessaires ultérieurement pour la configuration.
- Cliquez sur Mises à jour .
Vous avez configuré avec succès WSO2 en tant que fournisseur d'identité SAML (IdP) pour permettre la connexion SSO WSO2 à votre application ASP.NET.
2. Configurer les métadonnées du fournisseur d'identité WSO2 dans l'application .NET
- Cliquez sur le Sélectionnez votre IDP 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 WSO2 en tant que fournisseur d'identité dans 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 (format .xml uniquement), vous pouvez simplement configurer les métadonnées du fournisseur d'identité dans le module à l'aide du 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.
3. Test de l'authentification unique SAML
- 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 montre un résultat réussi. Cliquer sur Intégration SSO pour poursuivre l'intégration SSO.
- 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 onglet pour voir ce qui n'a pas fonctionné.
- Vous pouvez partager le fichier journal avec nous à aspnetsupport@xecurify.com et notre équipe vous contactera pour résoudre votre problème.
4. Cartographie des attributs
- Après avoir testé la configuration, mappez 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.
- 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.
- À 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.
5. Code d'intégration
- Cette étape vous permet 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.
- Copiez-collez simplement cet extrait de code où vous souhaitez accéder aux attributs utilisateur.
- À noter: Avec le module d'essai, les informations des utilisateurs authentifiés sont stockées dans des variables de session. Notre extension premium permet de configurer des revendications utilisateur via l'authentification par en-tête, par formulaire, par cookie et par JWT.
6. Paramètres de connexion
- 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 :
https://<asp.net-module-base-url>/?ssoaction=login
- Par exemple, vous pouvez l'utiliser comme :
<a href="https://<asp.net-module-base-url>/?ssoaction=login">Log
in</a>
7. Paramètres de déconnexion
- Utilisez l'URL suivante comme lien vers votre application à partir de laquelle vous souhaitez effectuer le SLO :
https://<asp.net-module-base-url>/?ssoaction=logout
- Par exemple, vous pouvez l'utiliser comme :
<a href="https://<asp.net-module-base-url>/?ssoaction=logout">Log
out</a>
Articles Relatifs
Merci pour votre réponse. Nous reviendrons vers vous bientôt.
Quelque chose s'est mal passé. Veuillez soumettre à nouveau votre requête
