Consentimento específico do recurso para agentes e aplicativos do Teams

O RSC (consentimento específico do recurso) é o modelo de permissões para o Teams que define o escopo de determinadas permissões de agente e aplicativo para os recursos (equipes, chats, reuniões e escopos pessoais do usuário) em que os usuários as instalam. Os limites de acesso baseados em recursos capacitam os usuários a tomar suas próprias decisões sobre o acesso de agentes e aplicativos a seus recursos sem exigir o consentimento explícito dos administradores ou afetar os proprietários de outros recursos.

A RSC é baseada em dois conceitos:

  • Permissões com escopo de recurso: As permissões RSC são uma categoria de permissões do Microsoft Graph para agentes e aplicativos que se estendem apenas a equipes, chats, reuniões e escopos pessoais do usuário onde estão instaladas. Os desenvolvedores declaram antecipadamente quais permissões RSC seus agentes e aplicativos precisam, como a capacidade de ler todas as mensagens em um chat ou adicionar membros a uma equipe.
  • Consentimento do usuário: A instalação de um agente ou aplicativo exige a concessão das permissões RSC necessárias. Os usuários, não apenas os administradores, podem instalar agentes e aplicativos por conta própria, pois podem conceder permissões RSC nas equipes, chats e reuniões em que trabalham.

Solicitar e obter permissões RSC

Os desenvolvedores declaram quais permissões RSC um agente ou aplicativo precisa em seu manifesto do aplicativo. Consulte Conceder permissões RSC ao seu aplicativo para obter mais informações.

Quando um usuário tenta instalar o agente ou aplicativo, o Teams apresenta uma solicitação única para conceder as permissões RSC necessárias. Se o usuário consentir e prosseguir com a instalação, as permissões concedidas se estenderão somente à equipe, chat/reunião ou usuário onde a instalou.

A capacidade de um usuário de conceder permissões RSC pode estar sujeita às políticas de administrador e proprietário do recurso. A instalação de um agente ou aplicativo requer consentimento para todas as suas solicitações de permissões RSC: Os usuários não podem conceder ou negar permissões individualmente.

As permissões RSC não são declaradas ou exibidas no centro de administração do Entra. Se você quiser saber as permissões RSC associadas a um aplicativo, consulte a instalação do aplicativo ou a caixa de diálogo de informações do aplicativo no cliente do Teams.

Cenários de acesso: delegado e somente aplicativo

Assim como acontece com outras permissões do Microsoft Graph, cada permissão RSC dá suporte a acesso delegado, acesso somente ao aplicativo ou ambos. Para obter mais informações sobre cenários de acesso delegado e somente aplicativo no modelo de autorização do Microsoft Graph, consulte Cenários do Access.

Qualquer membro de uma equipe ou chat pode conceder permissões RSC delegadas ao instalar um agente ou aplicativo lá, mas somente administradores ou proprietários de recursos podem conceder permissões RSC somente para aplicativos.

APIs de acesso a dados baseadas em RSC

O SDK do Microsoft Graph, o SDK do Teams e a biblioteca de clientes do Microsoft TeamsJS oferecem suporte ao acesso de dados refinado por meio do RSC. Os modos e tipos de recursos com suporte variam entre as superfícies da API.

Modo RSC SDKs com suporte Versão do Manifesto do aplicativo Tipos de recursos Controles relacionados a RSC para todo o locatário Quem pode consentir com as permissões RSC?
Somente aplicativo • Microsoft Graph
• SDK do Teams
>=v1.6 Equipes, chats e reuniões • Controles baseados no Microsoft Graph para chats e reuniões
• Controles baseados no centro de administração do Microsoft Entra para o Teams.
• Equipe: um proprietário ou membro da equipe
• Chat: Um membro do bate-papo
• Reunião: um organizador ou apresentador de reunião
Delegated Cliente do Microsoft Teams >=v1.12 Equipes, chats, reuniões e usuários Sempre Qualquer usuário autorizado a instalar um aplicativo no escopo específico.

Permissões RSC básicas

As equipes de privacidade e segurança da Microsoft revisaram um conjunto limitado de permissões RSC e as consideraram de baixo risco. Qualquer usuário pode consentir com essas permissões a qualquer momento ao instalar e usar um aplicativo. As seguintes permissões básicas de baixo risco sempre são consentidas após a instalação.

Nome da permissão Ação Cenários de acesso com suporte
TeamsActivity.Send.Group Envie notificações de feed de atividades aos usuários desta equipe. Somente aplicativo
TeamsActivity.Send.Chat Envie notificações de feed de atividades para usuários neste chat. Somente aplicativo
TeamsActivity.Send.User Enviar notificações do feed de atividades para o usuário. Somente aplicativo

