Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |