Table des matières

Umbraco SAML Single Sign-On (SSO) avec WordPress comme IDP

Authentification unique Umbraco SAML (SSO) Le plugin permet d'activer l'authentification unique SAML pour vos applications Umbraco. Grâce à l'authentification unique, vous ne pouvez utiliser qu'un seul mot de passe pour accéder à votre application et à vos services Umbraco. Notre plugin est compatible avec tous les fournisseurs d'identité compatibles SAML. Nous allons ici vous guider étape par étape pour configurer l'authentification unique (SSO) entre Umbraco et WordPress en considérant WordPress comme IdP. Pour en savoir plus sur les fonctionnalités que nous proposons pour Umbraco SSO, cliquez sur ici.

Sélectionnez votre version d'Umbraco pour configurer SSO avec :

Pré-requis : téléchargement et installation

Installer à partir de NuGet Store
Installation manuelle

Paquet NuGet
CLI .NET

PM> NuGet\Install-Package miniOrange.Umbraco8.SAML.SSO -Version 5.4.2

Ajouter miniorange-saml-sso.dll dans le dossier bin (où se trouvent vos autres fichiers DLL) de votre site Umbraco.
S'enregistrer miniorangesamlsso module pour votre SSO umbraco selon les étapes fournies dans le intégration.md fichier.
Ajoutez le fichier de configuration fourni saml.config dans le répertoire racine de votre site umbraco.

Télécharger Intergiciel d'authentification unique (SSO) Umbraco SAML.
Pour configurer le middleware, vous devrez ajouter les espaces de noms, les services et le middleware ci-dessous dans votre fichier startup.cs (marqué en vert), ci-dessous voici un exemple

                        
                    
              
                using miniorange.saml;
                using System.Reflection;
            
                namespace Application
                {
                    public class Startup
                    {
            
                // Add services to the container.
        
                public void ConfigureServices(IServiceCollection services)
                {
                  services.AddUmbraco(_env, _config)
                   .AddBackOffice()
                   .AddWebsite()
                   .AddComposers()
                   .Build();
        
                   services.AddminiOrangeServices(Assembly.GetExecutingAssembly());
               }
        
                public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
                {
        
                 if (env.IsDevelopment())
                  {
                   app.UseDeveloperExceptionPage();
                   }
                   app.UseUmbraco()
                 .WithMiddleware(u =>
                {
                  u.UseBackOffice();
                  u.UseWebsite();
                  u.AppBuilder.UseminiOrangeSAMLSSOMiddleware();
                })
        
                .WithEndpoints(u =>
                {
                  u.UseInstallerEndpoints();
                  u.UseBackOfficeEndpoints();
                  u.UseWebsiteEndpoints();
                });
              }
            }
           }

Exécutez l'application une fois la configuration terminée.

Après l'intégration, ouvrez votre navigateur et parcourez le tableau de bord du plugin avec l'URL ci-dessous : https://<umbraco-middleware-base-url>/?ssoaction=config
Si la page d'inscription ou la page de connexion s'affiche, vous avez ajouté avec succès le middleware miniOrange Umbraco SAML dans votre application Umbraco.

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Page de connexion Umbraco

Inscrivez-vous ou connectez-vous avec votre compte en cliquant sur le S'enregistrer bouton pour configurer le plugin

Télécharger Intergiciel d'authentification unique (SSO) Umbraco SAML.
Pour configurer le middleware, vous devrez ajouter les espaces de noms, les services et le middleware ci-dessous dans votre fichier program.cs (marqué en vert), ci-dessous voici un exemple

                        
                    
              
                using miniorange.saml;
                using System.Reflection;
                WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
            
                builder.CreateUmbracoBuilder()
                    .AddBackOffice()
                    .AddWebsite()
                    .AddDeliveryApi()
                    .AddComposers()
                    .Build();
            
                // Add services to the container.
        
                builder.Services.AddminiOrangeServices(Assembly.GetExecutingAssembly());

                WebApplication app = builder.Build();

                await app.BootUmbracoAsync();

                app.UseUmbraco()
                   .WithMiddleware(u =>
                    {
                     u.UseBackOffice();
                     u.UseWebsite();
                     u.AppBuilder.UseminiOrangeSAMLSSOMiddleware();
                     })
        
                     .WithEndpoints(u =>
                     {
                    u.UseBackOfficeEndpoints();
                    u.UseWebsiteEndpoints();
                   });
               await app.RunAsync();

