Tutoriel : Intégration de l’authentification unique (SSO) Microsoft Entra à EasySSO for Bamboo

  • Article

Dans ce tutoriel, vous apprenez à intégrer EasySSO for Bamboo à Microsoft Entra ID. Quand vous intégrez EasySSO for Bamboo à Microsoft Entra ID, vous pouvez :

  • Contrôler dans Microsoft Entra ID qui a accès à Bamboo.
  • Permettre à vos utilisateurs d’être automatiquement connectés à Bamboo avec leur compte Microsoft Entra.
  • Gérer vos comptes à partir d’un emplacement central.

Prérequis

Pour commencer, vous devez disposer de ce qui suit :

  • Un abonnement Microsoft Entra. Si vous ne disposez d’aucun abonnement, vous pouvez obtenir un compte gratuit.
  • Un abonnement EasySSO pour Bamboo pour lequel l’authentification unique est activée

Description du scénario

Dans ce tutoriel, vous configurez et testez Microsoft Entra SSO dans un environnement de test.

  • EasySSO pour Bamboo prend en charge l’authentification unique lancée par le fournisseur de services et le fournisseur d’identité.
  • EasySSO pour Bamboo prend en charge l’affectation d’utilisateurs juste-à-temps.

Pour configurer l’intégration d’EasySSO for Bamboo à Microsoft Entra ID, vous devez ajouter EasySSO for Bamboo à partir de la galerie à votre liste d’applications SaaS managées.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
  2. Accédez à Identité>Applications>Applications d’entreprise>Nouvelle application.
  3. Dans la section Ajouter à partir de la galerie, tapez EasySSO pour Bamboo dans la zone de recherche.
  4. Sélectionnez EasySSO pour Bamboo dans le volet de résultats, puis ajoutez l’application. Patientez quelques secondes pendant que l’application est ajoutée à votre locataire.

Vous pouvez également utiliser l’assistant Entreprise App Configuration. Dans cet assistant, vous pouvez ajouter une application à votre locataire, ajouter des utilisateurs/groupes à l’application, attribuer des rôles, mais également parcourir la configuration de l’authentification unique. En savoir plus sur les assistants Microsoft 365.

Configurer et tester SSO Microsoft Entra pour EasySSO for Bamboo

Configurez et testez SSO Microsoft Entra avec EasySSO for Bamboo pour un utilisateur de test appelé B.Simon. Pour que SSO fonctionne, vous devez établir une liaison entre un utilisateur Microsoft Entra et l’utilisateur EasySSO for Bamboo associé.

Pour configurer et tester SSO Microsoft Entra avec EasySSO for Bamboo, effectuez les étapes suivantes :

  1. Configurez l’authentification unique Microsoft Entra pour permettre à vos utilisateurs d’utiliser cette fonctionnalité.
    1. Créez un utilisateur de test Microsoft Entra pour tester l’authentification unique Microsoft Entra avec B.Simon.
    2. Attribuer l’utilisateur test Microsoft Entra – pour permettre à B.Simon d’utiliser l’authentification unique Microsoft Entra.
  2. Configurer l’authentification unique EasySSO pour Bamboo pour configurer les paramètres de l’authentification unique côté application.
    1. Créer un utilisateur de test EasySSO for Bamboo, pour avoir dans EasySSO for Bamboo un équivalent de B.Simon lié à la représentation Microsoft Entra de l’utilisateur.
  3. Tester l’authentification unique pour vérifier si la configuration fonctionne.

Configurer Microsoft Entra SSO

