Graph Data Connect y permisos de Microsoft Graph explicados: configuración, consentimiento y privilegios mínimos
Por Mirko Peters ·
Qué hace Microsoft Graph Data Connect, en qué se diferencia de la API de Graph, los pasos de configuración y aprobación, y cómo funcionan los permisos de Graph (delegados, de aplicación y consentimiento).
Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés
Microsoft Graph Data Connect y los permisos de Microsoft Graph son dos temas distintos que a menudo se buscan juntos. Data Connect es un servicio de extracción masiva de datos para la analítica de Microsoft 365. Los permisos de Graph controlan lo que una aplicación puede hacer a través de la API de Graph. Ambos dependen del consentimiento y ambos premian el mismo hábito: pedir el acceso mínimo que haga el trabajo.
Puntos clave
- Graph Data Connect extrae datos de Microsoft 365 en masa hacia Azure Storage para analítica. La API de Graph es más adecuada para pequeñas cantidades de datos de usuarios y grupos seleccionados.
- La configuración requiere un Administrador global que la habilite, un registro de aplicación en Entra, una cuenta de Azure Storage y la aprobación por parte de un administrador de la solicitud de acceso a los datos.
- Las canalizaciones tienen una sobrecarga de unos 45 minutos, y una primera ejecución puede tardar más de 40 minutos, incluido el consentimiento.
- Los permisos de Graph son de dos tipos. Los permisos delegados actúan en nombre de un usuario que ha iniciado sesión. Los permisos de aplicación actúan sin usuario y requieren consentimiento del administrador.
- Microsoft recomienda el modelo delegado siempre que cubra las necesidades de la aplicación, y el permiso más pequeño que funcione.
- Los nombres de los permisos siguen el formato {recurso}.{operación}.{restricción}, como Application.ReadWrite.OwnedBy.
Qué es Graph Data Connect
Microsoft describe Data Connect como un acceso seguro y escalable a conjuntos de datos de Microsoft 365 en Microsoft Fabric, Azure Synapse y Azure Data Factory, para analítica empresarial. Los datos proceden de fuentes como Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights y los grupos de Microsoft.
Los conjuntos de datos se dividen en tres grupos: básicos (contenido sin procesar creado por el cliente), limpios (normalizados o sin duplicados) y curados (diseñados para un escenario concreto). La lista de conjuntos de datos incluye, por ejemplo, TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0 y PlannerTasks_v0. Los conjuntos de datos de Viva Insights requieren una licencia de Viva Insights, que es la única nota sobre licencias en la página de conjuntos de datos.
Data Connect o API de Graph
Las preguntas frecuentes de Data Connect lo resumen así: ambas opciones llegan a los mismos datos subyacentes. Data Connect extrae grandes volúmenes en masa en toda la organización. Las API de Graph son más adecuadas para pequeñas cantidades de datos de usuarios y grupos seleccionados. Las preguntas frecuentes sugieren combinarlas, por ejemplo, Data Connect para la extracción inicial y las API de Graph para el trabajo en tiempo real posterior.
Limitaciones conocidas según las preguntas frecuentes:
- Las canalizaciones tienen una sobrecarga de unos 45 minutos, sea cual sea el tamaño de los datos.
- No se admiten usuarios de Exchange locales, ni siquiera en configuraciones híbridas.
- No se admiten mensajes ni eventos de cuentas de recurso.
- No está disponible el acceso a conjuntos de datos entre inquilinos. Los recursos de Azure y Microsoft 365 deben estar en el mismo inquilino de Entra.
Pasos de configuración
La guía de inicio rápido describe estos pasos. Los nombres de los menús son los que indica Microsoft.
- Habilita Data Connect. Inicia sesión en admin.microsoft.com como Administrador global. Selecciona Configuración > Configuración de la organización y, en la pestaña Servicios, selecciona Microsoft Graph Data Connect. Marca la opción para activarlo en toda la organización y guarda los cambios.
- Crea la aplicación de Entra. En el Centro de administración de Microsoft Entra, ve a Registros de aplicaciones > Nuevo registro. Elige "Solo cuentas de este directorio organizativo." Copia el identificador (de cliente) de la aplicación y el identificador del inquilino, crea un secreto de cliente y guarda su valor de inmediato. El propietario de la aplicación necesita un buzón y, según el inicio rápido, una suscripción E5 activa.
- Crea Azure Storage. Crea una cuenta de almacenamiento en una región que coincida con la región de Microsoft 365. Asigna a la aplicación el rol Colaborador de datos de blobs de Storage en Control de acceso (IAM) y crea un contenedor privado.
- Registra la aplicación en Data Connect en el portal de Azure. Elige el destino, la aplicación, los conjuntos de datos y las columnas.
- Aprueba la solicitud. Un administrador abre Configuración > Configuración de la organización > Seguridad y privacidad > Aplicaciones de Microsoft Graph Data Connect. La aplicación muestra Consentimiento previo. Revisa los conjuntos de datos y selecciona Aprobar. El inicio rápido advierte de que no puedes aprobarla tú mismo.
- Ejecuta la canalización en Synapse, Data Factory o Fabric. El estado pasa por Initializing, Consent Pending, Extracting Data, Persisting Data y Succeeded. La primera ejecución puede tardar más de 40 minutos.
Los destinos compatibles incluyen Azure Data Lake Storage Gen2, Azure Storage Blob, Azure SQL DB (solo con flujos de datos de asignación) y Microsoft Fabric OneLake. La autenticación mediante entidad de servicio es el único mecanismo compatible.
Consentimiento y costes
El consentimiento cubre el alcance de la extracción: conjuntos de datos, columnas, usuarios y destino. Una ejecución con el mismo alcance no necesita una nueva solicitud. La facturación se realiza a través de suscripciones de Azure, por ejecución de canalización, y las unidades fraccionarias se redondean al alza. El ejemplo de las preguntas frecuentes: 20 ejecuciones de 500 filas cada una se facturan como 20 unidades, no como 10. Las páginas consultadas no indican tarifas.
Permisos de Graph: lo básico
Para la API de Graph, Microsoft define dos tipos de permisos.
| | Delegados | De aplicación | |---|---|---| | Actúa | En nombre de un usuario que ha iniciado sesión | Sin usuario | | Acceso efectivo | Limitado por los permisos de la aplicación y por los propios del usuario | Cualquier dato que cubra el permiso | | Quién puede dar consentimiento | Los usuarios, o los administradores para todos los usuarios | Solo el administrador | | Otros nombres | Ámbitos | Roles de aplicación |
El consentimiento para permisos de aplicación requiere el rol Administrador de roles con privilegios o Administrador global. El consentimiento del usuario para permisos delegados todavía puede estar restringido por las directivas de consentimiento de aplicaciones del inquilino.
Nomenclatura y mínimo privilegio
Los permisos siguen el formato {resource}.{operation}.{constraint}. Los ejemplos de la página usan operaciones como Read y ReadWrite, y restricciones como All y OwnedBy. Si no se indica ninguna restricción, el acceso se limita a los datos que posee el usuario que ha iniciado sesión. Por ejemplo, Application.ReadWrite.OwnedBy solo gestiona las aplicaciones que la aplicación crea o posee, mientras que Application.ReadWrite.All gestiona todas.
La recomendación de Microsoft: concede el permiso mínimo necesario. Usa Directory.AccessAsUser.All, Directory.ReadWrite.All y Directory.Read.All con precaución y prefiere permisos de menor alcance. El consentimiento específico de recursos permite que un usuario conceda acceso a una instancia concreta, como un equipo, en lugar de a todo el inquilino. Solo lo admite un subconjunto de funciones.
Problemas habituales
- El registro del agente de conector falla. Learn indica que los permisos delegados no se admiten para el registro del agente de conector. Solicita permisos de aplicación con privilegios mínimos y concede el consentimiento de administrador para todo el inquilino.
- Los miembros solo muestran id y @odata.type. La aplicación no tiene permiso para leer ese tipo de miembro.
- Demasiados permisos en una misma aplicación. Las aplicaciones cuya audiencia de inicio de sesión incluye cuentas personales de Microsoft pueden solicitar como máximo 30 permisos; las audiencias organizativas pueden solicitar hasta 400.
Lo que la documentación no dice
Las páginas de Data Connect consultadas no describen cuánto tiempo sigue vigente una aprobación ni ofrecen tarifas. Tampoco enumeran los requisitos de licencia más allá de la configuración de tutorial del inicio rápido.
Relacionado
- Microsoft Graph Data Connect
- Permisos de Microsoft Graph
- Consentimiento de administrador
- Registro de aplicaciones
Fuentes
- Información general sobre Microsoft Graph Data Connect
- Inicio rápido de Data Connect
- Preguntas frecuentes sobre Data Connect
- Conjuntos de datos, regiones y destinos
- Información general sobre los permisos de Microsoft Graph
Preguntas frecuentes
¿Cuál es la diferencia entre Graph Data Connect y la API de Microsoft Graph?
La sección de preguntas frecuentes de Data Connect en Microsoft Learn indica que ambas opciones dan acceso a los mismos datos subyacentes, pero de formas distintas. Data Connect está diseñado para extraer grandes volúmenes de datos en masa de toda la organización, mientras que las API de Graph son más adecuadas para pequeñas cantidades de datos de usuarios y grupos seleccionados.
¿Quién aprueba una aplicación de Graph Data Connect?
En la guía de inicio rápido de Microsoft, un administrador aprueba la solicitud en el Centro de administración de Microsoft 365, en Configuración > Configuración de la organización > Seguridad y privacidad > Aplicaciones de Microsoft Graph Data Connect. La guía indica que no puedes aprobar tus propias aplicaciones.
¿Cada ejecución de la canalización necesita una nueva solicitud de consentimiento?
No. Según las preguntas frecuentes de Data Connect, mientras el alcance de los conjuntos de datos, las columnas, los usuarios y el destino no cambie, una ejecución no necesita una nueva solicitud de consentimiento. Ejecutar el mismo alcance para fechas distintas también está cubierto.
¿Debe una aplicación usar permisos delegados o de aplicación?
Microsoft Learn indica que los permisos de aplicación tienen privilegios elevados y que, desde el punto de vista de los privilegios mínimos, se recomienda el modelo delegado siempre que cubra las necesidades de la aplicación. Los permisos de aplicación siempre requieren consentimiento del administrador.