Exécutez l'application une fois la configuration terminée.

Après l'intégration, ouvrez votre navigateur et parcourez le tableau de bord du plugin avec l'URL ci-dessous : https://<umbraco-middleware-base-url>/?ssoaction=config
Si la page d'inscription ou la page de connexion s'affiche, vous avez ajouté avec succès le middleware miniOrange Umbraco SAML dans votre application Umbraco.

Inscrivez-vous ou connectez-vous avec votre compte en cliquant sur le S'enregistrer bouton pour configurer le plugin
Après l'enregistrement, la page d'activation de la clé de licence s'affiche. Saisissez ici la clé de licence reçue sur votre e-mail enregistré

Si vous n'avez pas reçu la clé de licence, cliquez ici

Après l'intégration, ouvrez votre navigateur et parcourez le tableau de bord du connecteur avec l'URL ci-dessous :
https://<your-application-base-url>/?ssoaction=config
Si la page d'inscription ou la page de connexion s'affiche, vous avez ajouté avec succès le connecteur miniOrange Umbraco SAML SSO à votre application.

Authentification unique (SSO) Umbraco SAML utilisant Azure AD comme IDP - Inscription Umbraco SAML

Inscrivez-vous ou connectez-vous avec votre compte en cliquant sur le S'enregistrer bouton pour configurer le module.

1. Configurez WordPress comme IDP

Il existe ci-dessous deux manières 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 la section Paramètres du fournisseur de services, 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 :

Dans la section Paramètres du fournisseur de services, vous pouvez copier manuellement les métadonnées du fournisseur de services, telles que l'ID d'entité SP, l'URL ACS, l'URL de déconnexion unique, et les fournir à votre fournisseur d'identité pour la configuration.
Vous pouvez vous référer à la capture d'écran ci-dessous :

Accédez au site WordPress.
Installez et activez le Fournisseur d'identité SAML WSFED (authentification unique utilisant les utilisateurs WordPress) plugin sur votre site WordPress qui agit en tant que fournisseur d'identité.
Rendez-vous dans la section PDI SAML plugin, accédez au Prestataire de services languette.
Saisissez les valeurs correspondant aux informations du prestataire de services. Reportez-vous au tableau ci-dessous.

Nom du fournisseur de services	Nom de votre fournisseur de services.
ID d'entité SP ou émetteur	Copiez et collez le SP-EntityID du fournisseur de services
URL ACS	Copiez et collez le URL ACS du fournisseur de services.
Format d'ID de nom	urne:oasis:noms:tc:SAML:1.1:nameid-format :adresse e-mail
Assertion signée	à carreaux

Umbraco Single Sign-On (SSO) utilisant WordPress comme IDP - Configurer le paramètre

Cliquez sur le Enregistrer bouton pour enregistrer vos configurations.
Rendez-vous dans la section Métadonnées IDP onglet. Vous trouverez ici des informations pour configurer le fournisseur de services.
Vous pouvez également télécharger le fichier XML des métadonnées, en cliquant sur le bouton download lien.

Umbraco Single Sign-On (SSO) utilisant WordPress comme IDP - télécharger les métadonnées

Vous avez configuré avec succès WordPress comme IDP pour Umbraco Single Sign-On (SSO).

2. Configurer Umbraco comme fournisseur de services

Vous trouverez ci-dessous deux manières de 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 des métadonnées ou le fichier de métadonnées (format .xml uniquement), il vous suffit de configurer les métadonnées du fournisseur d'identité dans le module à l'aide de l' Télécharger les métadonnées du fournisseur d'identité option.
Vous pouvez vous référer à la capture d'écran ci-dessous

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Télécharger des métadonnées

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 x.509. Configurez ces valeurs sous ID d'entité IDP, URL d'authentification unique et Certificat SAML X509 champs respectivement.
Cliquez à nouveau Enregistrer pour enregistrer vos informations IDP.

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Saisir les métadonnées IDP

