Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O RSC (consentimento específico de recurso) é uma estrutura de autorização criada pelo Microsoft Teams e pela plataforma de identidade da Microsoft que permite conceder acesso com escopo a um aplicativo.
Por meio do RSC, um usuário autorizado pode conceder a um aplicativo acesso aos dados de uma instância específica de um tipo de recurso. Eles não precisam dar acesso ao aplicativo a todas as instâncias do tipo de recurso em todo o locatário.
Por exemplo, uma pessoa que possui a equipe A e a equipe B pode decidir conceder acesso ao aplicativo Contoso aos dados apenas da equipe A e não da equipe B. O mesmo conceito de acesso a dados no escopo também se aplica a chats e reuniões.
A seguir estão os tipos de permissões RSC:
O tipo de recurso no qual o acesso a dados está sendo concedido:
- Teams (e os canais dentro dessas equipes)
- Chats (e reuniões associadas a esses chats)
- Usuários
O modo de acesso a dados:
- Aplicativo: o aplicativo acessa dados sem a presença de um usuário conectado.
- Delegado: o aplicativo só acessa dados no contexto das sessões de um usuário conectado. Ele não permite o acesso na ausência de um usuário conectado.
| Contexto do aplicativo Permissões RSC | Permissões RSC de contexto delegado | |
|---|---|---|
| Tipo de recurso | ||
| Equipe | ✔️ | ✔️ |
| Chat ou reunião | ✔️ | ✔️ |
| Usuário | ✔️ | ✔️ |
Nesta seção, você aprenderá mais sobre:
Tipos de permissões RSC
Use permissões RSC para determinar os métodos de acesso a dados para seu aplicativo. A capacidade de um usuário de conceder permissões RSC varia de acordo com os tipos de recursos e modos de acesso. A seguir estão os tipos de permissões RSC para um aplicativo com base no modo de acesso:
Contexto do aplicativo Permissões RSC (permissão do aplicativo): permite que um aplicativo acesse dados sem que o usuário esteja conectado. Somente os proprietários de recursos podem conceder permissões RSC do aplicativo.
Contexto delegado Permissões RSC (permissão delegada): permite que um aplicativo acesse dados somente em nome de um usuário conectado. Nenhum acesso é permitido na ausência de um usuário conectado. Somente usuários autorizados podem instalar um aplicativo em um escopo específico. Eles também podem conceder quaisquer permissões RSC delegadas que o aplicativo solicite nesse escopo específico na instalação do aplicativo. Por exemplo, se os membros regulares tiverem permissão para instalar um aplicativo dentro de uma equipe, eles também poderão conceder a permissão RSC delegada ao aplicativo nessa equipe específica.
Permissões RSC Básicas
Um conjunto limitado de permissões RSC foi revisado pelas equipes de privacidade e segurança da Microsoft e foi considerado de baixo risco. Essas permissões podem ser consentidas a qualquer momento por qualquer usuário quando ele instala e usa 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 | Tipo: delegado | Tipo: Aplicativo |
|---|---|---|---|
TeamsActivity.Send.Group |
Envie notificações de feed de atividades aos usuários desta equipe. | NA | Com suporte |
TeamsActivity.Send.Chat |
Envie notificações de feed de atividades para usuários neste chat. | NA | Com suporte |
TeamsActivity.Send.User |
Enviar notificações do feed de atividades para o usuário. | NA | Com suporte |
APIs de acesso a dados baseadas em RSC
O SDK do Microsoft Graph, o SDK do Microsoft Bot Framework e a biblioteca de clientes do Microsoft TeamsJS dão suporte ao acesso de dados refinados 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? |
|---|---|---|---|---|---|
| Application | • Microsoft Graph • Microsoft Bot Framework |
>=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. |
Observação
A TeamsActivity.Send permissão do aplicativo RSC está sempre habilitada no nível do locatário. Os usuários do aplicativo não precisam do consentimento do administrador para usar a permissão.
Permissões RSC com suporte
A lista a seguir fornece todas as permissões RSC categorizadas com base no tipo de recurso. Cada tabela também informa quais modos de acesso a dados estão disponíveis para cada permissão.
- Permissões RSC para uma equipe: inclui os canais dentro de uma equipe.
- Permissões RSC para um chat ou reunião: inclui as reuniões associadas aos chats.
- Permissões RSC para acesso do usuário: inclui permissão para que os usuários acessem diferentes recursos.
Observação
Os recursos associados a algumas permissões listadas aqui podem não estar em disponibilidade geral (GA).
Permissões RSC para uma equipe
A tabela a seguir fornece permissões de aplicativo RSC para uma equipe e seu modo de acesso a dados aplicável:
| Nome da permissão | Ação | Tipo: delegado | Tipo: Aplicativo |
|---|---|---|---|
Channel.Create.Group |
Criar canais nesta equipe. | NA | Com suporte |
Channel.Delete.Group |
Excluir os canais dessa equipe. | NA | Com suporte |
ChannelMeeting.ReadBasic.Group |
Leia as propriedades básicas das reuniões do canal nesta equipe. | NA | Com suporte |
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. | NA | Com suporte |
ChannelMeetingRecording.Read.Group |
Leia as gravações de todas as reuniões do canal associadas a esta equipe. | NA | Com suporte |
ChannelMeetingTranscript.Read.Group |
Leia as transcrições de todas as reuniões do canal associadas a esta equipe. | NA | Com suporte |
ChannelMeetingNotification.Send.Group |
Enviar notificações em todas as reuniões do canal associadas a esta equipe. | NA | Com suporte |
ChannelMessage.Read.Group |
Leia as mensagens do canal desta equipe. | NA | Com suporte |
ChannelMessage.Send.Group |
Envie mensagens para os canais desta equipe. | NA | Com suporte |
ChannelSettings.Read.Group |
Leia os nomes, as descrições e as configurações dos canais desta equipe. | NA | Com suporte |
ChannelSettings.ReadWrite.Group |
Atualize os nomes, as descrições e as configurações dos canais desta equipe. | NA | Com suporte |
TeamsActivity.Send.Group |
Envie notificações de feed de atividades aos usuários desta equipe. | NA | Com suporte |
TeamsAppInstallation.Read.Group |
Leia os aplicativos instalados nesta equipe. | NA | Com suporte |
TeamMember.Read.Group |
Leia os membros desta equipe. | NA | Com suporte |
TeamSettings.Read.Group |
Leia as configurações dessa equipe. | NA | Com suporte |
TeamSettings.ReadWrite.Group |
Leia e escreva as configurações desta equipe. | NA | Com suporte |
TeamsTab.Create.Group |
Criar guias nesta equipe. | NA | Com suporte |
TeamsTab.Delete.Group |
Excluir as guias dessa equipe. | NA | Com suporte |
TeamsTab.Read.Group |
Leia as guias dessa equipe. | NA | Com suporte |
TeamsTab.ReadWrite.Group |
Gerencie as guias desta equipe. | NA | Com suporte |
ChannelMeetingActiveSpeaker.Read.Group |
Leitura dos participantes que estão enviando áudio para as reuniões do canal associadas a esta equipe. | Com suporte | NA |
ChannelMeetingAudioVideo.Stream.Group |
Stream o conteúdo de áudio e vídeo das reuniões do canal associadas a esta equipe. | Com suporte | NA |
ChannelMeetingIncomingAudio.Detect.Group |
Detecte áudio de entrada nas reuniões de canal associadas a esta equipe. | Com suporte | NA |
ChannelMeetingStage.Write.Group |
Mostrar conteúdo no estágio de reunião das reuniões do canal associadas a esta equipe. | Com suporte | NA |
InAppPurchase.Allow.Group |
Mostrar e concluir compras no aplicativo para os usuários desta equipe. | Com suporte | NA |
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. | Com suporte | NA |
MeetingParticipantReaction.Read.Group |
Leia as reações dos participantes nas reuniões do canal associadas a esta equipe. | Com suporte | NA |
ChannelMember.ReadWrite.Group |
Leia e escreva os membros dos canais desta equipe. | NA | NA |
ChannelMember.Read.Group |
Leia os membros dos canais desta equipe. | NA | NA |
Para obter mais informações, consulte permissões de consentimento específicas do recurso de equipe.
Permissões RSC para um chat ou reunião
Observação
As permissões RSC para chat no escopo pessoal são limitadas a ChatMessageReadReceipt.Read.Chat.
Se um chat tiver uma reunião ou uma chamada associada a ele, as permissões RSC relevantes também se aplicarão a esses recursos.
A tabela a seguir fornece permissões RSC para um chat ou reunião e seu modo de acesso a dados aplicável:
| Nome da permissão | Ação | Tipo: delegado | Tipo: Aplicativo |
|---|---|---|---|
Calls.AccessMedia.Chat |
Acesse fluxos de mídia em chamadas associadas a esse chat ou reunião. | NA | Com suporte |
Calls.JoinGroupCalls.Chat |
Participe de chamadas associadas a esse chat ou reunião. | NA | Com suporte |
ChatSettings.Read.Chat |
Leia as configurações deste chat. | NA | Com suporte |
ChatSettings.ReadWrite.Chat |
Leia e escreva as configurações deste chat. | NA | Com suporte |
ChatMessage.Read.Chat |
Leia as mensagens deste chat. | NA | Com suporte |
ChatMessageReadReceipt.Read.Chat |
Leia a ID da última mensagem vista neste chat. | NA | Com suporte |
ChatMember.Read.Chat |
Leia os membros deste chat. | NA | Com suporte |
Chat.Manage.Chat |
Gerenciar este chat | NA | Com suporte |
TeamsTab.Read.Chat |
Leia as guias deste chat. | NA | Com suporte |
TeamsTab.Create.Chat |
Criar as guias neste chat. | NA | Com suporte |
TeamsTab.Delete.Chat |
Exclua as guias deste chat. | NA | Com suporte |
TeamsTab.ReadWrite.Chat |
Gerenciar as guias deste chat. | NA | Com suporte |
TeamsAppInstallation.Read.Chat |
Leia os aplicativos instalados neste chat. | NA | Com suporte |
TeamsActivity.Send.Chat |
Envie notificações de feed de atividades para usuários neste chat. | NA | Com suporte |
OnlineMeetingTranscript.Read.Chat |
Leia as transcrições da reunião associada a este chat. | NA | Com suporte |
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. | NA | Com suporte |
OnlineMeetingRecording.Read.Chat |
Leia as gravações das reuniões associadas a este chat. | NA | Com suporte |
OnlineMeetingNotification.Send.Chat |
Enviar notificações nas reuniões associadas a este chat. | NA | Com suporte |
InAppPurchase.Allow.Chat |
Mostrar e concluir compras no aplicativo para usuários neste chat e em qualquer reunião associada. | Com suporte | NA |
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. | Com suporte | NA |
MeetingStage.Write.Chat |
Mostrar conteúdo no estágio de reunião das reuniões associadas a este chat. | Com suporte | NA |
MeetingParticipantReaction.Read.Chat |
Leia as reações dos participantes das reuniões associadas a este chat. | Com suporte | NA |
OnlineMeetingIncomingAudio.Detect.Chat |
Detecte o áudio de entrada nas reuniões associadas a este chat. | Com suporte | NA |
OnlineMeetingActiveSpeaker.Read.Chat |
Leia os participantes que estão enviando áudio para as reuniões associadas a este chat. | Com suporte | NA |
OnlineMeetingAudioVideo.Stream.Chat |
Stream o conteúdo de áudio e vídeo das reuniões associadas a este chat. | Com suporte | NA |
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. | Com suporte | Com suporte |
OnlineMeetingParticipant.ToggleIncomingAudio.Chat |
Alterne o áudio de entrada para os participantes das reuniões associadas a este chat. | Com suporte | NA |
Para obter mais informações, consulte permissões de consentimento específicas do recurso de chat.
Dica
As permissões RSC estão disponíveis apenas para aplicativos do Teams instalados no cliente do Teams e não para parte do centro de administração do Microsoft 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.
Permissões RSC para acesso do usuário
A tabela a seguir fornece permissões RSC para um usuário e seu modo de acesso a dados aplicável:
| Nome da permissão | Ação | Tipo: delegado | Tipo: Aplicativo |
|---|---|---|---|
CameraStream.Read.User |
Leia o fluxo de câmera do usuário. | Com suporte | NA |
InAppPurchase.Allow.User |
Mostrar e concluir compras no aplicativo. | Com suporte | NA |
MicrophoneStream.Read.User |
Leia o fluxo do microfone do usuário. | Com suporte | NA |
MeetingParticipantReaction.Read.User |
Leia as reações do usuário enquanto participa de uma reunião. | Com suporte | NA |
OutgoingVideoStream.Write.User |
Modifique o vídeo de saída do usuário. | Com suporte | NA |
TeamsActivity.Send.User |
Enviar notificações de atividade para o usuário. | NA | Com suporte |
TeamsAppInstallation.Read.User |
Leia os aplicativos instalados no escopo pessoal do usuário. | NA | Com suporte |
Próxima etapa
Confira também
Colabore connosco no GitHub
A origem deste conteúdo pode ser encontrada no GitHub, onde também pode criar e rever problemas e pedidos Pull. Para mais informações, consulte o nosso guia do contribuidor.