Effectuez ces étapes pour activer l’authentification unique Microsoft Entra.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.

  2. Accédez à Identité>Applications>Applications d’entreprise>EasySSO for Bamboo>Authentification unique.

  3. Dans la page Sélectionner une méthode d’authentification unique, sélectionnez SAML.

  4. Dans la page Configurer l’authentification unique avec SAML, cliquez sur l’icône de crayon de Configuration SAML de base afin de modifier les paramètres.

    Edit Basic SAML Configuration

  5. Dans la section Configuration SAML de base, si vous souhaitez configurer l’application en mode lancé par le fournisseur d’identité, effectuez les étapes suivantes :

    a. Dans la zone de texte Identificateur, tapez une URL au format suivant : https://<SERVER_BASE_URL>/plugins/servlet/easysso/saml

    b. Dans la zone de texte URL de réponse, tapez une URL au format suivant : https://<SERVER_BASE_URL>/plugins/servlet/easysso/saml

  6. Si vous souhaitez configurer l’application en mode démarré par le fournisseur de services, cliquez sur Définir des URL supplémentaires, puis effectuez les étapes suivantes :

    Dans la zone de texte URL de connexion, tapez une URL au format suivant : https://<SERVER_BASE_URL>/login.jsp.

    Remarque

    Il ne s’agit pas de valeurs réelles. Mettez à jour ces valeurs avec l’identificateur, l’URL de réponse et l’URL de connexion réels. En cas de doute, contactez l’équipe du support technique EasySSO pour obtenir ces valeurs. Vous pouvez également consulter les modèles figurant à la section Configuration SAML de base.

  7. L’application EasySSO pour Bamboo attend les assertions SAML dans un format spécifique, ce qui vous oblige à ajouter des mappages d’attributs personnalisés à votre configuration d’attributs de jetons SAML. La capture d’écran suivante montre la liste des attributs par défaut.

    image

  8. En plus de ce qui précède, l’application EasySSO pour Bamboo s’attend à ce que quelques attributs supplémentaires (présentés ci-dessous) soient repassés dans la réponse SAML. Ces attributs sont également préremplis, mais vous pouvez les examiner pour voir s’ils répondent à vos besoins.

    Nom Attribut source
    urn:oid:0.9.2342.19200300.100.1.1 user.userprincipalname
    urn:oid:0.9.2342.19200300.100.1.3 user.mail
    urn:oid:2.16.840.1.113730.3.1.241 user.displayname
    urn:oid:2.5.4.4 user.surname
    urn:oid:2.5.4.42 user.givenname

    Si vos utilisateurs Microsoft Entra ont sAMAccountName configuré, vous devez mapper urn:oid:0.9.2342.19200300.100.1.1 à l’attribut sAMAccountName.

  9. Dans la page Configurer l’authentification unique avec SAML, à la section Certificat de signature SAML, cliquez sur les liens Télécharger pour les options Certificat (Base64) ou XML de métadonnées de fédération, puis enregistrez l’un des deux, ou les deux, sur votre ordinateur. Vous en aurez besoin ultérieurement pour configurer EasySSO pour Bamboo.

    The Certificate download link

    Si vous voulez configurer manuellement EasySSO for Bamboo avec un certificat, vous devez également copier l’URL de connexion et l’Identificateur Microsoft Entra dans la section ci-dessous, puis les enregistrer sur votre ordinateur.

Créer un utilisateur de test Microsoft Entra

Dans cette section, vous allez créer un utilisateur de test appelé B.Simon.

  1. Connectez-vous au Centre d’administration de Microsoft Entra en tant qu’Administrateur de l’utilisateur.
  2. Accédez à Identité>Utilisateurs>Tous les utilisateurs.
  3. Sélectionnez Nouvel utilisateur>Créer un utilisateur dans la partie supérieure de l’écran.
  4. Dans les propriétés Utilisateur, effectuez les étapes suivantes :
    1. Dans le champ Nom d’affichage, entrez B.Simon.
    2. Dans le champ Nom d’utilisateur principal, entrez username@companydomain.extension. Par exemple : B.Simon@contoso.com.
    3. Cochez la case Afficher le mot de passe, puis notez la valeur affichée dans le champ Mot de passe.
    4. Sélectionnez Revoir + créer.
  5. Sélectionnez Create (Créer).

Attribuer l’utilisateur test Microsoft Entra

Dans cette section, vous allez autoriser B.Simon à utiliser l’authentification unique en lui accordant l’accès à EasySSO for Bamboo.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
  2. Accédez à Identité>Applications>Applications d’entreprise>EasySSO for Bamboo.
  3. Dans la page de présentation de l’application, sélectionnez Utilisateurs et groupes.
  4. Sélectionnez Ajouter un utilisateur/groupe, puis Utilisateurs et groupes dans la boîte de dialogue Ajouter une attribution.
    1. Dans la boîte de dialogue Utilisateurs et groupes, sélectionnez B. Simon dans la liste Utilisateurs, puis cliquez sur le bouton Sélectionner au bas de l’écran.
    2. Si vous attendez qu’un rôle soit attribué aux utilisateurs, vous pouvez le sélectionner dans la liste déroulante Sélectionner un rôle . Si aucun rôle n’a été configuré pour cette application, vous voyez le rôle « Accès par défaut » sélectionné.
    3. Dans la boîte de dialogue Ajouter une attribution, cliquez sur le bouton Attribuer.

