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 le SSO pour Black Duck via le protocole SAML
Pour cette tâche, vous devez être connecté en tant que super-administrateur.Avant de commencer
Vous pouvez utiliser Black Duck sur Google Compute Engine (GCE), Amazon Web Services (AWS) ou Azure. Pour obtenir les instructions d'installation, consultez la documentation de Black Duck associée à la plate-forme cloud utilisée.
Étape 1 : Définissez 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 Blackduck.
-
Dans les résultats de recherche, pointez sur Blackduck et cliquez sur Sélectionner.
-
Dans la fenêtre Informations sur le fournisseur d'identité Google, téléchargez les métadonnées du fournisseur d'identité.
-
Cliquez sur Continuer.
-
Sur la page Détails relatifs au fournisseur de services , remplacez {your-domain} par le domaine sur lequel Black Duck est installé dans les champs URL ACS et ID d'entité.
-
Cliquez sur Continuer.
-
Dans la fenêtre Mappage des attributs, cliquez sur Sélectionner un champ et mappez les attributs de l'annuaire Google suivants aux attributs Black Duck correspondants. Les attributs FirstName, LastName, Email et Name sont obligatoires.
Attribut d'annuaire Google Attribut Black Duck Informations générales > Prénom FirstName Informations générales > Nom LastName Informations générales > Adresse e-mail principale Email Informations générales > Adresse e-mail principale Nom - (Facultatif) Pour ajouter d'autres mappages, cliquez sur Ajouter un mappage , puis sélectionnez les champs à mapper.
-
(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 correspondant des groupes du fournisseur de services.
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éfinissez Black Duck comme fournisseur de services SAML 2.0
-
Ouvrez une fenêtre de navigation privée dans votre navigateur, accédez à la page de connexion à Black Duck, puis connectez-vous avec votre compte administrateur Black Duck.
-
Cliquez sur Administration et sélectionnez SAML Integration (Intégration SAML).
-
Cochez la case Enable SAML (Activer SAML).
-
Dans le champ Service Providers Entity URL (URL d'entité du fournisseur de services), saisissez l'URL du serveur Hub.
-
Dans le champ Identity Provider Metadata (Métadonnées du fournisseur d'identité), collez les métadonnées du fournisseur d'identité que vous avez téléchargées à l'étape 1.
-
Cliquez sur Save (Enregistrer).
-
Connectez-vous au serveur Hub à l'aide du protocole Secure Shell (SSH).
-
Dans le répertoire docker-compose, ajoutez la ligne suivante à la fin du fichier hub-proxy.env : HUB_SAML_EXTERNAL_URL={url-to-the-hub}.
-
Remplacez {url-to-the-hub} par l'URL de l'instance sur laquelle Black Duck est installé.
-
Redémarrez l'instance Hub.
Étape 3 : Activez 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 Blackduck.
- 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 de votre compte utilisateur Black Duck correspondent au domaine principal du compte Google géré de votre organisation.
Étape 4 : Vérifiez le bon fonctionnement de l'authentification unique
Black Duck n'est compatible avec l'authentification unique que si vous vous connectez depuis Google. Vous ne pourrez pas en bénéficier si vous vous connectez directement sur Black Duck.
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 Blackduck.
-
Dans la section Blackduck, 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.
Google, Google Workspace et les marques et logos associés sont des marques de 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.