SSO 認証を使用してボットを構築する

Microsoft Teamsの会話型ボットは、顧客サービスなど、ユーザーによって開始された繰り返し自動化されたタスクを実行します。 ユーザーは、シングル サインオン (SSO) 認証なしで複数回サインインする必要があります。 SSO 認証方法では、ユーザーはボットに複数回サインインする必要はありません。

ボットは、関係する会話に応じて動作が異なります。

• チャネルおよびグループ チャット会話のボットでは、ユーザーがボットを @mention する必要があります。
• 1 対 1 の会話の場合、ボットを @mention する必要はありません。 ユーザーによって送信されたすべてのメッセージは、ボットにルーティングされます。

このステップ バイ ステップ ガイドは、SSO 認証を使用してボットを構築するのに役立ちます。 次の出力が表示されます。

前提条件

• 残り 18 分

次のツールをインストールし、開発環境を設定していることを確認します。

Teams 開発テナントを設定する

テナントは、Teams でチャット、ファイルの共有、組織の会議の実行を行うスペースやコンテナーのようなものです。 カスタム アプリをアップロードしてテストすることもできます。

カスタム アプリのアップロード オプションを確認する

アプリを作成したら、アプリを配布せずに Teams に読み込む必要があります。 このプロセスは、カスタム アプリのアップロードと呼ばれます。 このオプションを表示するには、Microsoft 365 アカウントにサインインします。

既にテナントがあり、管理者アクセス権がありますか? 実際にあるかどうかを確認しましょう。

Teams でカスタム アップロード アプリを確認するには:

1. Teams クライアントで、[ アプリ ] アイコンを選択します。

2. [アプリの管理] を選択します。

3. [ アプリのアップロード] を選択します

4. [ カスタム アプリのアップロード] オプションを探します。 オプションが表示された場合は、カスタム アプリのアップロードが有効になります。

   

   注:

   カスタム アプリをアップロードするオプションがない場合は、Teams 管理者に問い合わせてください。

無料の Teams 開発者テナントを作成する (省略可能)

Teams 開発者アカウントをお持ちでない場合は、無料で入手できます。 Microsoft 365 開発者プログラムに参加します。

1. Microsoft 365 開発者プログラムに移動します。

2. [今すぐ参加] を選択し、画面の指示に従います。

3. ようこそ画面で、[ セットアップ E5 サブスクリプション] を選択します。

4. 管理者アカウントを設定します。 完了すると、次の画面が表示されます。

   

5. 設定した新しい管理者アカウントを使用して Teams にサインインします。 Teams で [カスタム アプリのアップロード] オプションがあることを確認します。

ローカル環境を設定する

• 残り 17 分

1. Microsoft-Teams-Samples を開きます。

2. [ コード] を選択します。

3. ドロップダウン メニューから、[ GitHub Desktop で開く] を選択します。

   

4. [ 複製] を選択します。

Microsoft Entra アプリを登録する

• 残り 16 分

次の手順は、Azure portal でボットを作成して登録するのに役立ちます。

• Azure アプリを作成して登録します。
• クライアント シークレットを作成して、ボットの SSO 認証を有効にします。
• Teams チャネルを追加してボットをデプロイします。
• 開発トンネル (推奨) または ngrok を使用して、Web サーバーのエンドポイントへのトンネルを作成します。
• 作成した開発トンネルにメッセージング エンドポイントを追加します。

アプリの登録を追加する

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

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

   

3. [ + 新規登録] を選択します。

   

4. アプリの名前を入力します。

5. 任意の組織ディレクトリ (任意の Microsoft Entra ID テナント - マルチテナント) で [アカウント] を選択します。

6. [登録] を選択します。

   

   アプリは Microsoft Entra ID に登録されています。 アプリの概要ページが表示されます。

   

   注:

   さらに使用するために 、アプリケーション (クライアント) ID と ディレクトリ (テナント) ID からアプリ ID を 保存します。

トンネルを作成する

ngrok http --host-header=localhost 3978

Web 認証を追加する

1. 左側のウィンドウの [ 管理] で、[ 認証] を選択します。

2. [プラットフォームの追加>Web] を選択します。

   

3. 完全修飾ドメイン名に auth-end を追加して、アプリのリダイレクト URI を入力します。 たとえば、https://your-devtunnel-domain/auth-end および https://your-ngrok-domain/auth-end が禁止となります。

4. [ 暗黙的な許可とハイブリッド フロー] で、[ アクセス トークン と ID トークン ] チェック ボックスをオンにします。

5. [構成] を選択します。

   

6. [ Web] で、[ URI の追加] を選択します。

7. https://token.botframework.com/.auth/web/redirect を入力します。

