Guides de configuration de l’authentification unique ASP.NET Core SAML
Choisissez votre fournisseur d'identité SAML pour configurer l'authentification unique (SSO)
Vous ne parvenez pas à trouver votre IdP ? Contactez-nous à
aspnetsupport@xecurify.com
et nous vous aiderons à configurer ASP.NET Core SSO avec votre IdP en un rien de temps.
Vous n'avez pas trouvé votre IdP ?
Contactez-nous à
aspnetsupport@xecurify.com
et nous vous aiderons à configurer ASP.NET Core SSO avec votre fournisseur d'identité (IdP) en un rien de temps.
using Microsoft.AspNetCore.Authentication.Cookies;
using miniOrange.saml;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddRazorPages();// Add authentication servicesbuilder.Services.AddControllersWithViews();builder.Services.AddAuthentication(options => { options.DefaultAuthenticateScheme = "SSO_OR_Admin";options.DefaultScheme = "SSO_OR_Admin";options.DefaultChallengeScheme = "SSO_OR_Admin"; }).AddCookie("moAdmin", options => { }).AddCookie(CookieAuthenticationDefaults.AuthenticationScheme, options => {// Configure cookie options as needed for SSO Users}).AddPolicyScheme("SSO_OR_Admin", "SSO_OR_Admin", options =>{// runs on each requestoptions.ForwardDefaultSelector = context =>{// filter by auth type, here if the moAdmin cookie is coming in any request the Admin Authentication will workforeach (var cookie in context.Request.Cookies){if (cookie.Key.Contains(".AspNetCore.Cookies")){return CookieAuthenticationDefaults.AuthenticationScheme;}}// otherwise always check for cookie authreturn "moAdmin";};});var app = builder.Build();
if (!app.Environment.IsDevelopment()) { app.UseExceptionHandler("/Error"); app.UseHsts(); }app.UseHttpsRedirection();app.UseRouting();app.UseAuthorization();app.MapRazorPages();app.UseCookiePolicy();app.UseAuthentication();app.UseStaticFiles();app.UseminiOrangeSAMLSSOMiddleware();app.Run();
1. Ajouter un middleware sur l'application ASP.NET Core
Après l'intégration, ouvrez votre navigateur et parcourez le tableau de bord du connecteur avec l'URL ci-dessous : https://<asp.net-core-application-base-url>/?ssoaction=config
Si la page d'inscription ou la page de connexion apparaît, vous avez ajouté avec succès l'authentification middleware miniOrange ASP.NET Core SAML à votre application.
Inscrivez-vous ou connectez-vous avec votre compte en cliquant sur le Inscription bouton pour configurer le middleware.
2. Configurez votre 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 votre fournisseur d'identité dans la liste affichée.
Il existe deux manières détaillées ci-dessous de configurer les métadonnées SAML SP du côté de votre fournisseur d'identité.
A] Utilisation d'une URL de métadonnées SAML ou d'un fichier de métadonnées :
Dans le 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 configurer la même chose 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 :
3. Configurer le middleware SAML ASP.NET Core en tant que fournisseur de services
Il existe deux manières détaillées ci-dessous de configurer les métadonnées de votre fournisseur d'identité SAML dans le middleware.
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 middleware à l'aide de l'option
Télécharger les métadonnées IDP option.
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 ainsi que le
Certificat SAML X509 champs respectivement.
Cliquez Épargnez pour enregistrer vos informations IDP.
4. Test de l'authentification unique SAML
Cliquez sur le Configuration du test pour tester si la configuration SAML que vous avez effectuée est correcte.
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 du côté du middleware, 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écharger 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.
5. Cartographie des attributs
Après avoir testé la configuration, mappez les attributs de votre application avec les attributs du fournisseur d'identité (IdP).
Remarque: Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.
6. Code d'intégration
Ces étapes vous permettent de récupérer les informations utilisateur SSO dans votre application sous la forme de revendications utilisateur.
Vous pouvez également regarder le visite d'installation pour comprendre comment l'intégration SSO fonctionnerait dans votre application Blazor.
Copiez-collez simplement cet extrait de code là où vous souhaitez accéder aux attributs utilisateur.
Remarque:Ce middleware d'essai prend uniquement en charge les informations utilisateur dans les réclamations. La récupération des informations utilisateur en session et en-têtes est disponible dans le plugin premium.
Vous pouvez également copier le code d'intégration ci-dessous :
string name=""; string claimtype=""; string claimvalue=""; if(User.Identity.IsAuthenticated) { foreach( var claim in User.Claims) { claimtype = claim.Type; claimvalue = claim.Value;
} //retrive custom attributes(for eg. Retrieve Mapped 'mobileNumber' attribute of your IDP) var identity = (ClaimsIdentity)User.Identity; IEnumerable claims = identity.Claims; string mobileNumber = identity.FindFirst("mobileNumber")?.Value;
}
Remarque: Tous les attributs mappés seront stockés dans les revendications accessibles dans votre application.
Si vous souhaitez de l'aide concernant le code d'intégration, contactez-nous à
aspnetsupport@xecurify.com
7. Paramètres de connexion
Utilisez l'URL suivante comme lien dans l'application à partir de laquelle vous souhaitez effectuer le SSO :
https://base-url/?ssoaction=login
Par exemple, vous pouvez l'utiliser comme : <a href=”https://base-url/?ssoaction=login”>Log
in</a>
8. Paramètres de déconnexion
Utilisez l'URL suivante comme lien vers votre application à partir de laquelle vous souhaitez effectuer un SLO : https://base-url/?ssoaction=logout
Par exemple, vous pouvez l'utiliser comme : <a href=”https://base-url/?ssoaction=logout”>Log
out</a>
Pour configurer votre IDP, vous pouvez trouver les métadonnées du fournisseur de services dans le fichier appsetting.json. Pour les métadonnées SP, vous pouvez vous référer à la capture d'écran ci-dessous :
Du miniOrange section, copiez dépenséityid, acsurl et fournissez-le à l'équipe de votre fournisseur d'identité.
Une fois les métadonnées du fournisseur de services configurées du côté de l'IdP, vous recevrez le fichier de métadonnées de l'IdP ou l'URL de métadonnées ou des URL de métadonnées telles que l'ID d'entité IdP, l'URL SSO de l'IdP, etc.
Pour configurer vos métadonnées IDP, accédez à
appsettings.json déposer. Vous trouverez les paramètres suivants dans la section JSON du miniorange
Pour configurer directement votre IDP, accédez à
appsettings.json fichier.
Configurez les métadonnées fournies appropriées et enregistrez les paramètres.
idp_cert
Entrez le certificat IDP dans ce champ
sourl
Saisissez l'URL SSO dans ce champ
idp_issuer
Entrez l'émetteur IDP dans ce champ
Cartographie d'attributs
Mappez les attributs de votre application avec les attributs du fournisseur d'identité (IDP).
Remarque: Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.
Code d'intégration
Copiez-collez simplement l'extrait de code là où vous souhaitez accéder aux attributs utilisateur.
Remarque: Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.
Vous pouvez configurer le
Authentification unique (SSO) ASP.NET Core SAML
middleware avec n’importe quel fournisseur d’identité tel que
ADFS, Azure AD, Bitium, centrify, G Suite, JBoss Keycloak, Okta, OneLogin, Salesforce, AWS Cognito, OpenAM, Oracle, PingFederate, PingOne, RSA SecureID, Shibboleth-2, Shibboleth-3, SimpleSAML, WSO2 ou même avec votre propre fournisseur d'identité personnalisé. Consultez la liste des fournisseurs d'identité
ici.
Vous ne parvenez pas à trouver votre fournisseur d'identité ? Envoyez-nous un mail à
aspnetsupport@xecurify.com
et nous vous aiderons à configurer le SSO avec votre IDP et pour des conseils rapides (par e-mail/réunion) sur vos besoins et notre équipe vous aidera à sélectionner la solution/le plan le mieux adapté à vos besoins.
Recherches tendances :
Bonjour!
Besoin d'aide? Nous sommes ici !
Contacter l'assistance miniOrange
Merci pour votre demande.
Si vous n'avez pas de nouvelles de nous dans les 24 heures, n'hésitez pas à envoyer un e-mail de suivi à info@xecurify.com
Préférences de cookies
Consentement aux cookies
Cette déclaration de confidentialité s'applique aux sites Web miniorange décrivant la manière dont nous traitons les informations personnelles. Lorsque vous visitez un site Web, celui-ci peut stocker ou récupérer des informations sur votre navigateur, principalement sous la forme de cookies. Ces informations peuvent concerner vous, vos préférences ou votre appareil et sont principalement utilisées pour que le site fonctionne comme vous le souhaitez. Les informations ne vous identifient pas directement, mais elles peuvent vous offrir une expérience Web plus personnalisée. Cliquez sur les titres des catégories pour vérifier comment nous traitons les cookies. Pour la déclaration de confidentialité de nos solutions, vous pouvez vous référer au Politique de confidentialité.
Cookies strictement nécessaires
Toujours actif
Les cookies nécessaires contribuent à rendre un site Web pleinement utilisable en activant les fonctions de base telles que la navigation sur le site, la connexion, le remplissage de formulaires, etc. Les cookies utilisés pour la fonctionnalité ne stockent aucune information personnelle identifiable. Cependant, certaines parties du site Web ne fonctionneront pas correctement sans les cookies.
Cookies de performance
Toujours actif
Ces cookies collectent uniquement des informations agrégées sur le trafic du site Web, notamment les visiteurs, les sources, les clics et les vues des pages, etc. Cela nous permet d'en savoir plus sur nos pages les plus et les moins populaires ainsi que sur l'interaction des utilisateurs sur les éléments exploitables et ainsi de permettre nous améliorons les performances de notre site Web ainsi que de nos services.