Consentimiento específico del recurso para la aplicación de Teams

El consentimiento específico de recursos (RSC) es un marco de autorización creado por Microsoft Teams y la Plataforma de identidad de Microsoft que permite conceder acceso de ámbito a una aplicación.

A través de RSC, un usuario autorizado puede conceder a una aplicación acceso a los datos de una instancia específica de un tipo de recurso. No es necesario que concedan acceso de aplicación a todas las instancias del tipo de recurso en todo el inquilino.

Por ejemplo, una persona propietaria del equipo A y del equipo B puede decidir conceder acceso a la aplicación Contoso a los datos solo del equipo A y no del equipo B. El mismo concepto de acceso a datos de ámbito se aplica también a los chats y las reuniones.

Estos son los tipos de permisos RSC:

  1. El tipo de recurso en el que se concede el acceso a los datos:

    • Teams (y los canales dentro de esos equipos)
    • Chats (y reuniones asociadas con esos chats)
    • Usuarios
  2. El modo de acceso a los datos:

    • Aplicación: la aplicación accede a los datos sin la presencia de un usuario que haya iniciado sesión.
    • Delegado: la aplicación solo tiene acceso a los datos en el contexto de las sesiones de un usuario con la sesión iniciada. No permite el acceso en ausencia de un usuario que haya iniciado sesión.
  Contexto de aplicación Permisos RSC Contexto delegado Permisos RSC
Tipo de recurso    
Equipo ✔️ ✔️
Chat o reunión ✔️ ✔️
Usuario ✔️ ✔️

En esta sección, obtendrás más información sobre:

Tipos de permisos RSC

Use permisos RSC para determinar los métodos de acceso a datos de la aplicación. La capacidad de un usuario para conceder permisos RSC varía en función de los tipos de recursos y los modos de acceso. Los siguientes son los tipos de permisos RSC para una aplicación según el modo de acceso:

  • Contexto de aplicación Permisos RSC (permiso de aplicación): permite a una aplicación acceder a los datos sin que el usuario haya iniciado sesión. Solo los propietarios de recursos pueden conceder permisos RSC a la aplicación.

  • Contexto delegado Permisos RSC (permiso delegado): permite que una aplicación acceda a los datos solo en nombre de un usuario que ha iniciado sesión. No se permite el acceso en ausencia de un usuario que haya iniciado sesión. Solo los usuarios autorizados pueden instalar una aplicación en un ámbito específico. También pueden conceder los permisos RSC delegados que solicite la aplicación en ese ámbito específico en la instalación de la aplicación. Por ejemplo, si los miembros regulares tienen permiso para instalar una aplicación dentro de un equipo, también pueden otorgar permiso RSC delegado a la aplicación en ese equipo específico.

Permisos RSC básicos

Los equipos de privacidad y seguridad de Microsoft han revisado un conjunto limitado de permisos RSC y se han considerado de riesgo bajo. Cualquier usuario puede aceptar estos permisos en todo momento cuando instala y usa una aplicación. Durante la instalación, siempre se aceptan los siguientes permisos básicos de bajo riesgo.

Nombre del permiso Acción Tipo: delegado Tipo: Aplicación
TeamsActivity.Send.Group Enviar notificaciones de fuente de actividad a los usuarios de este equipo. ND Compatible
TeamsActivity.Send.Chat Enviar notificaciones de fuente de actividad a los usuarios en este chat. ND Compatible
TeamsActivity.Send.User Enviar notificaciones del panel de actividades al usuario. ND Compatible

API de acceso de datos basadas en RSC

Microsoft Graph SDK, Microsoft Bot Framework SDK y la biblioteca cliente de Microsoft TeamsJS admiten el acceso a datos específicos a través de RSC. Los modos admitidos y los tipos de recursos varían en las superficies de API.

Modo RSC SDK compatibles Versión del manifiesto de la aplicación Tipos de recursos Controles relacionados con RSC para todo el inquilino ¿Quién puede dar su consentimiento a los permisos de RSC?
Aplicación • Microsoft Graph
• Microsoft Bot Framework
>=v1.6 Equipos, chats y reuniones • Controles basados en Microsoft Graph para chats y reuniones
• Controles basados en el Centro de administración de Microsoft Entra para Teams
• Equipo: un propietario o miembro del equipo
• Chat: un miembro del chat
• Reunión: un organizador o moderador de la reunión
Delegated Cliente de Microsoft Teams >=v1.12 Equipos, chats, reuniones y usuarios Siempre activo Cualquier usuario autorizado para instalar una aplicación en el ámbito específico.

Nota:

El permiso de TeamsActivity.Send aplicación RSC siempre está habilitado en el nivel de inquilino. Los usuarios de la aplicación no necesitan el consentimiento del administrador para usar el permiso.

