Consentimiento específico del recurso para agentes y aplicaciones de Teams

El consentimiento específico de recursos (RSC) es el modelo de permisos para Teams que aplica determinados permisos de agente y aplicación a los recursos (equipos, chats, reuniones y ámbitos personales del usuario) donde los usuarios los instalan. Los límites de acceso basados en recursos permiten a los usuarios tomar sus propias decisiones sobre el acceso de agentes y aplicaciones a sus recursos sin requerir el consentimiento explícito de los administradores ni afectar a los propietarios de otros recursos.

RSC se basa en dos conceptos:

  • Permisos de ámbito de recursos: los permisos RSC son una categoría de permisos de Microsoft Graph para agentes y aplicaciones que solo se extienden a los equipos, chats, reuniones y ámbitos personales del usuario donde están instalados. Los desarrolladores declaran por adelantado qué permisos RSC necesitan sus agentes y aplicaciones, como la capacidad de leer todos los mensajes de un chat o agregar miembros a un equipo.
  • Consentimiento del usuario: para instalar un agente o una aplicación es necesario concederle los permisos RSC que necesita. Los usuarios, no solo los administradores, pueden instalar agentes y aplicaciones por sí mismos, ya que pueden conceder permisos RSC en los equipos, chats y reuniones en los que trabajan.

Solicitud y obtención de permisos RSC

Los desarrolladores declaran qué permisos RSC necesita un agente o una aplicación en su manifiesto de aplicación. Consulte Conceder permisos RSC a la aplicación para obtener más información.

Cuando un usuario intenta instalar el agente o la aplicación, Teams le presenta una solicitud única para conceder los permisos RSC que necesita. Si el usuario da su consentimiento y continúa con la instalación, los permisos concedidos se extienden solo al equipo, chat o reunión o usuario donde lo instaló.

La capacidad de un usuario para conceder permisos RSC puede estar sujeta a directivas de administrador y propietario del recurso. Para instalar un agente o una aplicación es necesario dar su consentimiento a todas sus solicitudes de permisos RSC: los usuarios no pueden conceder ni denegar permisos individualmente.

Los permisos RSC no se declaran ni se muestran en el centro de administración de Entra. Si desea conocer los permisos RSC asociados a una aplicación, consulte el cuadro de diálogo de instalación de la aplicación o información de la aplicación en el cliente de Teams.

Escenarios de acceso: delegado y solo de aplicación

Al igual que con otros permisos de Microsoft Graph, cada permiso RSC admite acceso delegado, acceso solo de aplicación o ambos. Para obtener más información sobre los escenarios de acceso delegado y solo de aplicación en el modelo de autorización de Microsoft Graph, consulte Escenarios de acceso.

Cualquier miembro de un equipo o chat puede conceder permisos RSC delegados al instalar un agente o una aplicación allí, pero solo los administradores o propietarios de recursos pueden conceder permisos RSC solo de aplicación.

API de acceso de datos basadas en RSC

El SDK de Microsoft Graph, el SDK de Teams 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?
Solo aplicación • Microsoft Graph
• SDK de Teams
>=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.

Permisos RSC básicos

Los equipos de privacidad y seguridad de Microsoft han revisado un conjunto limitado de permisos RSC y los han considerado de bajo riesgo. Cualquier usuario puede aceptar estos permisos en cualquier 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 Escenarios de acceso admitidos
TeamsActivity.Send.Group Enviar notificaciones de fuente de actividad a los usuarios de este equipo. Solo aplicación
TeamsActivity.Send.Chat Enviar notificaciones de fuente de actividad a los usuarios en este chat. Solo aplicación
TeamsActivity.Send.User Enviar notificaciones del panel de actividades al usuario. Solo aplicación

Además, 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 usarla.

Permisos RSC para equipos y canales

Estos permisos RSC se aplican en el ámbito de equipo. Cuando se instala un agente o una aplicación en un equipo, sus permisos RSC relacionados con el canal se extienden automáticamente a todos los canales del equipo, excepto los canales privados y compartidos. Los permisos RSC relacionados con el canal solo se extienden a canales privados y compartidos en los que un usuario ha agregado explícitamente el agente o la aplicación.

