Guide de configuration de l'authentification unique SAML pour ASP.NET Framework avec ClassLink comme fournisseur d'identité (IdP).

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.

• 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.

OR

• Téléchargez le fichier de licence que vous avez téléchargé en cliquant sur le Cliquez ici .

• 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 .

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 :

• Par exemple, vous pouvez l'utiliser comme :

7. Paramètres de déconnexion

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

• Par exemple, vous pouvez l'utiliser comme :