Além disso, a permissão do TeamsActivity.Send aplicativo RSC está sempre habilitada no nível do locatário. Os usuários do aplicativo não precisam do consentimento do administrador para usá-lo.

Permissões RSC para equipes e canais

Essas permissões RSC se aplicam ao escopo da equipe. Quando um agente ou aplicativo é instalado em uma equipe, suas permissões RSC relacionadas ao canal se estendem automaticamente a todos os canais da equipe, exceto canais privados e compartilhados. As permissões RSC relacionadas ao canal se estendem apenas a canais privados e compartilhados nos quais um usuário adicionou explicitamente o agente ou aplicativo.

Nome da permissão Ação Cenários de acesso com suporte
Channel.Create.Group Criar canais nesta equipe. Somente aplicativo
Channel.Delete.Group Excluir os canais dessa equipe. Somente aplicativo
ChannelMeeting.ReadBasic.Group Leia as propriedades básicas das reuniões do canal nesta equipe. Somente aplicativo
ChannelMeetingParticipant.Read.Group Leia as informações do participante, incluindo nome, função, ID, horário de ingresso e de saída das reuniões do canal associadas a essa equipe. Somente aplicativo
ChannelMeetingRecording.Read.Group Leia as gravações de todas as reuniões do canal associadas a esta equipe. Somente aplicativo
ChannelMeetingNotification.Send.Group Enviar notificações em todas as reuniões do canal associadas a esta equipe. Somente aplicativo
ChannelMessage.Read.Group Leia e receba todas as mensagens do canal desta equipe. Consulte Configurar um agente para receber todas as mensagens em chats e canais em grupo. Somente aplicativo
ChannelMessage.Send.Group Envie mensagens para os canais desta equipe. Somente aplicativo
ChannelSettings.Read.Group Leia os nomes, as descrições e as configurações dos canais desta equipe. Somente aplicativo
ChannelSettings.ReadWrite.Group Atualize os nomes, as descrições e as configurações dos canais desta equipe. Somente aplicativo
TeamsActivity.Send.Group Envie notificações de feed de atividades aos usuários desta equipe. Somente aplicativo
TeamsAppInstallation.Read.Group Leia os aplicativos instalados nesta equipe. Somente aplicativo
TeamMember.Read.Group Leia os membros desta equipe. Somente aplicativo
TeamSettings.Read.Group Leia as configurações dessa equipe. Somente aplicativo
TeamSettings.ReadWrite.Group Leia e escreva as configurações desta equipe. Somente aplicativo
TeamsTab.Create.Group Criar guias nesta equipe. Somente aplicativo
TeamsTab.Delete.Group Excluir as guias dessa equipe. Somente aplicativo
TeamsTab.Read.Group Leia as guias dessa equipe. Somente aplicativo
TeamsTab.ReadWrite.Group Gerencie as guias desta equipe. Somente aplicativo
ChannelMeetingActiveSpeaker.Read.Group Leitura dos participantes que estão enviando áudio para as reuniões do canal associadas a esta equipe. Delegated
ChannelMeetingAudioVideo.Stream.Group Stream o conteúdo de áudio e vídeo das reuniões do canal associadas a esta equipe. Delegated
ChannelMeetingIncomingAudio.Detect.Group Detecte áudio de entrada nas reuniões de canal associadas a esta equipe. Delegated
ChannelMeetingStage.Write.Group Mostrar conteúdo no estágio de reunião das reuniões do canal associadas a esta equipe. Delegated
InAppPurchase.Allow.Group Mostrar e concluir compras no aplicativo para os usuários desta equipe. Delegated
LiveShareSession.ReadWrite.Group Permite que o aplicativo crie e sincronize sessões do Live Share para essa equipe e obtenha acesso a informações relacionadas, como nome e função, sobre a lista dessa equipe e quaisquer reuniões associadas.  Delegated
MeetingParticipantReaction.Read.Group Leia as reações dos participantes nas reuniões do canal associadas a esta equipe. Delegated
ChannelMember.ReadWrite.Group Leia e escreva os membros dos canais desta equipe. Somente aplicativo
ChannelMember.Read.Group Leia os membros dos canais desta equipe. Somente aplicativo
File.Read.Group Leia informações sobre os arquivos e pastas associados aos canais desta equipe. Somente aplicativo

Permissões RSC para chats e reuniões

