Partager via


Utiliser un certificat ou MSI pour l’authentification de l’application

Vous pouvez utiliser l’authentification basée sur un certificat ou msi pour valider votre application bot au lieu de l’ID et du secret du bot. Cette authentification résout les problèmes de conformité liés à l’utilisation de Microsoft Entra ID et d’un secret de bot.

Configuration requise

Vérifiez qu’une application de bot Teams est déployée sur Azure avec les ressources suivantes :

  • Un bot Azure.
  • ID Entra avec un secret utilisé pour l’authentification du bot.
  • Ressource qui héberge votre application bot, telle que Azure App Service, Azure Functions.

Pour mettre à jour votre application bot afin d’utiliser l’authentification basée sur les certificats :

  1. Créer et charger un certificat dans Azure AD
  2. Mettre à jour le code de l’application bot
  3. Supprimer le secret du bot

Créer et charger un certificat dans Azure AD

Pour utiliser un certificat pour l’authentification du bot :

  1. Préparez un certificat et une clé privée.

  2. Accédez au portail Azure.

  3. Sélectionner les inscriptions d’applications.

    Capture d’écran montrant les services Azure à sélectionner inscriptions d'applications.

  4. Sélectionnez votre application inscrite.

  5. Dans le volet gauche, sous Gérer, sélectionnez Certificats & secrets.

  6. Sous Certificats, sélectionnez Charger le certificat.

    Capture d’écran montrant l’option certificats et secrets.

    La fenêtre Charger un certificat s’affiche.

    Remarque

    Chargez un certificat (clé publique) avec l’un des types de fichiers suivants : .cer, .pem, .crt.

  7. Chargez le certificat que vous avez préparé.

  8. Entrez Description.

  9. Sélectionnez Ajouter.

    Capture d’écran montrant l’option charger le certificat.

Mettre à jour le code de l’application bot

Suivez les étapes pour mettre à jour le code de l’application bot :

  1. Ouvrez votre projet d’application bot dans Visual Studio ou Visual Studio Code.

  2. Mettez à jour votre code.

        const credentialsFactory = new ConfigurationServiceClientCredentialFactory({
        MicrosoftAppId: config.botId,
        CertificatePrivateKey: '{your private key}',
        CertificateThumbprint: '{your cert thumbprint}',
        MicrosoftAppType: "MultiTenant",
        });
    
        const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(
        {},
        credentialsFactory
        );
    
        const adapter = new CloudAdapter(botFrameworkAuthentication);
    
  3. Veillez à tester votre bot pour vérifier que l’opération s’aligne sur l’authentification mise à jour.

Supprimer le secret du bot

Vérifiez que votre application de bot utilise le certificat pour l’authentification avant de supprimer le secret du bot.

Pour supprimer le secret du bot :

  1. Accédez au portail Azure.

  2. Sélectionner les inscriptions d’applications.

    Capture d’écran montrant les services Azure à sélectionner inscriptions d'applications.

  3. Sélectionnez votre application inscrite.

  4. Dans le volet gauche, sous Gérer, sélectionnez Certificats & secrets.

  5. Supprimez les secrets d’Entra.

    Capture d’écran montrant la valeur supprimer la clé secrète client.

Votre application bot utilise désormais le certificat pour l’authentification.

Voir aussi