Nombre del permiso Acción Escenarios de acceso admitidos
Channel.Create.Group Crear canales en este equipo. Solo aplicación
Channel.Delete.Group Eliminar los canales de este equipo. Solo aplicación
ChannelMeeting.ReadBasic.Group Lea las propiedades básicas de las reuniones de canal de este equipo. Solo aplicación
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. Solo aplicación
ChannelMeetingRecording.Read.Group Lea las grabaciones de todas las reuniones del canal asociadas con este equipo. Solo aplicación
ChannelMeetingNotification.Send.Group Envíe notificaciones en todas las reuniones del canal asociadas a este equipo. Solo aplicación
ChannelMessage.Read.Group Lea y reciba todos los mensajes de canal de este equipo. Consulte Configuración de un agente para recibir todos los mensajes en chats grupales y canales. Solo aplicación
ChannelMessage.Send.Group Enviar mensajes a los canales de este equipo. Solo aplicación
ChannelSettings.Read.Group Lea los nombres, las descripciones y la configuración de los canales de este equipo. Solo aplicación
ChannelSettings.ReadWrite.Group Actualice los nombres, las descripciones y la configuración de los canales de este equipo. Solo aplicación
TeamsActivity.Send.Group Enviar notificaciones de fuente de actividad a los usuarios de este equipo. Solo aplicación
TeamsAppInstallation.Read.Group Lea las aplicaciones instaladas en este equipo. Solo aplicación
TeamMember.Read.Group Leer a los miembros de este equipo. Solo aplicación
TeamSettings.Read.Group Leer la configuración de este equipo. Solo aplicación
TeamSettings.ReadWrite.Group Lea y escriba la configuración de este equipo. Solo aplicación
TeamsTab.Create.Group Crear pestañas en este equipo. Solo aplicación
TeamsTab.Delete.Group Eliminar las pestañas de este equipo. Solo aplicación
TeamsTab.Read.Group Leer las pestañas de este equipo. Solo aplicación
TeamsTab.ReadWrite.Group Administrar las pestañas de este equipo. Solo aplicación
ChannelMeetingActiveSpeaker.Read.Group Leer a los participantes que envían audio a las reuniones de canal asociadas con este equipo. Delegated
ChannelMeetingAudioVideo.Stream.Group Haga Stream el contenido de audio y vídeo de las reuniones del canal asociadas con este equipo. Delegated
ChannelMeetingIncomingAudio.Detect.Group Detecta audio entrante en las reuniones del canal asociadas con este equipo. Delegated
ChannelMeetingStage.Write.Group Mostrar contenido en la fase de reunión de las reuniones de canal asociadas a este equipo. Delegated
InAppPurchase.Allow.Group Mostrar y completar las compras desde la aplicación para los usuarios de este equipo. Delegated
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.  Delegated
MeetingParticipantReaction.Read.Group Lea las reacciones de los participantes en las reuniones del canal asociadas con este equipo. Delegated
ChannelMember.ReadWrite.Group Lea y escriba los miembros de los canales de este equipo. Solo aplicación
ChannelMember.Read.Group Lea los canales de los miembros de este equipo. Solo aplicación
File.Read.Group Obtenga información sobre los archivos y carpetas asociados a los canales de este equipo. Solo aplicación

Permisos RSC para chats y reuniones

El único permiso RSC relevante para los chats en el ámbito personal es ChatMessageReadReceipt.Read.Chat.

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

Nombre del permiso Acción Escenarios de acceso admitidos
Calls.AccessMedia.Chat Accede a secuencias multimedia en llamadas asociadas a este chat o reunión. Solo aplicación
Calls.JoinGroupCalls.Chat Unirse a llamadas asociadas a este chat o reunión. Solo aplicación
ChatSettings.Read.Chat Leer la configuración de este chat. Solo aplicación
ChatSettings.ReadWrite.Chat Leer y escribir en la configuración de este chat. Solo aplicación
ChatMessage.Read.Chat Lea y reciba todos los mensajes de este chat. Consulte Configuración de un agente para recibir todos los mensajes en chats grupales y canales. Solo aplicación
ChatMessageReadReceipt.Read.Chat Lea el identificador del último mensaje visto en este chat. Solo aplicación
ChatMember.Read.Chat Leer los miembros de este chat. Solo aplicación
Chat.Manage.Chat Administrar este chat. Solo aplicación
TeamsTab.Read.Chat Leer las pestañas de este chat. Solo aplicación
TeamsTab.Create.Chat Crear pestañas en este chat. Solo aplicación
TeamsTab.Delete.Chat Eliminar las pestañas de este chat. Solo aplicación
TeamsTab.ReadWrite.Chat Administrar las pestañas de este chat. Solo aplicación
TeamsAppInstallation.Read.Chat Lee las aplicaciones instaladas en este chat. Solo aplicación
TeamsActivity.Send.Chat Enviar notificaciones de fuente de actividad a los usuarios en este chat. Solo aplicación
OnlineMeetingTranscript.Read.Chat Lea las transcripciones de la reunión asociada a este chat. Solo aplicación
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. Solo aplicación
OnlineMeetingRecording.Read.Chat Lea las grabaciones de las reuniones asociadas a este chat. Solo aplicación
OnlineMeetingNotification.Send.Chat Envíe notificaciones en las reuniones asociadas a este chat. Solo aplicación
InAppPurchase.Allow.Chat Mostrar y completar las compras desde la aplicación para los usuarios en este chat y en cualquier reunión asociada. Delegated
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. Delegated
MeetingStage.Write.Chat Mostrar contenido en la fase de reunión de reuniones asociadas a este chat. Delegated
MeetingParticipantReaction.Read.Chat Lea las reacciones de los participantes en las reuniones asociadas con este chat. Delegated
OnlineMeetingIncomingAudio.Detect.Chat Detecta audio entrante en las reuniones asociadas con este chat. Delegated
OnlineMeetingActiveSpeaker.Read.Chat Lea a los participantes que envían audio a las reuniones asociadas a este chat. Delegated
OnlineMeetingAudioVideo.Stream.Chat Haga Stream el contenido de audio y vídeo de las reuniones asociadas a este chat. Delegated
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. Delegado o solo de aplicación
OnlineMeetingParticipant.ToggleIncomingAudio.Chat Alternar el audio entrante para los participantes en las reuniones asociadas con este chat. Delegated

Permisos RSC para usuarios (ámbito personal)

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

Paso siguiente

Vea también