Résultats de recherche :

×

S'inscrire Contactez-Nous

Keycloak Authentification unique (SSO) TYPO3 OAuth et OpenID | TYPO3 KeycloakSSO


L'extension d'authentification et d'autorisation unique (SSO) Typo3 OAuth 2.0 permet à vos utilisateurs frontend et backend (administrateur et client) de se connecter de manière transparente au site Typo3 à l'aide des informations d'identification Keycloak. L'extension Typo3 OAuth / OpenID Connect Single Sign-On (SSO) facilite l'utilisation d'OAuth2 pour configurer la connexion Keycloak sur Typo3 (Keycloak Single Sign-on).

L'extension Typo3 OAuth & OpenID Connect Single Sign-On (SSO) permet de se connecter à Typo3 en toute sécurité via n'importe quel fournisseur OAuth et OpenID Connect, comme Azure AD, Azure B2C, Okta, Keycloak, Salesforce, etc. Elle prend également en charge des fonctionnalités SSO avancées, telles que le mappage des attributs de profil utilisateur et le mappage des rôles. Cliquez ici pour en savoir plus sur les fonctionnalités premium de l'extension Typo3 OAuth Single Sign-On (client OAuth & OpenID Connect).

Dans ce guide, nous verrons comment configurer le SSO entre Typo3 et Keycloak. Les utilisateurs devraient pouvoir se connecter à Typo3 via Keycloak à la fin de ce guide.

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

