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 de n'importe quel fournisseur de réclamation standard OAuth 2.0 et OpenID Connect 1.0.
L'extension Typo3 OAuth & OpenID Connect Single Sign-On (SSO) permet de se connecter à Typo3 en toute sécurité à l'aide de n'importe quel fournisseur OAuth et OpenID Connect tel qu'Azure AD, Azure B2C, Okta, Keycloak, Salesforce, etc. Advanced Single Sign-On SSO des fonctionnalités telles que le mappage d'attributs de profil utilisateur, le mappage de rôles, etc. sont également prises en charge dans cette extension. Cliquez ici pour en savoir plus sur les fonctionnalités premium des extensions Typo3 OAuth Single Sign-On (OAuth & OpenID Connect Client).
Dans ce guide, nous passerons en revue les étapes de configuration de l'extension miniOrange OAuth / OpenID Connect Single Sign-On SSO.
Procédure d'installation
1. Installation de l'extension OAuth Client / OpenID Connect dans TYPO3
- 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.
- 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.
- 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.)
- 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.
2. Intégrer l'extension à TYPO3
- Vous devez maintenant concevoir votre frontend en cliquant gauche sur l'onglet Accueil puis en cliquant sur Nouvelle sous-page
- Vous devez ajouter deux pages STANDARD dans la page ACCUEIL. 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).
- Entrez le nom de la page standard comme : FEOIDC.
- Cliquez sur Page FEOIDC et cliquez sur Ajouter du contenu. Allez dans les plugins et ajoutez Plugin FEOIDC.
- Accédez à l’onglet plugin et sélectionnez le plugin FEOIDC. Ajouter des utilisateurs de sites Web dans Page de stockage des enregistrements et enregistrez les paramètres.
- Si vous devez apporter des modifications au segment d'URL, qui sera également votre URL SSO initiale, faites un clic droit sur Page FEOIDC, sélectionnez modifier et cliquez sur "basculer l'URL" bouton pour définir l’URL selon votre chemin.
- 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 et le plug-in de déconnexion pour la page de déconnexion.
- Votre répertoire TYPO3 devrait ressembler à ceci.
- De plus, vous devez créer au moins un groupe car TYPO3 ne permet pas de créer des utilisateurs à moins qu'il n'y ait au moins un groupe d'utilisateurs.
- Pour créer un groupe, accédez à l'onglet Liste dans le panneau de gauche, cliquez sur le dossier Utilisateurs du site Web et appuyez sur le bouton "+" en haut de l'écran.
- Sélectionnez maintenant Groupe d'utilisateurs du site ? de la liste.
- Insérez le nom du groupe dans la section du titre du groupe et cliquez sur le bouton Enregistrer en haut. Un groupe d'utilisateurs sera créé.
- Vous pouvez également créer un bouton SSO sur la page de connexion. Cliquez sur Accueil, passez à la +Contenu option.
- Passez à l'onglet Éléments spéciaux et sélectionnez HTML brut.
- Ici, ce que vous allez faire est d'ajouter un bouton de connexion SSO, l'URL dans la section du bouton sera celle de la page standard FEOIDC.
- L'extrait de code pour ce faire est mentionné dans l'image donnée. Entrez le code et appuyez sur le bouton Enregistrer en haut.
- Vous pouvez maintenant configurer le plugin dans le backend.
3. Configurer le fournisseur OAuth
Voyons comment le fournisseur OAuth est configuré, ici nous considérerons Azure AD comme IDP. Si votre IDP est différent, vous pouvez accéder au guide de configuration complet de votre IDP souhaité à partir de ici.
- Connectez-vous à Portail Azure.
- Sélectionnez Azure Active Directory.
- Dans le volet de navigation de gauche, cliquez sur l'icône Inscriptions d'applications service, puis cliquez sur Nouvelle inscription.
- Lorsque la page Créer apparaît, entrez les informations d'enregistrement de votre application. (Reportez-vous au tableau ci-dessous)
| Nom: |
Nom de votre candidature. |
| Type de candidature : |
- Sélectionnez "Application Web/API" en applications clientes ainsi que applications de ressources/API qui sont installés sur un serveur sécurisé. Ce paramètre est utilisé pour la confidentialité OAuth clients web et public clients basés sur un agent utilisateur. La même application peut également exposer à la fois un client et une ressource/API.
|
|
URI de redirection : |
- Pour les applications "Application Web/API", indiquez l'URL de base de votre application. par exemple, https:// Il peut s'agir de l'URL d'une application Web exécutée sur votre ordinateur local. Les utilisateurs utiliseraient cette URL pour se connecter à une application client Web.
|
- Copiez l'URL de rappel à partir de l'extension du client miniOrange OAuth et enregistrez-la dans la zone de texte URL de redirection.
- Assurez-vous que le "Accorder le consentement de l'administrateur aux autorisations openid et offline_access" l’option est activée. Une fois terminé, cliquez sur Inscription.
- Azure AD attribue un ID d'application unique à votre application. Le ID d'application est votre identité du client et par ID de répertoire est votre ID du locataire, conservez ces valeurs à portée de main car vous en aurez besoin pour configurer l'extension client miniOrange OAuth.
- Cliquez sur Certificats et secrets dans le volet de navigation de gauche et cliquez sur Nouveau secret client. Entrez la description et l'heure d'expiration et cliquez sur ADD option.
- Copiez la clé secrète "valeur" et gardez la valeur à portée de main, elle sera nécessaire plus tard pour configurer Secret client sous l'extension miniOrange OAuth Client.
4. Configuration de TYPO3 en tant que client OAuth
5. Configuration des tests
- Cette fonctionnalité vous aidera à savoir si les configurations soumises sont correctes ou non. Vous obtiendrez également les attributs que vous avez configurés en réponse.
- Pour vérifier la configuration du test, allez dans le plugin OpenID Connect, puis dans l'onglet client OpenID Connect, en bas, vous trouverez le bouton Test Configuration, cliquez dessus, il vous montrera les résultats comme indiqué dans le diagramme donné.
6. Cartographie des attributs
- 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.
7. Cartographie de groupe
- 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.
Vous avez configuré avec succès votre Typo3 en tant que client OAuth. Vous verrez le bouton SSO sur votre frontend. Cliquez sur le bouton et testez le SSO.
Ressources additionnelles
Si vous cherchez quelque chose que vous ne trouvez pas, envoyez-nous un e-mail à info@xecurify.com