Permisos RSC admitidos

En la lista siguiente se proporcionan todos los permisos RSC clasificados según el tipo de recurso. Cada tabla también indica qué modos de acceso a datos están disponibles para cada permiso.

Nota:

Es posible que las características asociadas a algunos permisos enumerados aquí no estén disponibles de forma general (GA).

Permisos RSC para un equipo

En la tabla siguiente se proporcionan los permisos de aplicación RSC para un equipo y su modo de acceso de datos aplicable:

Nombre del permiso Acción Tipo: delegado Tipo: Aplicación
Channel.Create.Group Crear canales en este equipo. ND Compatible
Channel.Delete.Group Eliminar los canales de este equipo. ND Compatible
ChannelMeeting.ReadBasic.Group Lea las propiedades básicas de las reuniones de canal de este equipo. ND Compatible
ChannelMeetingParticipant.Read.Group Lea la información de los participantes, incluidos el nombre, el rol, el id., la unión y la hora de salida de las reuniones del canal asociadas con este equipo. ND Compatible
ChannelMeetingRecording.Read.Group Lea las grabaciones de todas las reuniones del canal asociadas con este equipo. ND Compatible
ChannelMeetingNotification.Send.Group Envíe notificaciones en todas las reuniones del canal asociadas a este equipo. ND Compatible
ChannelMessage.Read.Group Lea los mensajes del canal de este equipo. ND Compatible
ChannelMessage.Send.Group Enviar mensajes a los canales de este equipo. ND Compatible
ChannelSettings.Read.Group Lea los nombres, las descripciones y la configuración de los canales de este equipo. ND Compatible
ChannelSettings.ReadWrite.Group Actualice los nombres, las descripciones y la configuración de los canales de este equipo. ND Compatible
TeamsActivity.Send.Group Enviar notificaciones de fuente de actividad a los usuarios de este equipo. ND Compatible
TeamsAppInstallation.Read.Group Lea las aplicaciones instaladas en este equipo. ND Compatible
TeamMember.Read.Group Leer a los miembros de este equipo. ND Compatible
TeamSettings.Read.Group Leer la configuración de este equipo. ND Compatible
TeamSettings.ReadWrite.Group Lea y escriba la configuración de este equipo. ND Compatible
TeamsTab.Create.Group Crear pestañas en este equipo. ND Compatible
TeamsTab.Delete.Group Eliminar las pestañas de este equipo. ND Compatible
TeamsTab.Read.Group Leer las pestañas de este equipo. ND Compatible
TeamsTab.ReadWrite.Group Administrar las pestañas de este equipo. ND Compatible
ChannelMeetingActiveSpeaker.Read.Group Leer a los participantes que envían audio a las reuniones de canal asociadas con este equipo. Compatible ND
ChannelMeetingAudioVideo.Stream.Group Haga Stream el contenido de audio y vídeo de las reuniones del canal asociadas con este equipo. Compatible ND
ChannelMeetingIncomingAudio.Detect.Group Detecta audio entrante en las reuniones del canal asociadas con este equipo. Compatible ND
ChannelMeetingStage.Write.Group Mostrar contenido en la fase de reunión de las reuniones de canal asociadas a este equipo. Compatible ND
InAppPurchase.Allow.Group Mostrar y completar las compras desde la aplicación para los usuarios de este equipo. Compatible ND
LiveShareSession.ReadWrite.Group Permite a la aplicación crear y sincronizar sesiones de Live Share para este equipo y obtener acceso a información relacionada, como el nombre y el rol, sobre la lista de este equipo y cualquier reunión asociada.  Compatible ND
MeetingParticipantReaction.Read.Group Lea las reacciones de los participantes en las reuniones del canal asociadas con este equipo. Compatible ND
ChannelMember.ReadWrite.Group Lea y escriba los miembros de los canales de este equipo. ND ND
ChannelMember.Read.Group Lea los canales de los miembros de este equipo. ND ND

Para obtener más información, consulte permisos de consentimiento específicos del recurso de equipo.

Permisos RSC para un chat o reunión

Nota:

Los permisos de RSC para el chat en el ámbito personal se limitan a ChatMessageReadReceipt.Read.Chat.

Si un chat tiene una reunión o una llamada asociada, los permisos RSC pertinentes también se aplican a esos recursos.

En la tabla siguiente se proporcionan los permisos RSC para un chat o una reunión y su modo de acceso a datos aplicable:

