Utiliser l’application Entra existante dans TeamsFx

Cette section explique comment connecter Microsoft Entra ID à votre projet TeamsFx, soit en utilisant une inscription d’application Entra existante, soit en en créant une nouvelle. Suivez les étapes pour définir les paramètres d’authentification et les valeurs TeamsFx nécessaires avant d’exécuter ou de déployer votre agent ou application.

Créer une application Microsoft Entra

Remarque

Vous pouvez ignorer cette partie si vous disposez déjà d’une application Microsoft Entra. Cette étape peut être automatisée par l’action aadApp/create .

  1. Accédez au Portail Azure et sélectionnez Microsoft Entra ID.

  2. Sélectionner Inscriptions d’applications>Nouvelle inscription pour créer une application Microsoft Entra. Ajoutez les détails suivants :

    1. Nom : nom de votre application de configuration.
    2. Types de comptes pris en charge : sélectionnez Compte dans ce répertoire organisationnel uniquement.
    3. Laissez le champ URL de redirection vide pour l’instant.
    4. Sélectionner Inscription.

  3. Une fois l’application inscrite, vous êtes redirigé vers sa page Vue d’ensemble . Copiez l’ID d’application (client),l’ID d’objet et l’ID de répertoire (locataire) pour une utilisation ultérieure. Vérifiez que le type de compte pris en charge est défini sur Mon organisation uniquement.

Créer une clé secrète client pour l’application Microsoft Entra (facultatif)

Remarque

Vous pouvez ignorer cette partie si votre agent ou votre application ne nécessite pas de secret client. Cette étape peut être automatisée par l’action aadApp/create .

  1. Accédez à la page Certificats & secrets de l’application, sélectionnez Secret client , puis Nouveau secret client. Sélectionnez les détails suivants :

    1. Description : description de votre clé secrète client.
    2. Expire : heure d’expiration de votre clé secrète client.
    3. Sélectionnez Ajouter.

  2. Lorsque la clé secrète client est ajoutée, appuyez sur le bouton Copier sous la colonne Valeur pour copier la clé secrète client.

Créer un accès en tant qu’étendue d’utilisateur pour l’application Microsoft Entra (facultatif)

Remarque

Vous pouvez ignorer cette partie si votre compte Microsoft 365 est autorisé à mettre à jour l’application Microsoft Entra. Agents Toolkit définit l’étendue de l’application. Cette étape peut être automatisée par l’action aadApp/update .

  1. Accédez à la page Exposer une API de l’application, sélectionnez Ajouter une étendue sous Étendues définies par cette API et suivez les étapes indiquées :

    1. Sélectionnez Enregistrer et continuer.
    2. Nom de la portée : renseignez access_as_user.
    3. Qui peut donner son consentement ? : choisissez Administrateurs et utilisateurs.
    4. Administration nom complet de consentement : Renseigner Teams peut accéder aux API web de l’application.
    5. Administration description du consentement : Renseigner Permet à Teams d’appeler les API web de l’application en tant qu’utilisateur actuel.
    6. Nom d’affichage du consentement de l’utilisateur : Renseignez Teams peut accéder aux API web de l’application et effectuer des requêtes en votre nom.
    7. Description du consentement de l’utilisateur : Renseignez Activez Teams pour appeler les API web de cette application avec les mêmes droits que vous.
    8. État : choisissez Activé.
    9. Sélectionnez Ajouter une étendue.

  2. Sur la même page, sélectionnez Ajouter une application cliente sous Applications clientes autorisées, puis ajoutez les détails suivants :

    1. ID client : Renseignez 1fec8e78-bce4-4aaf-ab1b-5451cc387264 qui est l’ID client pour Microsoft Teams sur mobile et client.
    2. Étendues autorisées : choisissez l’étendue access_as_user existante.
    3. Sélectionnez Ajouter une application.

  3. Sélectionnez Ajouter une application cliente et ajoutez les détails :

    1. ID client : Renseignez 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 qui est l’ID client pour Teams sur le web.
    2. Étendues autorisées : choisissez l’étendue access_as_user existante.
    3. Sélectionnez Ajouter une application.

  4. Accédez à la page Manifeste de l’application, copiez l’ID sous oauth2Permissions en tant qu’ID d’étendue d’accès à l’utilisateur.

Obtenir des informations sur l’application Microsoft Entra existante

Si vous avez une application Azure déjà inscrite, vous pouvez la réutiliser dans votre projet TeamsFx au lieu de créer une inscription. Avant de commencer, capturez les valeurs de configuration requises à partir de l’inscription d’application existante afin de pouvoir les ajouter à votre projet TeamsFx.

Remarque

