ボットでアダプティブ カードユニバーサル アクションの SSO を有効にする

Teams でのシングル サインオン (SSO) では、アプリ ユーザーは Teams を使用してボットのアダプティブ カードユニバーサル アクションにアクセスできるという利点があります。 Microsoft または Microsoft 365 アカウントを使用して Teams にログインすると、アプリ ユーザーは再びサインインしなくてもアプリを使用できます。 アプリは、Microsoft Entra ID を介して付与されたアクセス権を持つ任意のデバイス上のアプリ ユーザーが利用できます。

アダプティブ カードのユニバーサル アクションの詳細については、「アダプティブ カード のユニバーサル アクション」を参照してください。

アダプティブ カードユニバーサル アクションでは、アクションを処理するための共通バックエンドとしてボットが使用され、新しいアクションの種類が導入されます。 ボットでは、Bot Framework を使用してアプリ ユーザーとの通信を処理し、SSO 認証のためにボットにアクセス トークンを送受信します。 同様に、アダプティブ カード ユニバーサル アクションでは、Bot Framework を使用して SSO 認証も有効にします。

アダプティブ カードユニバーサル アクションの SSO を有効にする前に、ボットの SSO を有効にしてください。

Teams 実行時の SSO

ボットでアダプティブ カードユニバーサル アクションの SSO を有効にするには、サインインしている Teams アプリ ユーザーのアクセス トークンを取得します。 このプロセスには、ボット アプリ クライアントとサーバー、Teams クライアント、Bot Framework、Microsoft Entra ID が含まれます。 この操作中、アプリ ユーザーはマルチテナント環境でアクセス トークンを取得することに同意する必要があります。

次の図は、Teams アプリ ユーザーがボットのアダプティブ カード ユニバーサル アクションにアクセスしようとしたときの SSO のしくみを示しています。

ボットのアダプティブ カードユニバーサル アクションの場合、ボット アプリは Teams クライアントに OAuth カードを送信します。 このカードは、 tokenExchangeResourceを使用して Microsoft Entra ID からアクセス トークンを取得するために使用されます。 アプリ ユーザーの同意に従って、Teams クライアントは、Microsoft Entra ID から受け取ったトークンを、 tokenExchangeを使用してボット アプリに送信します。 ボット アプリはトークンを解析して、メール アドレスなどのアプリ ユーザーの情報を取得できます。

SSO を有効にするためのユース ケース

SSO の認証は、 Action.Execute内で、アダプティブ カードが共有されているグループ チャットまたはチャネル会話のコンテキスト内で認証を有効にします。

ボットは、次の Action.Execute に応答してサインイン要求で応答できます。

• ボットが 1 対 1 のチャット、グループ チャット、またはチャネルで送信するアダプティブ カード。
• 1 対 1 のチャット、グループ チャット、またはチャネルでメッセージ拡張機能アプリ (ボットによってサポート) を介してアプリ ユーザーによって送信されるアダプティブ カード。
• アプリ ユーザーがメッセージを作成しているときに、作成またはプレビュー領域に存在するアダプティブ カード。 作成領域で、アダプティブ カードの更新が機能し、ボットがトークンを使用して、カードをチャットに送信する前に、アプリ ユーザーにユーザー固有のビューを提供したい場合があります。

次の手順

関連項目

• アダプティブ カードのユニバーサル アクションの操作
• アダプティブ カードユニバーサル アクションの認証フロー