La norme SAML (Security Assertion Markup Language) 2.0 vous permet de configurer l'authentification unique (SSO) pour un certain nombre d'applications cloud. Une fois l'authentification unique configurée, vos utilisateurs peuvent se connecter à une application à l'aide de leurs identifiants Google Workspace.
Configurer l'authentification unique pour Jenkins à l'aide de SAML
Pour cette tâche, vous devez être connecté en tant que super-administrateur.Étape 1 : Configurer Google comme fournisseur d'identité SAML
-
Dans la console d'administration Google, accédez à Menu
Applications
Applications Web et mobiles.
Pour cette tâche, vous devez être connecté en tant que super-administrateur.
-
Cliquez sur Ajouter une application
Rechercher des applications.
- Dans le champ Saisissez le nom de l'application, saisissez Jenkins.
- Dans les résultats de recherche, pointez sur Jenkins Web (SAML) et cliquez sur Sélectionner.
-
Dans la fenêtre Informations sur le fournisseur d'identité Google, pour Option 2 : Copier l'URL SSO, l'ID d'entité et le certificat :
- À côté du champ URL SSO, cliquez sur Copier
et enregistrez l'URL.
- À côté de ID d'entité, cliquez sur Copier
et enregistrez l'ID d'entité.
- À côté de Certificat, cliquez sur Copier
et enregistrez le certificat.
Vous en aurez besoin pour effectuer la configuration dans Jenkins.
- À côté du champ URL SSO, cliquez sur Copier
- Cliquez sur Continuer.
Sur la page Détails relatifs au fournisseur de services, les informations sur l'application sont configurées par défaut. - Saisissez l'URL ACS et l'ID d'entité. Pour en savoir plus, consultez SAML Single Sign On (SSO) into Jenkins using Google Apps as IDP.
- Cliquez sur Continuer.
-
(Facultatif) Pour mapper les attributs d'annuaire Google aux attributs de l'application correspondants, dans la fenêtre Mappage d'attributs :
- Cliquez sur Ajouter un mappage.
- Cliquez sur Sélectionner un champ
sélectionnez un attribut d'annuaire Google.
- Sous Attributs de l'application, saisissez l'attribut de l'application correspondant.
-
(Facultatif) Pour saisir des noms de groupes pertinents pour cette application :
- Dans le champ Appartenance à un groupe (facultatif), cliquez sur Rechercher un groupe, saisissez une ou plusieurs lettres du nom du groupe, puis sélectionnez-en un.
- Ajoutez des groupes si nécessaire (75 groupes au maximum).
- Sous Attribut de l'application, saisissez le nom d'attribut des groupes du fournisseur de services correspondant.
Quel que soit le nombre de noms de groupes saisis, la réponse SAML inclut uniquement les groupes dont un utilisateur est membre (directement ou indirectement). Pour en savoir plus, consultez À propos du mappage des informations d'appartenance à un groupe.
- Cliquez sur Terminer.
Étape 2 : Définir Jenkins comme fournisseur de services SAML 2.0
- Ouvrez une nouvelle fenêtre de navigation privée dans votre navigateur, accédez à la page de connexion à Jenkins , puis connectez-vous avec votre compte administrateur Jenkins.
- Cliquez sur le nom de votre compte.
- Cliquez sur Manage Jenkins (Gérer Jenkins)
Configure Global Security (Configurer la sécurité globale).
- Cochez la case Enable Security (Activer la sécurité).
- Dans le champ Security Realm (Domaine de sécurité), sélectionnez miniOrange SAML 2.0.
- Cliquez sur Configurer.
- Dans le champ IdP configuration (Configuration IdP), collez le contenu du fichier de métadonnées téléchargé à l'étape 1.
- Cliquez sur Test Configuration (Tester la configuration).
Vous devriez être redirigé vers la page de connexion Google.
Étape 3 : Activer l'application pour les utilisateurs
-
Dans la console d'administration Google, accédez à Menu
Applications
Applications Web et mobiles.
Pour cette tâche, vous devez être connecté en tant que super-administrateur.
- Cliquez sur Jenkins.
- Cliquez sur Accès des utilisateurs.
-
Pour activer ou désactiver un service pour tous les membres de votre organisation, cliquez sur Activé pour tous ou sur Désactivé pour tous, puis sur Enregistrer.
-
(Facultatif) Pour activer ou désactiver un service pour une unité organisationnelle :
- Sur la gauche, sélectionnez l'unité organisationnelle.
- Pour modifier l'état du service, sélectionnez Activé ou Désactivé.
- Choisissez une option :
- Si l'état du service est défini sur Hérité et que vous souhaitez conserver le paramètre mis à jour, même si le paramètre parent est modifié, cliquez sur Remplacer.
- Si l'état du service est défini sur Remplacé, cliquez sur Hériter pour rétablir le paramètre parent, ou cliquez sur Enregistrer pour conserver le nouveau paramètre, même si le paramètre parent est modifié.
En savoir plus sur la structure organisationnelle.
- (Facultatif) Pour activer un service pour un ensemble d'utilisateurs dans une ou plusieurs unités organisationnelles, sélectionnez un groupe d'accès. Pour en savoir plus, consultez Personnaliser l'accès aux services à l'aide de groupes d'accès.
- Vérifiez que les domaines de messagerie des comptes utilisateur Jenkins correspondent au domaine principal du compte Google géré de votre organisation.
Étape 4 : Vérifier le bon fonctionnement de l'authentification unique
Jenkins est compatible à la fois avec l'authentification unique initiée par le fournisseur d'identité et celle initiée par le fournisseur de services.
Vérifier l'authentification unique initiée par le fournisseur d'identité
-
Dans la console d'administration Google, accédez à Menu
Applications
Applications Web et mobiles.
Pour cette tâche, vous devez être connecté en tant que super-administrateur.
- Cliquez sur Jenkins.
- Dans la section Jenkins, cliquez sur Tester la connexion SAML.
L'application s'ouvre dans un onglet distinct. Si ce n'est pas le cas, corrigez le message d'erreur, puis réessayez. Pour savoir comment résoudre les problèmes, consultez Messages d'erreur liés aux applications SAML.
Vérifier l'authentification unique initiée par le fournisseur de services
- Fermez toutes les fenêtres du navigateur.
- Accédez à la page de connexion à Jenkins, puis connectez-vous avec votre compte administrateur Jenkins.
Vous devriez être redirigé vers la page de connexion Google. - Sélectionnez votre compte et saisissez votre mot de passe.
Une fois vos identifiants authentifiés, l'application doit s'ouvrir.
Google, Google Workspace, ainsi que les marques et logos associés sont des marques appartenant à Google LLC. Tous les autres noms de sociétés et de produits sont des marques des sociétés auxquelles ils sont associés.