8. [保存] を選択します。

   

クライアント シークレットを作成する

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

2. [ クライアント シークレット] で、[ + 新しいクライアント シークレット] を選択します。

   

   [ クライアント シークレットの追加] ウィンドウが表示されます。

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

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

   

5. [ 値] で、[ クリップボードにコピー ] を選択して、クライアント シークレットの値を保存して、さらに使用します。

   

API アクセス許可を追加する

1. 左側のウィンドウで、[ API アクセス許可] を選択します。

2. [ + アクセス許可の追加] を選択します。

   

3. [Microsoft Graph] を選択します。

4. [委任されたアクセス許可] を選択します。

5. [ User>User.Read] を選択します。

6. [アクセス許可の追加] を選択します。

   

アプリケーション ID

1. 左側のウィンドウの [ 管理] で、[ API の公開] を選択します。

2. [アプリケーション ID URI] の横にある [追加] を選択します。

   

3. アプリケーション ID URI をapi://botid-{AppID}形式で更新し、[保存] を選択します。

   

スコープを追加する

1. 左側のウィンドウの [ 管理] で、[ API の公開] を選択します。

2. [ + スコープの追加] を選択します。

   

3. スコープ名として「access_as_user」と入力します。

4. [ 同意できるユーザー] で、[ 管理者とユーザー] を選択します。

5. 残りのフィールドの値を次のように更新します。

   • 「Teams は管理者の同意表示名としてユーザーのプロファイルにアクセスできます」と入力します。

   • 「Teams でアプリの Web API を現在のユーザーとして管理者の同意の説明として呼び出すことができます」と入力します。

   • 「Teams」と入力すると、ユーザー プロファイルにアクセスし、ユーザーの代わりにユーザーの同意表示名として要求を行うことができます。

   • ユーザーの同意の説明と同じ権限を持つこのアプリの API を呼び出すには、「Teams を有効にする」と入力します。

6. [状態] が [有効] に設定されていることを確認してください。

7. [スコープの追加] を選択します。

   次の図は、フィールドと値を示しています。

   

   注:

   スコープ名は、最後に追加/access_as_userアプリケーション ID URI と一致する必要があります。

   

クライアント アプリケーションを追加する

1. 左側のウィンドウの [ 管理] で、[ API の公開] を選択します。

   [ 承認されたクライアント アプリケーション] で、アプリの Web アプリケーションに対して承認するアプリケーションを特定します。

2. [ + クライアント アプリケーションの追加] を選択します。

   

3. Teams モバイルまたはデスクトップと Teams Web アプリケーションを追加します。

   1. Teams モバイルまたはデスクトップの場合: 1fec8e78-bce4-4aaf-ab1b-5451cc387264としてクライアント ID を入力します。

      

   2. Teams Web の場合: 5e3ce6c0-2b1f-4285-8d4b-75ee78787346としてクライアント ID を入力します。

      

4. [ 承認されたスコープ ] チェック ボックスをオンにします。

5. [アプリケーションの追加] を選択します。

   

   次の図は、 クライアント ID を表示します。

   

マニフェストを更新する

1. 左側のウィンドウで、[マニフェスト] を選択 します。

2. accessTokenAcceptedVersionの値を2に設定し、[保存] を選択します。

   

ボットを作成する

• 残り 11 分

Azure ボット リソースを作成する

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

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

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

4. Enter キーを押します。

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

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

   

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

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

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

   

   既存のリソース グループがない場合は、新しいリソース グループを作成できます。 新しいリソース グループを作成するには、次の手順に従います。

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

   

10. [ 価格] で、[ プランの変更] を選択します。

    

11. [ FO Free>Select] を選択します。

    

12. [Microsoft アプリ ID] で、[マルチテナントとしてのアプリの種類] を選択します。

13. [ 作成の種類] で、[ 既存のアプリの登録を使用する] を選択します。

14. アプリ ID を入力します。

    注:

    同じ Microsoft アプリ ID を持つ複数のボットを作成することはできません。

15. [確認 + 作成] を選びます。

    

16. 検証に合格したら、[ 作成] を選択します。

    ボットのプロビジョニングには数分かかります。

17. [リソースに移動] を選びます。

    

    Azure ボットが正常に作成されました。

    

Teams チャネルを追加する

1. 左側のウィンドウで、[チャネル] を選択 します。

2. [ 使用可能なチャネル] で、[ Microsoft Teams] を選択します。

   

3. チェックボックスをオンにして 、利用規約に同意します。

4. [ 同意する] を選択します。

   

5. [適用] を選択します。

   

メッセージング エンドポイントを追加するには