Configurer l’authentification unique côté EasySSO pour Bamboo

  1. Dans une autre fenêtre de navigateur web, connectez-vous à votre site d’entreprise Zoom en tant qu’administrateur

  2. Accédez à la section Gérer les applications.

    Manage Apps

  3. Sur le côté gauche, recherchez EasySSO, puis cliquez dessus.

    Easy SSO

  4. Sélectionnez l’option SAML. Vous accédez alors à la section de configuration SAML.

    SAML

  5. Sélectionnez l’onglet Certificats en haut. L’écran suivant s’affiche alors :

    Metadata URL

  6. À présent, recherchez le Certificat (Base64) ou le Fichier de métadonnées que vous avez enregistré aux étapes précédentes de la configuration de l’authentification unique Microsoft Entra. Vous avez le choix entre les options suivantes :

    a. Utilisez le fichier de métadonnées de fédération d’application que vous avez téléchargé dans un fichier local sur votre ordinateur. Sélectionnez la case d’option Charger, puis suivez les instructions de la boîte de dialogue de chargement de fichier spécifique à votre système d’exploitation.

    OR

    b. Ouvrez le fichier de métadonnées de fédération d’application pour afficher le contenu (dans n’importe quel éditeur de texte brut) du fichier, et copiez-le dans le Presse-papiers. Sélectionnez l’option Input (Entrée) et collez le contenu du Presse-papiers dans le champ de texte.

    OR

    c. Configuration entièrement manuelle Ouvrez le certificat (Base64) de fédération d’application pour afficher le contenu (dans n’importe quel éditeur de texte brut) du fichier, et copiez-le dans le Presse-papiers. Collez-le dans le champ de texte IdP Token Signing Certificates (Certificats de signature de jetons IdP). Accédez ensuite à l’onglet General et renseignez les champs URL de liaison POST et ID d’entité avec les valeurs respectives d’URL de connexion et d’Identificateur Microsoft Entra que vous avez enregistrées plus tôt.

  7. Cliquez sur le bouton Save en bas de la page. Le contenu des fichiers de métadonnées ou de certificat sera alors analysé dans les champs de configuration. La configuration d’EasySSO pour Bamboo est terminée.

  8. Pour une expérience de test optimale, accédez à l’onglet Look & Feel (Apparence) et cochez l’option SAML Login Button (Bouton de connexion SAML). Cela active un bouton distinct dans l’écran de connexion Bamboo pour tester votre intégration SAML Microsoft Entra de bout en bout. Vous pouvez également laisser ce bouton activé et configurer son emplacement, sa couleur et sa traduction pour le mode de production.

    Look & Feel

    Remarque

    En cas de problème, contactez l’équipe de support EasySSO.

Créer un utilisateur de test EasySSO pour Bamboo

Dans cette section, un utilisateur appelé Britta Simon est créé dans Bamboo. EasySSO pour Bamboo prend en charge le provisionnement d’utilisateurs juste-à-temps, option désactivée par défaut. Pour activer le provisionnement d’utilisateurs, vous devez activer explicitement l’option Create user on successful login (Créer un utilisateur lors d’une connexion réussie) dans la section General de la configuration du plug-in EasySSO. S’il n’existe pas encore d’utilisateur dans Bamboo, il en est créé un après l’authentification.

Toutefois, si vous ne souhaitez pas activer le provisionnement automatique d’utilisateurs lors de la première connexion, les utilisateurs doivent exister dans les répertoires utilisateurs back-end utilisés par l’instance de Bamboo, comme LDAP ou Atlassian Crowd.

User provisioning

Tester l’authentification unique (SSO)

Workflow lancé par le fournisseur d’identité

Dans cette section, vous testez votre configuration d’authentification unique Microsoft Entra à l’aide de Mes applications.

Quand vous cliquez sur la vignette EasySSO for Bamboo dans Mes applications, vous devez être connecté automatiquement à l’instance de Bamboo pour laquelle vous avez configuré l’authentification unique. Pour plus d’informations sur Mes applications, consultez Présentation de Mes applications.

Workflow lancé par le fournisseur de services

Dans cette section, vous testez la configuration de l’authentification unique Microsoft Entra en utilisant le bouton SAML Login de Bamboo.

User SAML login

Ce scénario part du principe que vous avez activé le bouton de connexion SAML sous l’onglet Look & Feel dans votre page de configuration EasySSO pour Bamboo (voir ci-dessus). Ouvrez votre URL de connexion Bamboo en mode incognito du navigateur pour éviter toute interférence avec vos sessions existantes. Cliquez sur le bouton SAML Login. Vous êtes alors redirigé vers le flux d’authentification d’utilisateur Microsoft Entra. Une fois l’opération terminée, vous serez redirigé vers votre instance de Bamboo en tant qu’utilisateur authentifié par le biais de SAML.

Il est possible que vous voyiez l’écran suivant après avoir été redirigé à partir de Microsoft Entra ID.

EasySSO failure screen

Dans ce cas, vous devez suivre les instructions fournies dans cette page pour accéder au fichier atlassian-bamboo.log. Les détails de l’erreur sont disponibles en fonction de l’ID de référence figurant dans la page d’erreur EasySSO.

En cas de problème pour synthétiser les messages du journal, contactez l’équipe de support technique d’EasySSO.

Étapes suivantes

Après avoir configuré EasySSO for Bamboo, vous pouvez appliquer le contrôle de session, qui protège contre l’exfiltration et l’infiltration des données sensibles de votre organisation en temps réel. Le contrôle de session est étendu à partir de l’accès conditionnel. Découvrez comment appliquer un contrôle de session avec Microsoft Defender for Cloud Apps.