img Installation de l'extension OAuth Client / OpenID Connect dans TYPO3


  • Utilisez la commande ci-dessous pour installer l'extension à l'aide de composer :
    composer req miniorange/miniorange_oidc
  • Cherchez maintenant le "miniOrange OpenIDConnect" dans la section Extensions installées et activez l’extension en cliquant sur le bouton Activer.
  • Après l'installation, cliquez sur l'extension nouvellement installée "miniOrange OpenIDConnect" pour TYPO3 SSO et connectez-vous avec vos identifiants miniOrange enregistrés.
  • Paramètres OpenIDCconnect Typo3 miniorange
  • Après avoir entré le nom d'utilisateur et le mot de passe, vous aurez besoin d'une clé de licence pour continuer si vous êtes un client premium. (Vous obtiendrez cette clé de l'équipe miniOrange. Après avoir entré la clé de licence, vous pouvez activer la licence et continuer.)
  • licence miniorange connexion oauth oidc
  • Si vous n'êtes pas un client premium, vous pouvez vous connecter en toute transparence en soumettant vos informations d'identification miniOrange.
  • Après une connexion réussie, vous pouvez voir les détails liés à votre compte.
  • Détails du compte Typo3 OAuth Single Sign-On
  • Vous êtes maintenant prêt à configurer votre IdP. Mais il est important d’intégrer d’abord le frontend.
  • Téléchargez le fichier zip de l'extension OAuth / OIDC depuis la place de marché TYPO3
  • Accédez à votre backend TYPO3 et cliquez sur la section Extensions sur le côté gauche de votre écran.
  • Téléchargez le fichier zip, comme représenté dans l'image ci-dessous.
  • Plugin de téléchargement Typo3 OAuth OIDC SSO
  • Cherchez maintenant le "miniOrange OpenIDConnect" dans la section Extensions installées et activez l’extension en cliquant sur le bouton Activer.
  • Après l'installation, cliquez sur l'extension nouvellement installée "miniOrange OpenIDConnect" pour TYPO3 SSO et connectez-vous avec vos identifiants miniOrange enregistrés.
  • Paramètres OpenIDCconnect Typo3 miniorange
  • Après avoir entré le nom d'utilisateur et le mot de passe, vous aurez besoin d'une clé de licence pour continuer si vous êtes un client premium. (Vous obtiendrez cette clé de l'équipe miniOrange. Après avoir entré la clé de licence, vous pouvez activer la licence et continuer.)
  • licence minorange connexion oauth oidc
  • Si vous n'êtes pas un client premium, vous pouvez vous connecter directement en soumettant vos informations d'identification miniOrange.
  • Après une connexion réussie, vous pouvez voir les détails liés à votre compte.
  • Vous êtes maintenant prêt à configurer votre IdP. Mais il est important d’intégrer d’abord le frontend.

img Intégrer l'extension avec TYPO3

  • Cliquez sur le Pages à partir de la navigation de gauche.
  • Ensuite, vous devez créer un dossier pour y stocker les utilisateurs du frontend en cliquant avec le bouton droit sur le Accueil page et sélectionnez Nouvelle sous-page.
  • Typo3 OAuth SSO crée une interface
  • Sélectionner Dossier tapez dans la liste déroulante.
  • Typo3 OAuth openid SSO créer une interface
  • Nommez le dossier comme Utilisateurs du site Web et cliquez sur le Enregistrer.
  • Typo3 OAuth Single Sign-On crée une interface
  • Accédez à l'onglet Comportement et ajoutez Utilisateurs du site Web dedans.
  • Typo3 OAuth SSO ajoute des utilisateurs de sites Web
  • Si vous voyez un trait d'union en rouge sur le dossier créé, cela signifie que le dossier n'est pas activé. Vous pouvez ensuite l'activer en cliquant avec le bouton droit sur ce dossier et en cliquant sur Permettre.
  • Il faut en ajouter deux STANDARD pages dans le ACCUEIL page. Si vous utilisez Premium Plugin, vous pouvez créer trois pages.
  • Ici, nous considérerons les noms de page comme : FEOIDC, RÉPONSE, DÉCONNEXION (La déconnexion est facultative pour les clients premium).
  • Créer un FEOIDC page, faites un clic droit sur Accueil page puis sélectionnez Nouvelle sous-page et sélectionnez STANDARD tapez dans la liste déroulante.
  • Typo3 OAuth SSO crée une interface
  • Ajouter le titre de la page comme FEOIDC et cliquez sur Enregistrer.
  • Typo3 OAuth SSO crée une interface
  • Puis à nouveau cliquez sur Page FEOIDC et cliquez sur Ajouter du contenu. Allez dans les plugins et ajoutez Plugin FEOIDC et cliquez sur le Enregistrer.
  • Typo3 OAuth SSO crée une interface Plugin de sélection Typo3 OAuth Single Sign-On
  • Accédez à l’onglet plugin et sélectionnez le plugin FEOIDC.
  • Typo3 OAuth SSO crée une interface
  • Ajouter des utilisateurs de sites Web dans Page de stockage des enregistrements et enregistrez les paramètres.
  • Typo3 OAuth SSO crée une interface
  • Vous pouvez activer le FEOIDC page en cliquant avec le bouton droit et en sélectionnant Permettre option.
  • Typo3 OAuth SSO crée une interface
  • Si vous devez apporter des modifications au segment d'URL, qui sera également votre URL SSO initiale, faites un clic droit sur la page FEOIDC, sélectionnez Modifier et cliquez sur le bouton « basculer l'URL » pour définir l'URL selon vos préférences.
  • Suivez les mêmes étapes pour créer et configurer les pages standard de Response.
  • Assurez-vous de sélectionner le plug-in de réponse pour la page de réponse.
  • Gardez le FEOIDC et RÉPONSE URL de page pratiques car vous en aurez besoin lors de la configuration de l’extension OAuth/OpenID Connect.

Étapes pour configurer la connexion Keycloak OAuth et OpenID Single Sign-On (SSO) à Typo3

1. Configurer Keycloak en tant que fournisseur OAuth

Suivez les étapes ci-dessous pour configurer Keycloak en tant que fournisseur OAuth

img Configurer Keycloak en tant que fournisseur OAuth
  • Tout d'abord, Télécharger Keycloak et l'installer.
  • Démarrer le serveur : Démarrez le serveur keycloak en exécutant le fichier _standalone.sh_

    Répertoire racine de keycloak/bin/standalone.sh

  • Ajouter un royaume : Connectez-vous maintenant à la console d'administration keycloak et accédez au domaine souhaité. Vous pouvez ajouter un nouveau domaine en sélectionnant Ajouter un royaume option.
  • Keycloak SSO Typo3 OAuth SSO ajouter un domaine
  • Créer un royaume : Entrez le nom du domaine et cliquez sur CREATE pour ajouter un royaume.
  • Créer un rôle : Le Rôle sera utilisé par vos applications pour définir quels utilisateurs seront autorisés à accéder à l'application. Clique sur le Rôles et choisissez Ajouter Rôle.
  • Typo3 Keycloak SSO OAuth openid connect Ajouter un rôle
  • Ajouter un utilisateur : Nous devons ajouter des utilisateurs au royaume qui pourront accéder aux ressources du royaume. Clique sur le Utilisateurs et choisissez de Ajouter un nouvel utilisateur.
  • Connexion Keycloak Typo3 OAuth Typo3 SSO Ajouter un utilisateur
  • Configuration utilisateur: Une fois l’utilisateur créé, l’action suivante doit être effectuée.
    • En définissant un mot de passe, cliquez sur Informations d'identification et définissez un nouveau mot de passe pour l'utilisateur.
    • Identifiants Keycloak SSO OAuth Typo3

      REMARQUE : la désactivation de Temporaire rendra le mot de passe utilisateur permanent


  • Utilisateur de la carte : Nous devons mapper l'utilisateur à un rôle. Cliquer sur Mappages de rôles et attribuez à l'utilisateur le rôle souhaité parmi les rôles disponibles et en cliquant sur ajouter sélectionnée.
  • Mappage des rôles Typo3 Keycloak SSO OAuth
  • Créer des groupes : Cliquez sur le Groupes et choisissez NOUVEAU créer un nouveau groupe.
  • Keycloak OAuth openid connect SSO pour Typo3 Créer un groupe
  • Attribuer un utilisateur au groupe : Sélectionnez l'utilisateur que vous souhaitez ajouter au groupe. Choisissez l'option Groupes dans l'onglet, puis sélectionnez le nom du groupe et cliquez sur rejoindre.
  • Keycloak SSO OAuth openid connect Attribuer un utilisateur au groupe
  • Créez un client OpenID : Cliquez sur le ANNONCEURS et choisissez créer des pour créer un nouveau client. Entrez n'importe quelle chaîne aléatoire comme identité du client et gardez-le à portée de main car vous en aurez besoin à l'étape suivante. Sélectionnez le protocole client openeid-connecter et sélectionnez Enregistrer.
  • Keycloak SSO OAuth Openid Connect Créer un client Openid
  • Entrer Modifier le type d'accès : Une fois le client créé, modifiez son type d'accès en confidentielles
  • Jboss Keycloak Typo3 SSO Modifier le type d'accès
  • Saisissez des URL de redirection valides : Copier l'URL de rappel (Entrez depuis Authentification unique OAuth (SSO) miniOrange Typo3 plugin que vous avez copié à la dernière étape) à la dernière étape puis cliquez sur ENREGISTRER.
    Ex -- https://oauth/callback
  • Mappeur de groupe Keycloak : Maintenant, pour obtenir les détails du groupe, nous devons effectuer son mappage client avec l'appartenance au groupe, sinon les détails du groupe ne seront pas récupérés. Donc, dans la sélection du client Cartographes puis cliquez sur créer des . Sélectionnez le type de mappeur Appartenance à un groupe et entrez le nom et le nom de la revendication du jeton, c'est-à-dire le nom de l'attribut correspondant aux groupes qui seront récupérés et cliquez sur Enregistrer Mappeur de groupe Typo3 Keycloak Group Mapper

    Remarque : -- Si le chemin complet est sur le chemin du groupe, il sera récupéré, sinon le nom du groupe sera récupéré.

  • Obtenez le secret client : Nous devons maintenant obtenir le secret client. Alors sélectionnez ANNONCEURS et sélectionnez les informations d'identification et copiez votre secret à partir d'ici.
  • Secret client Oauth SSO Redentials Typo3 SSO

Vous avez configuré avec succès Keycloak comme fournisseur OAuth pour mettre en œuvre l'authentification unique (SSO) Keycloak avec Typo3 pour l'authentification des utilisateurs.

2. Configuration de Typo3 en tant que client OAuth

  • Après avoir configuré avec succès le fournisseur OAuth, entrez le Nom du fournisseur OAuth, identité du client, Secret client, Domaine et fourni des points de terminaison.

    Veuillez vous référer aux points de terminaison ci-dessous pour configurer le client OAuth


    Portée: profil de messagerie
    Autoriser le point de terminaison : /realms/{nom-domaine}/protocol/openid-connect/auth
    Point de terminaison du jeton d’accès : /realms/{nom-domaine}/protocol/openid-connect/token
    Obtenir le point de terminaison des informations utilisateur : /realms/{nom-domaine}/protocol/openid-connect/userinfo
  • Cliquez sur le Enregistrer bouton pour enregistrer les paramètres.
  • Identifiants SSO Typo3 OAuth 2.0 | Typo3 KeycloakSSO
  • Cliquez sur le Configuration du test .
  • Informations d'identification Typo3 OAuth Keycloak SSO OAuth
  • Vous verrez toutes les valeurs renvoyées par votre fournisseur OAuth à Typo3 dans un tableau. Si vous ne voyez pas de valeur pour Prénom, Nom, E-mail ou Nom d'utilisateur, définissez les paramètres requis dans votre fournisseur OAuth pour renvoyer ces informations.
  • Vous avez configuré avec succès votre Typo3 en tant que client OAuth. Vous pouvez maintenant créer votre bouton SSO personnalisé dans votre site frontal Typo3 et y intégrer l'URL de la page FEOIDC pour lancer le SSO.
  • Typo3 OAuth 2.0 SSO Keycloak SSO

3 : Mappage d'attributs (facultatif). *Il s'agit d'une fonctionnalité Premium.

  • Vous pouvez mapper des attributs dans l'onglet Mappage d'attributs. Seuls le nom d'utilisateur et l'adresse e-mail peuvent être mappés dans la version gratuite de l'extension. Cependant, dans la version premium de l'extension, vous pouvez mapper divers attributs provenant de votre fournisseur OAuth aux attributs présents dans votre site Typo3.
  • Mappage d'attributs Typo3 OAuth Typo3 SSO

4 : Cartographie de groupe (facultatif). *Il s'agit d'une fonctionnalité Premium.

  • Vous pouvez spécifier un rôle par défaut dans l'extension gratuite qui sera attribué à tous les utilisateurs non-administrateurs lorsqu'ils effectuent le SSO.
  • Accédez à l’onglet Mappage de groupe et accédez à la section Mappage de groupe.
  • Sélectionnez le rôle par défaut et cliquez sur le bouton Enregistrer.
  • Keycloak Typo3 SSO - Connexion Keycloak Single Sign-On (SSO) dans Typo3 - mappage des rôles

En configurant Cape de clé en tant que Fournisseur OAuth et Typo3 en tant que Client OAuth en utilisant notre extension Typo3 OAuth Client, vous avez installé avec succès Typo3 Keycloak Single Sign-On (SSO). En quelques minutes, vous serez en mesure de fournir un accès sécurisé à votre site Typo3 en utilisant les informations de connexion Keycloak grâce à cette solution.

Ressources supplémentaires


Si vous recherchez un produit que vous ne trouvez pas, veuillez nous envoyer un courriel à info@xecurify.com

Bonjour!

Besoin d'aide? Nous sommes ici !

soutenez