Partager via

Intégration de l’authentification unique Microsoft Entra avec FTAPI

  • Article

Dans ce tutoriel, vous apprendrez comment intégrer FTAPI à Microsoft Entra ID. Lorsque vous intégrez FTAPI à Microsoft Entra ID, vous pouvez :

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

Prérequis

Pour intégrer Microsoft Entra ID à FTAPI, vous avez besoin des éléments suivants :

  • Un abonnement Microsoft Entra. Si vous ne disposez d’aucun abonnement, vous pouvez obtenir un compte gratuit.
  • Un abonnement FTAPI 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.

  • FTAPI prend en charge l’authentification unique lancée par le fournisseur de services.
  • FTAPI prend en charge le provisionnement d’utilisateurs juste-à-temps.

Pour configurer l’intégration de FTAPI dans Microsoft Entra ID, vous devez ajouter FTAPI depuis 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 FTAPI dans la zone de recherche.
  4. Sélectionnez FTAPI 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 aussi parcourir les étapes de configuration de l’authentification unique. En savoir plus sur les assistants Microsoft 365.

Configurer et tester l’authentification unique Microsoft Entra pour FTAPI

Configurez et testez l’authentification unique Microsoft Entra avec FTAPI en utilisant un utilisateur 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 associé dans FTAPI.

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

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

Configurer Microsoft Entra SSO

Suivez ces étapes pour activer l’authentification unique Microsoft Entra dans le centre d’administration 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>FTAPI>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.

    Screenshot shows how to edit Basic SAML Configuration.

  5. Dans la section Configuration SAML de base, effectuez les étapes suivantes :

    a. Dans la zone de texte Identificateur (ID d’entité) , saisissez une URL au format suivant : https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    b. Dans la zone de texte URL de réponse, tapez une URL au format suivant : https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    c. Dans la zone de texte URL de connexion, saisissez une URL au format suivant : https://<ENVIRONMENT>.<DOMAIN>.<EXTENSION>

    Remarque

    Il ne s’agit pas de valeurs réelles. Mettez à jour ces valeurs avec l’identificateur, l’URL d’authentification et l’URL de réponse réels. Pour obtenir ces valeurs, contactez l’équipe du support technique de FTAPI. Vous pouvez également consulter les modèles figurant à la section Configuration SAML de base dans le centre d’administration Microsoft Entra.

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

    image

  7. En plus de ce qui précède, l’application FTAPI 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
    phonenumber user.telephonenumber
    companyname user.companyname
    role user.assignedroles

    Remarque

    Veuillez cliquer ici pour savoir comment configurer le rôle dans Microsoft Entra ID.

  8. Dans la page Configurer l’authentification unique avec SAML, dans la section Certificat de signature SAML, recherchez XML de métadonnées de fédération et sélectionnez Télécharger pour télécharger le certificat et l’enregistrer sur votre ordinateur.

    Screenshot shows the Certificate download link.

  9. Dans la section Configurer FTAPI, copiez les URL appropriées en fonction de vos besoins.

    Screenshot shows to copy configuration URLs.

Créer un utilisateur de test Microsoft Entra ID

Dans cette section, vous créez un utilisateur test dans le centre d’administration Microsoft Entra 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 de test Microsoft Entra ID

Dans cette section, vous allez permettre à B.Simon d’utiliser l’authentification unique Microsoft Entra en accordant l’accès à FTAPI.

  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>FTAPI.
  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 avec FTAPI

Pour configurer l’authentification unique côté FTAPI, vous devez envoyer le fichier XML des métadonnées de fédération téléchargé et les URL appropriées copiées depuis le centre d’administration Microsoft Entra à l’équipe du support technique FTAPI. Celles-ci configurent ensuite ce paramètre pour que la connexion SSO SAML soit définie correctement des deux côtés.

Créer un utilisateur test FTAPI

Dans cette section, un utilisateur nommé Britta Simon est créé dans FTAPI. FTAPI prend en charge l’attribution d’utilisateurs juste-à-temps, option activée par défaut. Vous n’avez aucune opération à effectuer dans cette section. S’il n’existe pas encore d’utilisateur dans FTAPI, il en est créé un après l’authentification.

Tester l’authentification unique (SSO)

Dans cette section, vous testez votre configuration d’authentification unique Microsoft Entra avec les options suivantes.

  • Cliquez sur Tester cette application dans le centre d’administration Microsoft Entra. Vous êtes alors redirigé vers l’URL de connexion de FTAPI, à partir de laquelle vous pouvez lancer le flux de connexion.

  • Accédez directement à l’URL de connexion à FTAPI pour lancer le flux de connexion.

  • Vous pouvez utiliser Mes applications de Microsoft. Quand vous cliquez sur la vignette FTAPI dans Mes applications, vous êtes redirigé vers l’URL d’authentification FTAPI. Pour plus d’informations sur Mes applications, consultez Présentation de Mes applications.

Étapes suivantes

Une fois que vous avez configuré FTAPI, 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.