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

Authentification unique Umbraco SAML (SSO) Le plugin donne la possibilité 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. Ici, nous allons passer en revue un guide étape par étape pour configurer l'authentification unique (SSO) entre Umbraco et Keycloak en considérant Keycloak comme IdP. Pour en savoir plus sur les fonctionnalités que nous proposons pour Umbraco SSO, cliquez sur ici.

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

• Télécharger Module d'authentification unique (SSO) Umbraco SAML.
• Pour configurer le module, extrayez le umbraco-saml-sso-connector.zip, vous trouverez un fichier DLL miniorange-saml-sso.dll, un fichier de configuration saml.config et un intégration.md fichier qui contient les étapes d’ajout du module dans votre application.

1. Ajouter un module dans l'application Umbraco

• Ajouter miniorange-saml-sso.dll dans le dossier bin (où existent vos autres fichiers DLL) de votre site Umbraco.
• Inscription 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.
• Après l'intégration, ouvrez le navigateur et parcourez le tableau de bord du module avec l'URL ci-dessous :
  https://<umbraco-base-url>/?ssoaction=config
• Si la page d'inscription ou la page de connexion apparaît, vous avez ajouté avec succès le module sso miniOrange saml pour votre application.

• Inscription or Connexion pour configurer le module.

2. Configurez Keycloak en tant qu'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 :
  
  

• Version 18 et inférieure
• Version 19 et supérieure

Dans votre Keycloak Administrateur console, sélectionnez le domaine que vous souhaitez utiliser.
Cliquez sur Entreprises dans le menu de gauche puis cliquez sur Création bouton pour créer un nouveau client/application.

Entrer SP-EntityID / Émetteur car identité du client dans l'onglet « Paramètres du fournisseur de services » et sélectionnez SAML car Protocole client.

Maintenant, cliquez sur Épargnez.
Configurez Keycloak en fournissant les détails requis :
identité du client	La SP-EntityID / Émetteur depuis l'onglet Métadonnées du fournisseur de services du plugin
Nom	Donnez un nom à ce client
Description	Fournir une description
Signature du client requise	de remise
Forcer la liaison POST	de remise
Forcer le format de l'ID du nom	de remise
Format d'identification du nom	Email
URL racine	Laissez vide ou fournissez l'URL de base dans l'onglet Paramètres du fournisseur de services.
URI de redirection valides	La URL ACS (Assertion Consumer Service) depuis l'onglet Paramètres du fournisseur de services du plugin

Sous Configuration du point de terminaison SAML à grain fin, Saisissez les informations suivantes :
URL de liaison POST du service consommateur d’assertions	La URL ACS (Assertion Consumer Service) depuis l'onglet Paramètres du fournisseur de services du plugin
URL de liaison de redirection du service de déconnexion (Facultatif)	La URL de déconnexion unique depuis l'onglet Métadonnées du fournisseur de services du plugin

Cliquez sur Épargnez.
Dans votre Keycloak Administrateur console, sélectionnez le domaine que vous souhaitez utiliser.
Cliquez sur Entreprises dans le menu de gauche puis cliquez sur Créer un client bouton pour créer un nouveau client/application.

Sélectionnez SAML as Type de client, Entrer SP-EntityID / Émetteur car identité du client dans l'onglet « Métadonnées du fournisseur de services », saisissez le nom de votre application et saisissez la description.

Maintenant, cliquez sur Épargnez.
Configurez Keycloak en fournissant les détails requis :
identité du client	La SP-EntityID / Émetteur depuis l'onglet Métadonnées du fournisseur de services du plugin
Nom	Donnez un nom à ce client
Description	Fournir une description
Signature du client requise	de remise
Forcer la liaison POST	de remise
Forcer le format de l'ID du nom	de remise
Format d'identification du nom	Email
URL racine	Laissez vide ou fournissez l'URL de base dans l'onglet Paramètres du fournisseur de services.
URI de redirection valides	La URL ACS (Assertion Consumer Service)depuis l'onglet Paramètres du fournisseur de services du plugin

Maintenant, cliquez sur Épargnez.
In Avancé onglet,sous Configuration du point de terminaison SAML à grain fin, Saisissez les informations suivantes :
URL de liaison POST du service consommateur d’assertions	La URL ACS (Assertion Consumer Service) depuis l'onglet Paramètres du fournisseur de services du plugin
URL de liaison de redirection du service de déconnexion (Facultatif)	La URL de déconnexion unique depuis l'onglet Métadonnées du fournisseur de services du plugin

Cliquez sur Épargnez.

Vous avez configuré avec succès Keycloak en tant qu'IdP SAML (fournisseur d'identité) pour réaliser la connexion Keycloak / Keycloak SSO / Keycloak Single Sign-On (SSO), garantissant une connexion sécurisée à l'application Umbraco.

3. Configurez Umbraco en tant que SP

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 ou le fichier de métadonnées (format .xml uniquement), alors vous configurez simplement les métadonnées du fournisseur d'identité dans le module à l'aide du Télécharger les métadonnées du fournisseur d'identité 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 avec lequel vous êtes disponible.

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 Certificat x.509. Configurez ces valeurs sous ID d'entité IDP, URL d'authentification unique ainsi que Certificat SAML X509 champs respectivement.
• Cliquez Épargnez pour enregistrer vos informations IDP.

4. Configuration des tests

• Cliquez sur Configuration du test pour tester si la configuration SAML que vous avez effectuée est correcte ou non.
• La capture d'écran ci-dessous montre un résultat réussi.

5. Cartographie des attributs

• Mappez vos attributs umbraco avec les attributs du fournisseur d'identité (IdP).

• Cliquez sur Enregistrer le mappage d'attributs bouton pour enregistrer les paramètres.

6. Type de connexion

La plateforme Umbraco prend en charge deux méthodes de connexion différentes :

7. Paramètres de connexion

• Utilisez l'URL suivante comme lien dans votre site Umbraco à partir duquel vous souhaitez lancer le SSO :
  https://umbraco-base-url/?ssoaction=login
• Par exemple, vous pouvez l'utiliser comme :
  <a href="https://umbraco-base-url/?ssoaction=login”>Login</a>"

8. Paramètres de déconnexion

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

Vous pouvez configurer le module d'authentification unique (SSO) Umbraco SAML 2.0 avec n'importe quel fournisseur d'identité tel que ADFS, Azure AD, Bitium, Centrify, G Suite, WordPress, 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.

9. Ressources supplémentaires

• Authentification unique DNN SAML (SSO)
• Authentification unique Umbraco SAML (SSO)
• Authentification unique ASP.NET SAML (SSO)
• nopCommerce SAML Authentification unique (SSO)
• Authentification API REST DNN