A única permissão RSC relevante para chats no escopo pessoal é ChatMessageReadReceipt.Read.Chat.

Se um chat tiver uma reunião ou uma chamada associada a ele, as permissões RSC relevantes se aplicarão a esses recursos.

Nome da permissão Ação Cenários de acesso com suporte
Calls.AccessMedia.Chat Acesse fluxos de mídia em chamadas associadas a esse chat ou reunião. Somente aplicativo
Calls.JoinGroupCalls.Chat Participe de chamadas associadas a esse chat ou reunião. Somente aplicativo
ChatSettings.Read.Chat Leia as configurações deste chat. Somente aplicativo
ChatSettings.ReadWrite.Chat Leia e escreva as configurações deste chat. Somente aplicativo
ChatMessage.Read.Chat Leia e receba todas as mensagens do chat. Consulte Configurar um agente para receber todas as mensagens em chats e canais em grupo. Somente aplicativo
ChatMessageReadReceipt.Read.Chat Leia a ID da última mensagem vista neste chat. Somente aplicativo
ChatMember.Read.Chat Leia os membros deste chat. Somente aplicativo
Chat.Manage.Chat Gerenciar este chat Somente aplicativo
TeamsTab.Read.Chat Leia as guias deste chat. Somente aplicativo
TeamsTab.Create.Chat Criar as guias neste chat. Somente aplicativo
TeamsTab.Delete.Chat Exclua as guias deste chat. Somente aplicativo
TeamsTab.ReadWrite.Chat Gerenciar as guias deste chat. Somente aplicativo
TeamsAppInstallation.Read.Chat Leia os aplicativos instalados neste chat. Somente aplicativo
TeamsActivity.Send.Chat Envie notificações de feed de atividades para usuários neste chat. Somente aplicativo
OnlineMeetingTranscript.Read.Chat Leia as transcrições da reunião associada a este chat. Somente aplicativo
OnlineMeeting.ReadBasic.Chat Leia as propriedades básicas das reuniões associadas a esse chat, como nome, agenda, organizador, link de ingresso e notificações de início ou término. Somente aplicativo
OnlineMeetingRecording.Read.Chat Leia as gravações das reuniões associadas a este chat. Somente aplicativo
OnlineMeetingNotification.Send.Chat Enviar notificações nas reuniões associadas a este chat. Somente aplicativo
InAppPurchase.Allow.Chat Mostrar e concluir compras no aplicativo para usuários neste chat e em qualquer reunião associada. Delegated
LiveShareSession.ReadWrite.Chat Permite que o aplicativo crie e sincronize sessões do Live Share para esse chat e obtenha acesso a informações relacionadas, como nome e função, sobre a lista de participantes desse chat e quaisquer reuniões associadas. Delegated
MeetingStage.Write.Chat Mostrar conteúdo no estágio de reunião das reuniões associadas a este chat. Delegated
MeetingParticipantReaction.Read.Chat Leia as reações dos participantes das reuniões associadas a este chat. Delegated
OnlineMeetingIncomingAudio.Detect.Chat Detecte o áudio de entrada nas reuniões associadas a este chat. Delegated
OnlineMeetingActiveSpeaker.Read.Chat Leia os participantes que estão enviando áudio para as reuniões associadas a este chat. Delegated
OnlineMeetingAudioVideo.Stream.Chat Stream o conteúdo de áudio e vídeo das reuniões associadas a este chat. Delegated
OnlineMeetingParticipant.Read.Chat Leia as informações dos participantes, incluindo nome, função, ID, horários de ingresso e saída das reuniões associadas a este chat. Delegado ou somente aplicativo
OnlineMeetingParticipant.ToggleIncomingAudio.Chat Alterne o áudio de entrada para os participantes das reuniões associadas a este chat. Delegated

Permissões RSC para usuários (escopo pessoal)

Nome da permissão Ação Cenários de acesso com suporte
CameraStream.Read.User Leia o fluxo de câmera do usuário. Delegated
InAppPurchase.Allow.User Mostrar e concluir compras no aplicativo. Delegated
MicrophoneStream.Read.User Leia o fluxo do microfone do usuário. Delegated
MeetingParticipantReaction.Read.User Leia as reações do usuário enquanto participa de uma reunião. Delegated
OutgoingVideoStream.Write.User Modifique o vídeo de saída do usuário. Delegated
TeamsActivity.Send.User Enviar notificações de atividade para o usuário. Somente aplicativo
TeamsAppInstallation.Read.User Leia os aplicativos instalados no escopo pessoal do usuário. Somente aplicativo

Próxima etapa

Confira também