Vous avez configuré avec succès votre application Umbraco en tant que fournisseur de services.

Il existe deux méthodes détaillées ci-dessous avec lesquelles vous pouvez obtenir les métadonnées SAML SP à configurer du côté de votre fournisseur d'identité.

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 des métadonnées ou le fichier de métadonnées (format .xml uniquement), vous pouvez simplement configurer les métadonnées du fournisseur d'identité dans le plug-in à l'aide de l' Télécharger les métadonnées IDP option. Vous pouvez vous référer à la capture d'écran ci-dessous :

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Télécharger les métadonnées IDP

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.

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Saisir manuellement les métadonnées IDP

Cliquez à nouveau Enregistrer pour enregistrer vos informations IDP

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

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 des métadonnées ou le fichier de métadonnées (format .xml uniquement), vous pouvez simplement configurer les métadonnées du fournisseur d'identité dans le plug-in à l'aide de l' 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 et Certificat SAML X509 champs respectivement.

Cliquez à nouveau Enregistrer pour enregistrer vos informations IDP

3. Test de l'authentification unique SAML

Cliquez sur le Configuration du test bouton pour tester si la configuration SAML que vous avez effectuée est correcte.
La capture d'écran ci-dessous montre un résultat positif. Cliquez sur Intégration SSO pour poursuivre l'intégration SSO.

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Testez SAML SSO

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

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Fenêtre d'erreur

Pour résoudre l'erreur, vous pouvez suivre les étapes ci-dessous :

Sous Dépannage , activez la bascule pour recevoir les journaux du plugin.

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Activer les journaux de débogage

Une fois activé, vous pourrez récupérer les journaux du plugin en accédant à Paramètres du fournisseur d'identité 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 à umbracosupport@xecurify.com et notre équipe vous contactera pour résoudre votre problème.

Cliquez sur le Configuration du test bouton pour tester si la configuration SAML que vous avez effectuée est correcte.
La capture d'écran ci-dessous montre un résultat positif. Cliquez 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 Dépannage , 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 du fournisseur d'identité 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 à umbracosupport@xecurify.com et notre équipe vous contactera pour résoudre votre problème.

Cliquez sur le Configuration du test bouton pour tester si la configuration SAML que vous avez effectuée est correcte.
La capture d'écran ci-dessous montre un résultat positif. Cliquez 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 Dépannage , 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 du fournisseur d'identité 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 à umbracosupport@xecurify.com et notre équipe vous contactera pour résoudre votre problème.

4. Paramètres de connexion

Allez dans Sélectionner des actions et cliquez sur Copier le lien SSO.

Umbraco SAML Single Sign-On (SSO) utilisant Azure AD comme IDP - Copier le lien SSO

Utilisez le lien copié dans l'application à partir de laquelle vous souhaitez effectuer le SSO
Par exemple, vous pouvez l'utiliser comme :
<a href="copied-sso-link”>Login</a>"

Utilisez l’URL suivante comme lien dans l’application à partir de laquelle vous souhaitez effectuer l’authentification unique : https://<umbraco-middleware-base-url>/?ssoaction=login

Utilisez l’URL suivante comme lien dans l’application à partir de laquelle vous souhaitez effectuer l’authentification unique : https://<umbraco-middleware-base-url>/?ssoaction=login

5. Paramètres de déconnexion

Utilisez l'URL suivante comme lien dans votre Umbraco à partir duquel vous souhaitez effectuer le SLO :
https://umbraco-middleware-base-url/?ssoaction=logout
Par exemple, vous pouvez l'utiliser comme :
<a href="https://umbraco-middleware-base-url/?ssoaction=logout”>Logout</a>"

Vous pouvez configurer le module Umbraco SAML 2.0 Single Sign-On (SSO) 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 d'identité fournisseurs ici.

Ressources supplémentaires

Besoin d'aide?

Vous ne parvenez pas à trouver votre fournisseur d'identité ? Envoyez-nous un mail à umbracosupport@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.