Nombre del permiso Acción Tipo: delegado Tipo: Aplicación
Calls.AccessMedia.Chat Accede a secuencias multimedia en llamadas asociadas a este chat o reunión. ND Compatible
Calls.JoinGroupCalls.Chat Unirse a llamadas asociadas a este chat o reunión. ND Compatible
ChatSettings.Read.Chat Leer la configuración de este chat. ND Compatible
ChatSettings.ReadWrite.Chat Leer y escribir en la configuración de este chat. ND Compatible
ChatMessage.Read.Chat Leer los mensajes de este chat. ND Compatible
ChatMessageReadReceipt.Read.Chat Lea el identificador del último mensaje visto en este chat. ND Compatible
ChatMember.Read.Chat Leer los miembros de este chat. ND Compatible
Chat.Manage.Chat Administrar este chat. ND Compatible
TeamsTab.Read.Chat Leer las pestañas de este chat. ND Compatible
TeamsTab.Create.Chat Crear pestañas en este chat. ND Compatible
TeamsTab.Delete.Chat Eliminar las pestañas de este chat. ND Compatible
TeamsTab.ReadWrite.Chat Administrar las pestañas de este chat. ND Compatible
TeamsAppInstallation.Read.Chat Lee las aplicaciones instaladas en este chat. ND Compatible
TeamsActivity.Send.Chat Enviar notificaciones de fuente de actividad a los usuarios en este chat. ND Compatible
OnlineMeetingTranscript.Read.Chat Lea las transcripciones de la reunión asociada a este chat. ND Compatible
OnlineMeeting.ReadBasic.Chat Lea las propiedades básicas de las reuniones asociadas con este chat, como el nombre, la programación, el organizador, el vínculo para unirse y las notificaciones de inicio o finalización. ND Compatible
OnlineMeetingRecording.Read.Chat Lea las grabaciones de las reuniones asociadas a este chat. ND Compatible
OnlineMeetingNotification.Send.Chat Envíe notificaciones en las reuniones asociadas a este chat. ND Compatible
InAppPurchase.Allow.Chat Mostrar y completar las compras desde la aplicación para los usuarios en este chat y en cualquier reunión asociada. Compatible ND
LiveShareSession.ReadWrite.Chat Permite a la aplicación crear y sincronizar sesiones de Live Share para este chat y obtener acceso a información relacionada, como el nombre y el rol, sobre la lista de este chat y las reuniones asociadas. Compatible ND
MeetingStage.Write.Chat Mostrar contenido en la fase de reunión de reuniones asociadas a este chat. Compatible ND
MeetingParticipantReaction.Read.Chat Lea las reacciones de los participantes en las reuniones asociadas con este chat. Compatible ND
OnlineMeetingIncomingAudio.Detect.Chat Detecta audio entrante en las reuniones asociadas con este chat. Compatible ND
OnlineMeetingActiveSpeaker.Read.Chat Lea a los participantes que envían audio a las reuniones asociadas a este chat. Compatible ND
OnlineMeetingAudioVideo.Stream.Chat Haga Stream el contenido de audio y vídeo de las reuniones asociadas a este chat. Compatible ND
OnlineMeetingParticipant.Read.Chat Lea la información de los participantes, incluido el nombre, el rol, el id., las horas a las que se unió y se fue, de las reuniones asociadas a este chat. Compatible Compatible
OnlineMeetingParticipant.ToggleIncomingAudio.Chat Alternar el audio entrante para los participantes en las reuniones asociadas con este chat. Compatible ND

Para obtener más información, consulte permisos de consentimiento específicos del recurso de chat.

Sugerencia

Los permisos RSC solo están disponibles para las aplicaciones de Teams instaladas en el cliente de Teams y no forman parte del Centro de administración de Microsoft Entra. Si desea conocer los permisos RSC asociados a una aplicación, consulte Cuadro de diálogo Instalación de la aplicación o Información de la aplicación en el cliente de Teams.

Permisos RSC para el acceso de usuarios

En la tabla siguiente se proporcionan los permisos RSC para un usuario y su modo de acceso de datos aplicable:

Nombre del permiso Acción Tipo: delegado Tipo: Aplicación
CameraStream.Read.User Leer la secuencia de la cámara del usuario. Compatible ND
InAppPurchase.Allow.User Mostrar y completar compras desde la aplicación. Compatible ND
MicrophoneStream.Read.User Leer la secuencia de micrófonos del usuario. Compatible ND
MeetingParticipantReaction.Read.User Lea las reacciones del usuario mientras participa en una reunión. Compatible ND
OutgoingVideoStream.Write.User Modificar el vídeo saliente del usuario. Compatible ND
TeamsActivity.Send.User Enviar notificaciones de actividad al usuario. ND Compatible
TeamsAppInstallation.Read.User Lea las aplicaciones instaladas en el ámbito personal del usuario. ND Compatible

Paso siguiente

Vea también