Vous pouvez ignorer cette partie si vous avez suivi les instructions ci-dessus pour créer une application Microsoft Entra.

  1. Accédez au Portail Azure et sélectionnez Microsoft Entra ID.

  2. Sélectionnez Inscriptions d’applications et recherchez votre application Microsoft Entra existante.

  3. Accédez à la page Vue d’ensemble de l’application, copiez l’ID d’application (client), l’ID d’objet et l’ID de répertoire (locataire) ; il est nécessaire plus tard.

  4. Vérifiez que le type de compte pris en charge est défini sur Mon organisation uniquement.

  5. Accédez à la page Vue d’ensemble de l’application, copiez l’ID d’application (client),l’ID d’objet et l’ID de répertoire (locataire) pour une utilisation ultérieure. Vérifiez que le type de compte pris en charge est défini sur Mon organisation uniquement.

  6. Accédez à la page Certificats & secrets de l’application, appuyez sur le bouton Copier sous la colonne Valeur pour copier le secret client.

    Remarque

    Si vous ne pouvez pas copier le secret, suivez les instructions pour créer un nouveau secret client.

  7. Accédez à la page Exposer une API de l’application. Si l’étendue access_as_user est déjà définie et que les deux ID client Teams sont préautorisés, ouvrez le manifeste et copiez la valeur de l’ID sous oauth2Permissions et entrez-la en tant qu’ID d’étendue d’accès en tant qu’utilisateur.

Définir les informations de l’application Entraa dans le projet TeamsFx

Ajoutez les informations enregistrées à partir de l’application Microsoft Entra à votre projet TeamsFx.

Remarque

Si vous n’utilisez aadApp/create pas d’action pour créer l’application Microsoft Entra, vous pouvez ajouter des variables d’environnement requises avec le nom de votre choix sans suivre ces étapes.

  1. Ouvrez m365agents.yml et recherchez l’action aadApp/create .

  2. Recherchez les noms des variables d’environnement qui stockent des informations pour l’application Microsoft Entra dans la writeToEnvironmentFile propriété. Voici les définitions par défaut writeToenvironmentFile si vous créez des projets à l’aide de Microsoft 365 Agents Toolkit (anciennement Teams Toolkit) :

     writeToEnvironmentFile:
   clientId: AAD_APP_CLIENT_ID
   clientSecret: SECRET_AAD_APP_CLIENT_SECRET
   objectId: AAD_APP_OBJECT_ID
   tenantId: AAD_APP_TENANT_ID
   authority: AAD_APP_OAUTH_AUTHORITY
   authorityHost: AAD_APP_OAUTH_AUTHORITY_HOST

  3. Ajoutez des valeurs pour chaque variable d’environnement de l’étape 2.

    1. Ajoutez les variables d’environnement suivantes et leurs valeurs au env\.env.{env} fichier.

      AAD_APP_CLIENT_ID=<value of Microsoft Entra application's client id (application id)> # example: 00000000-0000-0000-0000-000000000000
AAD_APP_OBJECT_ID=<value of Microsoft Entra application's object id> # example: 00000000-0000-0000-0000-000000000000
AAD_APP_TENANT_ID=<value of Microsoft Entra's (tenant) id> # example: 00000000-0000-0000-0000-000000000000
AAD_APP_OAUTH_AUTHORITY=<value of Microsoft Entra's authority> # example: https://login.microsoftonline.com/<Directory (tenant) ID>
AAD_APP_OAUTH_AUTHORITY_HOST=<host of Microsoft Entra's authority> # example: https://login.microsoftonline.com
AAD_APP_ACCESS_AS_USER_PERMISSION_ID=<id of access_as_user permission> # example: 00000000-0000-0000-0000-000000000000

      AAD_APP_OAUTH_AUTHORITY_HOSTest l’hôte d’autorité Microsoft Entra (par exemple) https://login.microsoftonline.comque votre agent ou bot utilise comme point de terminaison de connexion à OAuth 2.0. Pour les points de terminaison spécifiques à l’environnement, consultez Points de terminaison d’authentification Microsoft Entra.

    2. Si votre agent ou application nécessite une clé secrète client d’application Microsoft Entra, ajoutez la variable d’environnement suivante et sa valeur au env\.env.{env}.user fichier.

      SECRET_AAD_APP_CLIENT_SECRET=<value of Microsoft Entra application's client secret>

      Remarque

      N’oubliez pas de mettre à jour les noms des variables d’environnement indiqués dans les exemples si vous utilisez des noms différents dans writeToEnvironmentFile.

  4. Ouvrez l’extension Agents Toolkit et sélectionnez Provisionner dans le cloud. Attendez que votre projet soit correctement provisionné.

Télécharger le manifeste de l’application Microsoft Entra sur le portail Azure

Si Agents Toolkit ne met pas à jour l’application Microsoft Entra, un message d’erreur s’affiche :

Insufficient privileges to complete the operation.

Si ce message s’affiche, mettez à jour l’autorisation de l’application Microsoft Entra et suivez les instructions pour mettre à jour l’autorisation.

  1. Recherchez le manifeste de l’application Microsoft Entra sous build/aad.manifest.{env}.json.

  2. Copiez le contenu du fichier manifeste.

  3. Accédez au Portail Azure et sélectionnez Microsoft Entra ID.

  4. Sélectionnez Inscriptions d’applications et recherchez votre application Microsoft Entra existante.

  5. Accédez à la page Manifeste de l’application, collez le contenu du manifeste dans l’éditeur, puis sélectionnez Enregistrer pour enregistrer les modifications.

Voir aussi

  • Dernière mise à jour :