【GraphAPI】Teams アプリのアクセス許可 (リソース固有の同意：RSC)

Last updated at 2025-06-15Posted at 2025-06-11

はじめに

Graph API のアクセス許可として、Teams のアプリの場合だけ使用できる "リソース固有の同意" というアクセス許可があります。リソース固有の同意について、簡単にまとめてみました。

"リソース固有の同意" は Teams アプリに対して、アプリが追加されたチームやチャットの情報のみ取得することを許可するアクセス許可です。

リソース固有の同意 (Resource-Specific Consent) は省略して RSC と記載されます。この記事でも以降は RSC と表記します。

ここでの "Teams アプリ" は Teams クライアント上からチームやチャットに追加できる様々なアプリのことを指しています。

例えば、チャットボットの Teams アプリの場合、ユーザーが入力したメッセージの情報を Graph API で取得し、適切な応答を返す必要があります。

Graph API にはユーザー委任権限とアプリケーション許可権限があります。

ユーザー委任権限は特定のユーザーがサインインすることでアプリに自身の代わりアクセス許可を付与する方法なので、チャットボットには利用できません。

アプリケーション許可権限の場合は、チャットボットから利用することができます。しかし、アプリケーション許可権限ではアクセス許可を付与すると、アプリがテナント全体のメッセージを閲覧することが可能になってしまいます。

※ 参考

そこで Teams アプリの場合には、RSC を使用します。RSC では Entra ID アプリケーションではなく、Teams アプリに対してアクセス許可を付与します。

RSC が付与された Teams アプリは、アプリが追加されたチームやグループチャット内の情報のみ、参照することが可能です。

RSC を使用したチャットボットアプリのサンプルが Github で公開されています。

以下の手順でサンプルアプリを Teams クライアントに追加して、簡単に試すことができます。

■ 1. Github からサンプルアプリの zip ファイルをダウンロードする

■ 2. Teams 管理センターからサンプルアプリをアップロードする

※ この手順は Teams 管理者のユーザーで行ってください。

■ 3. Teams クライアントからサンプルアプリを利用する

Teams アプリには以下の方法で RSC を設定します。

"Bot-RSC.zip" を展開すると、フォルダ内に "manifest.json" というファイルが存在します。"manifest.json" はアプリの設定情報を記載するファイルです。

"manifest.json" の [authorization] - [permissions] - [resourceSpecific] でアプリに設定する RSC のアクセス許可を設定します。

Bot-RSC サンプルアプリでは、RSC によってアプリがインストールされたチャネルやグループチャットのメッセージを読み取ることができるアクセス許可を設定していることが分かります。

Teams Developer Portal でもアプリの設定を変更することができます。

Developer Portal ブラウザから任意のユーザーで Developer Portal を開きます
[アプリ] - [アプリのインポート] をクリックし、"Bot-RSC.zip" をアップロードします
[構成する] - [権限] をクリックし、[チームのアクセス許可] - [Application] を展開します
"ChannelMessage.Read.Group" アクセス許可が設定されていることが分かります