Configurer VergeOS comme client OIDC

Guide étape par étape pour configurer un système ou un locataire VergeOS afin d’utiliser l’authentification OIDC avec un autre fournisseur d’identité VergeOS.

Vue d’ensemble

Points clés

• Configurer VergeOS pour utiliser l’authentification OIDC
• Se connecter à un fournisseur d’identité OIDC VergeOS
• Activer la création et la synchronisation automatiques des utilisateurs
• Personnaliser l’apparence et le comportement de la connexion

Ce guide explique comment configurer un système ou un tenant VergeOS afin de s’authentifier à l’aide d’un autre système VergeOS comme fournisseur d’identité OIDC.

Prérequis

• Accès au système fournisseur OIDC VergeOS
• URL de configuration bien connue du fournisseur
• ID client et secret client du fournisseur
• Accès administrateur au système client VergeOS
• URL complète du système client VergeOS

Étapes

1. Accéder aux paramètres d’autorisation

• Cliquez Système dans le menu supérieur
• Sélectionnez Sources d’authentification
• Cliquez Nouveau

2. Configurer les paramètres de base

• Nom: Saisissez un identifiant pour cette source d’authentification (s’affiche sur le bouton de connexion)
• Pilote : sélectionnez OpenID (configuration bien connue)
• URL de base: Saisissez l’URL de configuration bien connue
• URI de redirection: Saisissez l’URL complète de ce système VergeOS
• ID client: Collez l’ID client du fournisseur
• Secret client: Collez le secret client du fournisseur

3. Configurer les paramètres d’authentification

Les valeurs par défaut fonctionnent généralement le mieux pour ces paramètres :

• Paramètre de suggestion du jeton : laissez sur post_logout_redirect_uri
• Paramètre de redirection : laissez sur post_logout_redirect_uri
• Portée : laissez sur openid profile email groups
• Portée des groupes : laissez sur groups

4. Activer les options recommandées

Cochez ces cases pour une fonctionnalité optimale :

• Décoder le jeton ID
• Mettre à jour l’utilisateur distant
• Mettre à jour l’adresse e-mail de l’utilisateur
• Mettre à jour le nom d’affichage de l’utilisateur
• Mettre à jour l’appartenance aux groupes

5. Configurer la création des utilisateurs

Choisissez votre méthode préférée de création des utilisateurs :

• Création automatique des utilisateurs: Saisissez .* pour créer automatiquement tous les utilisateurs
• Création automatique des utilisateurs dans le groupe: Spécifiez les groupes pour une création automatique limitée

6. Personnaliser l’apparence de la connexion

Vous pouvez éventuellement configurer :

• Couleur d’arrière-plan du bouton
• Couleur du texte du bouton
• Icône Font Awesome personnalisée
• Couleur de l’icône (à l’aide de codes HEX)

7. Enregistrer la configuration

• Cliquez Soumettre pour créer la source d’autorisation

Bonnes pratiques

• Testez l’authentification avec un utilisateur de test avant un déploiement à grande échelle
• Laissez le mode de débogage désactivé sauf en cas de dépannage
• Documentez vos choix de configuration pour référence future
• Vérifiez régulièrement que la synchronisation des utilisateurs fonctionne comme prévu

Dépannage

Problèmes courants

• L’authentification échoue

  • Vérifiez que l’ID client et le secret sont corrects
  • Vérifiez l’URL de configuration bien connue
  • Assurez-vous que l’URI de redirection correspond exactement
• Problèmes de synchronisation des utilisateurs

  • Vérifiez que la portée des groupes est activée
  • Vérifiez les paramètres d’appartenance aux groupes
  • Activez temporairement le mode de débogage
• Bouton de connexion manquant

  • Vérifiez que la source d’autorisation est activée
  • Vérifiez les paramètres de style de connexion
  • Videz le cache du navigateur

Ressources supplémentaires

• Référence des icônes Font Awesome
• Configurer VergeOS en tant que fournisseur OIDC

Retour

Besoin d’aide ?

Si vous rencontrez des problèmes lors de la configuration des paramètres du client OIDC ou si vous avez des questions sur ce processus, n’hésitez pas à contacter notre équipe d’assistance.

---

Informations sur le document

• Dernière mise à jour : 2024-01-22
• Version VergeOS : 4.12 et ultérieures