アプリ認証に証明書または MSI を使用する

証明書または MSI ベースの認証を使用して、ボット ID とシークレットの代わりにボット アプリを検証できます。 この認証により、Microsoft Entra IDとボット シークレットの使用に関連するコンプライアンス上の問題が解決されます。

前提条件

次のリソースを使用して、Teams ボット アプリが Azure にデプロイされていることを確認します。

• Azure ボット。
• ボット認証に使用されるシークレットを含む Entra ID。
• Azure App Service、Azure Functionsなど、ボット アプリをホストするリソース。

証明書ベースの認証に更新する

証明書ベースの認証を使用するようにボット アプリを更新するには:

1. Azure AD で証明書を作成してアップロードする
2. ボット アプリ コードを更新する
3. ボット シークレットを削除する

Azure AD で証明書を作成してアップロードする

ボット認証に証明書を使用するには:

1. 証明書と秘密キーを準備します。

2. Azure ポータルに移動します。

3. [アプリの登録] を選択します。

   

4. 登録済みのアプリを選択します。

5. 左側のウィンドウの [ 管理] で、[ 証明書 & シークレット] を選択します。

6. [ 証明書] で、[ 証明書のアップロード] を選択します。

   

   [ 証明書のアップロード] ウィンドウが表示されます。

   注:

   .cer、.pem、.crt のいずれかの種類の証明書 (公開キー) をアップロードします。

7. 準備した証明書をアップロードします。

8. 「説明」と入力します。

9. [追加] を選択します。

   

ボット アプリ コードを更新する

次の手順に従って、ボット アプリ コードを更新します。

1. Visual Studio または Visual Studio Code でボット アプリ プロジェクトを開きます。

2. コードを更新します。

   JavaScript

       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);
   

   C#

       builder.Services.AddSingleton<ServiceClientCredentialsFactory>((e) => new CertificateServiceClientCredentialsFactory("{your certificate}", "{your entra id}"));
   

3. ボットをテストして、操作が更新された認証と一致することを確認してください。

ボット シークレットを削除する

ボット シークレットを削除する前に、ボット アプリで認証に証明書が使用されていることを確認します。

ボット シークレットを削除するには:

1. Azure ポータルに移動します。

2. [アプリの登録] を選択します。

   

3. 登録済みのアプリを選択します。

4. 左側のウィンドウの [ 管理] で、[ 証明書 & シークレット] を選択します。

5. Entra からシークレットを削除します。

   

これで、ボット アプリで認証に証明書が使用されるようになりました。

MSI ベースの認証に更新する

MSI ベースの認証を使用するようにボット アプリを更新するには:

1. Azure AD で MSI 型のボット サービスを作成する
2. MSI 用のボット アプリ コードを更新する
3. ボット シークレットを削除する

注:

Azure Bot サービス ID と型は、作成後に変更できません。

Azure AD で MSI 型のボット サービスを作成する

MSI の種類を使用して新しい Azure Bot サービスを作成するには、次の手順に従います。

1. Azure ポータルに移動します。

2. [ホーム] に移動します。

3. [ + リソースの作成] を選択します。

4. 検索ボックスに「 Azure Bot」と入力します。

5. Enter キーを 選択 します。

6. [ Azure Bot] を選択します。

7. [作成] を選択します。

   

8. ボット ハンドルにボット名を入力します。

9. ドロップダウン リストから [サブスクリプション] を選択します。

10. ドロップダウン リストから [リソース グループ] を選択します。

    

    既存のリソース グループがない場合は、新しいリソース グループを作成できます。 新しい Azure ボット サービスとマネージド ID を作成するには、次の手順に従います。

    1. [ 新規作成] を選択します。
    2. リソース名を入力し、[ OK] を選択します。
    3. [ 新しいリソース グループの場所 ] ドロップダウン リストから場所を選択します。

    

11. [Microsoft アプリ ID] で、[ユーザー割り当てマネージド ID としてアプリの種類] を選択します。

12. [ 作成の種類] で、[ 新しい Microsoft アプリ ID の作成] を選択します。

    

    または

    最初にマネージド ID を手動で作成してから、既存のアプリ登録を使用して Azure Bot を作成できます。

13. 新しい Azure Bot メッセージング エンドポイントとチャネルを、古いサービスのものと一致するように更新します。

14. リソースをホストしているアプリに移動します。

15. [ 設定] > [ID] > [ユーザー割り当て] を選択します。

16. 作成したマネージド ID を追加します。

MSI 用のボット アプリ コードを更新する

MSI のボット アプリ コードを更新するには、次の手順に従います。

1. Visual Studio または Visual Studio Code でボット アプリ プロジェクトを開きます。

2. コードを更新します。

   JavaScript

       const credentialsFactory = new ConfigurationServiceClientCredentialFactory({
       MicrosoftAppType: 'UserAssignedMsi',
       MicrosoftAppId: '{your MSI’s client ID}',
       MicrosoftAppTenantId: '{your MSI’s tenant ID}',
       });
   
       const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(
       {},
       credentialsFactory
       );
   
       const adapter = new CloudAdapter(botFrameworkAuthentication);
   

   C#

       builder.Configuration["MicrosoftAppType"] = "UserAssignedMsi";
       builder.Configuration["MicrosoftAppId"] = "{your MSI’s client ID}";
       builder.Configuration["MicrosoftAppPassword"] = "{your MSI’s tenant ID}";
       builder.Services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();
   

3. .env ファイルのBOT_IDを更新します。

4. ボットをテストして、その操作が更新された認証と一致していることを確認してください。

ボット シークレットを削除する

ボット シークレットを削除する前に、ボット アプリで認証に証明書が使用されていることを確認します。

ボット シークレットを削除するには:

1. Azure ポータルに移動します。

2. [アプリの登録] を選択します。

   

3. 登録済みのアプリを選択します。

4. 左側のウィンドウの [ 管理] で、[ 証明書 & シークレット] を選択します。

5. Entra からシークレットを削除します。

   

ボット アプリで認証に MSI が使用されるようになりました。

関連項目

• Teams 用のボットを構築する
• メッセージの拡張機能のビルド
• Microsoft Teams でユーザーを認証する