OAuth 接続設定を追加する

1. 左側のウィンドウで、[構成] を選択 します。

2. [OAuth 接続設定の追加] を選択します。

3. [ 新しい接続設定] で、次の詳細を更新します。

   • [名前]: 新しい接続設定の名前を入力します。 名前は、ボット サービス コードの設定で使用できます。
   • サービス プロバイダー: ドロップダウン リストから [ Azure Active Directory v2] を選択します。
   • クライアント ID: Microsoft アプリ ID を更新します。
   • クライアント シークレット: クライアント シークレットの値を更新 します。
   • トークン交換 URL: アプリケーション ID URI を更新します。
   • テナント ID: 「Common」と入力します。
   • スコープ: User.Read と入力します。

4. [保存] を選択します。

   

アプリ設定とマニフェスト ファイルを設定する

• 残り 6 分

1. 複製されたリポジトリ内の appsettings.json ファイルに移動します。

   

2. appsettings.json ファイルを開き、次の情報を更新します。

   • "MicrosoftAppId"をボットの Microsoft アプリ ID に設定します。
   • "MicrosoftAppPassword"をボットのクライアント シークレット ID 値に設定します。
   • ConnectionNameを OAuth 接続名として設定します。
   • "MicrosoftAppType" を MultiTenant に設定します。
   • "MicrosoftAppTenantId"を common に設定します。

   

3. 複製されたリポジトリ内の manifest.json ファイルに移動します。

   

4. manifest.json ファイルを開き、次の変更を更新します。

   • "{TODO: MicrosoftAppId}"のすべての出現箇所を Microsoft アプリ ID に置き換えます。
   • "<<domain-name>>"を ngrok ドメインまたは開発トンネル ドメインに設定します。

   

サービスをビルドして実行する

• 残り 4 分

1. Visual Studio を開きます。

2. [ファイル>Open>Project/Solution...] に移動します。

   

3. bot-conversation-sso-quickstart>csharp_dotnetcore フォルダーから、ファイルBotConversationSsoQuickstart.sln選択します。

   

4. F5 キーを押してプロジェクトを実行します。

5. [セキュリティ警告] ダイアログが表示されたら、[はい] を選択します。

   

   Web ページが開き、 ボットの準備ができました! というメッセージが表示されます。

   

   
   
   トラブルシューティング

   パッケージを見つけられないエラーが発生した場合は、次の手順に従います。

   1. [ツール>NuGet パッケージ マネージャー>Package Manager の設定] に移動します。
   2. 表示された [オプション] ウィンドウで、[NuGet パッケージ マネージャー]>[パッケージ ソース] を選択します。
   3. [追加] を選択します。
   4. [名前] に「nuget.org」と入力し、[ソース] に「https://api.nuget.org/v3/index.json」と入力します。
   5. [ 更新] を選択し 、[OK] を選択します。
   6. プロジェクトをリビルドします。
      

Teams でボットをアップロードする

• 残り 3 分

1. 複製したリポジトリで、Microsoft-Teams-Samples>samples>bot-conversation-sso-quickstart>csharp_dotnetcore>BotConversationSsoQuickstart に移動します。

2. appPackage フォルダーに存在する次のファイルを含む .zip ファイルを作成します。

   • manifest.json
   • outline.png
   • color.png

   

3. [Microsoft Teams] に移動します。

   1. Teams クライアントで、[アプリ] を選択 します。

   2. [アプリの管理] を選択します。

   3. [ アプリのアップロード] を選択します。

   4. [カスタム アプリのアップロード] オプションを探します。

      

4. [ 開く ] を選択して、 マニフェスト フォルダーに作成した .zip ファイルをアップロードします。

   

5. [ 追加] を選択して、ボットをチャットに追加します。

   

ボットを操作する場合は、メッセージを送信します。 ボットは SSO トークンを交換し、代わりに Graph API を呼び出します。 サインアウトするメッセージを送信しない限り、サインインしたままになります。

1. ボットにメッセージを送信します。 会話ボットは初めて同意を求めます。

   1. デスクトップの場合: [ 続行] を選択して、ボットにアクセスするためのアクセス許可を Teams クライアントに付与します。

      

      注:

      これで、ボット アプリで SSO を構成したので、同意する必要があるのは唯一の時間です。

   2. モバイルの場合: [ 同意する] を選択します。

      注:

      これで、モバイルでボット アプリに対する SSO を構成したので、同意する必要があるのは唯一の時間です。

      

課題の完了

• 残り 1 分

このようなものを思いついたのですか?

おめでとうございます。

• 100% 完了しました

SSO 認証を使用したボットの構築を開始するためのチュートリアルを完了しました。