リソース固有の同意 (RSC) は、Microsoft Teams と Microsoft ID プラットフォームによって構築された承認フレームワークであり、アプリへのスコープ付きアクセスを許可できます。
承認されたユーザーは、RSC を通じて、リソース タイプの特定のインスタンスのデータへのアクセス権をアプリに付与できます。 テナント全体のリソースの種類のすべてのインスタンスにアプリにアクセス権を与える必要はありません。
たとえば、チーム A とチーム B の両方を所有しているユーザーは、Contoso アプリにチーム A のデータのみへのアクセス権を与え、チーム B にはアクセス権を付与しないことを決定できます。スコープ付きデータ アクセスの同じ概念がチャットや会議にも当てはまります。
RSC アクセス許可の種類を次に示します。
データ アクセスが許可されているリソースの種類:
- チーム (およびそれらのチーム内のチャネル)
- チャット (およびそれらのチャットに関連付けられている会議)
- ユーザー
データ アクセスのモード:
- アプリケーション: アプリは、サインインしているユーザーの存在なしにデータにアクセスします。
- 委任: アプリは、サインインしているユーザーのセッションのコンテキスト内のデータにのみアクセスします。 サインイン ユーザーがいない場合にはアクセスが許可されません。
| アプリケーション コンテキストの RSC アクセス許可 | 委任されたコンテキストの RSC アクセス許可 | |
|---|---|---|
| リソースの種類 | ||
| チーム | ✔️ | ✔️ |
| Chat または会議 | ✔️ | ✔️ |
| User | ✔️ | ✔️ |
このセクションでは、以下の詳細について説明します。
RSC アクセス許可の種類
RSC アクセス許可を使用して、アプリのデータ アクセス方法を決定します。 RSC アクセス許可を付与するユーザーの機能は、リソースの種類とアクセス モードによって異なります。 アクセス モードに基づくアプリの RSC アクセス許可の種類を次に示します。
アプリケーション コンテキスト RSC アクセス許可 (アプリケーションのアクセス許可): ユーザーがサインインしていないときでもアプリがデータにアクセスできるようにします。 リソース所有者のみが、アプリケーションの RSC アクセス許可を付与できます。
代理コンテキスト RSC アクセス許可 (代理アクセス許可): アプリがサインイン ユーザーの代理でのみデータにアクセスできるようにします。 サインイン ユーザーがいない場合、アクセスは許可されません。 承認されたユーザーのみが特定のスコープでアプリをインストールできます。 また、アプリのインストール時にその特定のスコープでアプリが要求する委任された RSC アクセス許可を付与することもできます。 たとえば、通常のメンバーがチーム内にアプリをインストールするアクセス許可を持っている場合は、その特定のチーム内のアプリに委任された RSC アクセス許可を付与することもできます。
基本的な RSC アクセス許可
限られた一連の RSC アクセス許可は、Microsoft プライバシーおよびセキュリティ チームによって確認され、低リスクと見なされています。 これらのアクセス許可は、ユーザーがアプリをインストールして使用するときに、どのユーザーもいつでも同意できます。 次の危険度の低い基本アクセス許可は、インストール時に常に同意されます。
| アクセス許可の名前 | アクション | 型: 委任済み | 型: アプリケーション名を入力する |
|---|---|---|---|
TeamsActivity.Send.Group |
このチームのユーザーにアクティビティ フィード通知を送信します。 | 該当なし | サポート |
TeamsActivity.Send.Chat |
このチャットのユーザーにアクティビティ フィード通知を送信します。 | 該当なし | サポート |
TeamsActivity.Send.User |
ユーザーにアクティビティ フィード通知を送信します。 | 該当なし | サポート |
RSC ベースのデータ アクセス API
Microsoft Graph SDK、Microsoft Bot Framework SDK、および Microsoft TeamsJS クライアント ライブラリは、RSC を介したきめ細かなデータ アクセスをサポートしています。 サポートされるモードとリソースの種類は、API サーフェイスによって異なります。
| RSC モード | サポートされる SDK | アプリ マニフェストのバージョン | リソースの種類 | テナント全体の RSC 関連の制御 | RSC アクセス許可に同意できるユーザー |
|---|---|---|---|---|---|
| アプリケーション | • Microsoft Graph • Microsoft Bot Framework |
>=v1.6 | チーム、チャット、会議 | • チャットと会議のための Microsoft Graph ベースのコントロール • Teams 用の Microsoft Entra 管理センター ベースのコントロール |
• チーム: チームの所有者またはメンバー • Chat: チャット メンバー • 会議: 会議の開催者または発表者 |
| 委任 | Microsoft Teams クライアント | >=v1.12 | チーム、チャット、会議、ユーザー | 常にオン | 特定のスコープでアプリをインストールする権限を持つすべてのユーザー。 |
注:
TeamsActivity.Send RSC アプリケーションのアクセス許可は、テナント レベルで常に有効になっています。 アプリ ユーザーは、アクセス許可を使用するために管理者の同意を必要としません。
サポートされている RSC アクセス許可
次の一覧は、リソースの種類に基づいて分類されたすべての RSC アクセス許可を示しています。 各表には、各アクセス許可で使用できるデータ アクセス モードも示されています。
- チームの RSC アクセス許可: チーム内のチャネルを含みます。
- チャットまたは会議の RSC アクセス許可: チャットに関連付けられている会議が含まれます。
- ユーザー アクセスの RSC アクセス許可: ユーザーがさまざまなリソースにアクセスするためのアクセス許可を含みます。
注:
ここに示す一部のアクセス許可に関連付けられている機能は、一般提供されていない (GA) 場合があります。
チームの RSC アクセス許可
次の表に、チームの RSC アプリケーションのアクセス許可と、該当するデータ アクセス モードを示します。
| アクセス許可の名前 | アクション | 型: 委任済み | 型: アプリケーション名を入力する |
|---|---|---|---|
Channel.Create.Group |
このチームのチャネルを作成します。 | 該当なし | サポート |
Channel.Delete.Group |
このチームのチャネルを削除します。 | 該当なし | サポート |
ChannelMeeting.ReadBasic.Group |
このチームのチャネル会議の基本的なプロパティを読み取ります。 | 該当なし | サポート |
ChannelMeetingParticipant.Read.Group |
このチームに関連付けられているチャネル会議の名前、役割、ID、参加、退出時刻などの参加者情報を読み取ります。 | 該当なし | サポート |
ChannelMeetingRecording.Read.Group |
このチームに関連付けられているすべてのチャネル会議の記録を読み取ります。 | 該当なし | サポート |
ChannelMeetingNotification.Send.Group |
このチームに関連付けられているすべてのチャネル会議で通知を送信します。 | 該当なし | サポート |
ChannelMessage.Read.Group |
このチームのチャネル メッセージを読む。 | 該当なし | サポート |
ChannelMessage.Send.Group |
このチームのチャネルにメッセージを送信します。 | 該当なし | サポート |
ChannelSettings.Read.Group |
このチームのチャネルの名前、説明、設定を読み取ります。 | 該当なし | サポート |
ChannelSettings.ReadWrite.Group |
このチームのチャネルの名前、説明、および設定を更新します。 | 該当なし | サポート |
TeamsActivity.Send.Group |
このチームのユーザーにアクティビティ フィード通知を送信します。 | 該当なし | サポート |
TeamsAppInstallation.Read.Group |
このチームにインストールされているアプリを読み取ります。 | 該当なし | サポート |
TeamMember.Read.Group |
このチームのメンバーを読み取ります。 | 該当なし | サポート |
TeamSettings.Read.Group |
このチームの設定を読み取ります。 | 該当なし | サポート |
TeamSettings.ReadWrite.Group |
このチームの設定を読み書きします。 | 該当なし | サポート |
TeamsTab.Create.Group |
このチームのタブを作成します。 | 該当なし | サポート |
TeamsTab.Delete.Group |
このチームのタブを削除します。 | 該当なし | サポート |
TeamsTab.Read.Group |
このチームのタブを読み取ります。 | 該当なし | サポート |
TeamsTab.ReadWrite.Group |
このチームのタブを管理します。 | 該当なし | サポート |
ChannelMeetingActiveSpeaker.Read.Group |
このチームに関連付けられているチャネル会議に音声を送信している参加者を読み取ります。 | サポート | 該当なし |
ChannelMeetingAudioVideo.Stream.Group |
このチームに関連付けられているチャネル会議のオーディオビデオ コンテンツをStreamします。 | サポート | 該当なし |
ChannelMeetingIncomingAudio.Detect.Group |
このチームに関連付けられているチャネル会議での着信オーディオを検出します。 | サポート | 該当なし |
ChannelMeetingStage.Write.Group |
このチームに関連付けられているチャネル ミーティングのミーティング ステージにコンテンツを表示します。 | サポート | 該当なし |
InAppPurchase.Allow.Group |
このチームのユーザーのアプリ内購入を表示して完了します。 | サポート | 該当なし |
LiveShareSession.ReadWrite.Group |
アプリがこのチームの Live Share セッションを作成および同期することを許可し、名前や役割などの、このチームの名簿および関連する会議に関する関連情報にアクセスできます。 | サポート | 該当なし |
MeetingParticipantReaction.Read.Group |
このチームに関連付けられているチャネル会議の参加者のリアクションを読み取ります。 | サポート | 該当なし |
ChannelMember.ReadWrite.Group |
このチームのチャネルのメンバーの読み取りと書き込みを行います。 | 該当なし | 該当なし |
ChannelMember.Read.Group |
このチームのチャネルのメンバーを読み取ります。 | 該当なし | 該当なし |
詳細については、「 チーム リソース固有の同意のアクセス許可」を参照してください。
チャットまたは会議の RSC アクセス許可
注:
個人用スコープのチャットの RSC アクセス許可は ChatMessageReadReceipt.Read.Chat に制限されています。
チャットに会議または通話が関連付けられている場合は、関連する RSC アクセス許可がそれらのリソースにも適用されます。
次の表に、チャットまたは会議の RSC アクセス許可と、それに該当するデータ アクセス モードを示します。
| アクセス許可の名前 | アクション | 型: 委任済み | 型: アプリケーション名を入力する |
|---|---|---|---|
Calls.AccessMedia.Chat |
このチャットまたは会議に関連付けられた通話でメディア ストリームにアクセスします。 | 該当なし | サポート |
Calls.JoinGroupCalls.Chat |
このチャットまたは会議に関連付けられた通話に参加します。 | 該当なし | サポート |
ChatSettings.Read.Chat |
このチャットの設定を読み取ります。 | 該当なし | サポート |
ChatSettings.ReadWrite.Chat |
このチャットの設定の読み取りおよび書き込みを行います。 | 該当なし | サポート |
ChatMessage.Read.Chat |
このチャットのメッセージを読み取ります。 | 該当なし | サポート |
ChatMessageReadReceipt.Read.Chat |
このチャットで最後に表示されたメッセージの ID を読み取ります。 | 該当なし | サポート |
ChatMember.Read.Chat |
このチャットのメンバーを読み取ります。 | 該当なし | サポート |
Chat.Manage.Chat |
このチャットを管理します。 | 該当なし | サポート |
TeamsTab.Read.Chat |
このチャットのタブを読み取ります。 | 該当なし | サポート |
TeamsTab.Create.Chat |
このチャットでタブを作成します。 | 該当なし | サポート |
TeamsTab.Delete.Chat |
このチャットのタブを削除します。 | 該当なし | サポート |
TeamsTab.ReadWrite.Chat |
このチャットのタブを管理します。 | 該当なし | サポート |
TeamsAppInstallation.Read.Chat |
このチャットにインストールされているアプリを読み取ります。 | 該当なし | サポート |
TeamsActivity.Send.Chat |
このチャットのユーザーにアクティビティ フィード通知を送信します。 | 該当なし | サポート |
OnlineMeetingTranscript.Read.Chat |
このチャットに関連付けられている会議のトランスクリプトを読み取ります。 | 該当なし | サポート |
OnlineMeeting.ReadBasic.Chat |
名前、スケジュール、開催者、参加リンク、開始または終了通知など、このチャットに関連付けられている会議の基本プロパティを読み取ります。 | 該当なし | サポート |
OnlineMeetingRecording.Read.Chat |
このチャットに関連付けられている会議の記録を読み取ります。 | 該当なし | サポート |
OnlineMeetingNotification.Send.Chat |
このチャットに関連付けられている会議で通知を送信します。 | 該当なし | サポート |
InAppPurchase.Allow.Chat |
このチャットおよび関連する会議でユーザーに対してアプリ内購入を表示して完了します。 | サポート | 該当なし |
LiveShareSession.ReadWrite.Chat |
アプリがこのチャットの Live Share セッションを作成および同期し、このチャットの参加者一覧と関連する会議に関する名前や役割などの関連情報へのアクセスを取得できるようにします。 | サポート | 該当なし |
MeetingStage.Write.Chat |
このチャットに関連する会議の会議ステージにコンテンツを表示します。 | サポート | 該当なし |
MeetingParticipantReaction.Read.Chat |
このチャットに関連する会議の参加者のリアクションを読み取ります。 | サポート | 該当なし |
OnlineMeetingIncomingAudio.Detect.Chat |
このチャットに関連する会議の着信オーディオを検出します。 | サポート | 該当なし |
OnlineMeetingActiveSpeaker.Read.Chat |
このチャットに関連する会議に音声を送信している参加者を読み取ります。 | サポート | 該当なし |
OnlineMeetingAudioVideo.Stream.Chat |
このチャットに関連付けられている会議のオーディオビデオ コンテンツをStreamします。 | サポート | 該当なし |
OnlineMeetingParticipant.Read.Chat |
このチャットに関連付けられている会議の名前、役割、ID、参加時間と退出時間などの参加者情報を読み取ります。 | サポート | サポート |
OnlineMeetingParticipant.ToggleIncomingAudio.Chat |
このチャットに関連する会議の参加者の着信オーディオを切り替えます。 | サポート | 該当なし |
詳細については、「 チャット リソース固有の同意アクセス許可」を参照してください。
ヒント
RSC アクセス許可は、Teams クライアントにインストールされている Teams アプリでのみ使用でき、Microsoft Entra 管理センターの一部には含まれていません。 アプリに関連付けられている RSC アクセス許可については、「アプリのインストール」または「Teams クライアント内のアプリ情報」ダイアログを参照してください。
ユーザー アクセス用の RSC アクセス許可
次の表に、ユーザーの RSC アクセス許可と、その該当するデータ アクセス モードを示します。
| アクセス許可の名前 | アクション | 型: 委任済み | 型: アプリケーション名を入力する |
|---|---|---|---|
CameraStream.Read.User |
ユーザーのカメラ ストリームを読み取ります。 | サポート | 該当なし |
InAppPurchase.Allow.User |
アプリ内購入を表示して完了します。 | サポート | 該当なし |
MicrophoneStream.Read.User |
ユーザーのマイク ストリームを読み取ります。 | サポート | 該当なし |
MeetingParticipantReaction.Read.User |
会議に参加しているときのユーザーの反応を読み取ります。 | サポート | 該当なし |
OutgoingVideoStream.Write.User |
ユーザーの送信ビデオを変更する。 | サポート | 該当なし |
TeamsActivity.Send.User |
ユーザーにアクティビティ通知を送信する。 | 該当なし | サポート |
TeamsAppInstallation.Read.User |
ユーザーの個人用スコープにインストールされているアプリを読み取ります。 | 該当なし | サポート |
次の手順
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Platform Docs