Partager via

Tutoriel : Intégration de l’authentification unique Microsoft Entra avec EasySSO for Jira

  • Article

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

  • Contrôler dans Microsoft Entra ID qui a accès à Jira.
  • Permettre à vos utilisateurs d’être automatiquement connectés à Jira avec leurs comptes 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 for Jira 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 for Jira prend en charge l’authentification unique lancée par le fournisseur de services et le fournisseur d’identité.
  • EasySSO for Jira prend en charge le provisionnement d’utilisateurs juste-à-temps.

Pour configurer l’intégration d’EasySSO for Jira dans Microsoft Entra ID, vous devez ajouter EasySSO for Jira, disponible dans la galerie, à votre liste d’applications SaaS géré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 for Jira dans la zone de recherche.
  4. Sélectionnez EasySSO for Jira 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 l’authentification unique Microsoft Entra pour EasySSO for Jira

Configurez et testez l’authentification unique Microsoft Entra avec EasySSO for Jira pour un utilisateur de test appelé B.Simon. Pour que l’authentification unique fonctionne, vous devez établir une relation de lien entre un utilisateur Microsoft Entra et l’utilisateur EasySSO for Jira associé.

Pour configurer et tester l’authentification unique Microsoft Entra avec EasySSO for Jira, effectuez les étapes suivantes :

  1. Configurer Microsoft Entra SSO – 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 for Jira pour configurer les paramètres de l’authentification unique côté application.
    1. Créer un utilisateur de test EasySSO for Jira pour avoir dans EasySSO for Jira un équivalent de B.Simon lié à la représentation Microsoft Entra associée.
  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 pour Jira>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. Votre application EasySSO for Jira 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 jeton 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 for Jira 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 Jira.

    The Certificate download link

    Si vous envisagez d’effectuer une configuration d’EasySSO for Jira manuellement 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 Jira.

  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 pour Jira.
  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 (SSO) côté EasySSO for Jira

  1. Connectez-vous à votre instance d’Atlassian Jira avec des privilèges d’administrateur et accédez à la section Manage Apps (Gérer les applications).

    Manage Apps

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

    Easy SSO

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

    SAML

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

    Metadata URL

  5. À 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.

  6. 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 Jira est terminée.

  7. 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). Un bouton distinct sera alors présent sur l’écran de connexion JIRA 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 for Jira

Dans cette section, un utilisateur appelé Britta Simon est créé dans Jira. EasySSO pour Jira 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 Jira, 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 Jira, 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 avec les options suivantes.

  • Cliquez sur Tester cette application. Vous êtes alors connecté automatiquement à l’instance de EasySSO pour Jira pour laquelle vous avez configuré l’authentification unique.

Vous pouvez aussi utiliser Mes applications de Microsoft pour tester l’application dans n’importe quel mode. Si, quand vous cliquez sur la vignette EasySSO for Jira dans Mes applications, le mode Fournisseur de services est configuré, vous êtes redirigé vers la page de connexion de l’application pour lancer le flux de connexion ; s’il s’agit du mode Fournisseur d’identité, vous êtes automatiquement connecté à l’instance EasySSO for Jira 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 Jira.

User SAML login

Ce scénario suppose que vous avez activé le bouton de connexion SAML sous l’onglet Apparence dans votre page de configuration EasySSO pour Jira (voir ci-dessus). Ouvrez votre URL de connexion Jira 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 Jira 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-jira.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 Jira, 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.