Introducción a Microsoft Graph

Implementar la seguridad de Azure para desarrolladores

Anushika Agarwal

Cloud Data Engineer

¿Qué es Microsoft Graph?

  • API unificada para acceder a datos de Microsoft 365

  • Un único endpoint para todos los servicios

Microsoft Graph - Un único endpoint para todos los servicios

Implementar la seguridad de Azure para desarrolladores

Ejemplo: PeopleSphere con Microsoft Graph

  • PeopleSphere usa:

    • Outlook para solicitudes de ausencia
    • Teams para reuniones de RR. HH.
    • OneDrive para nóminas

  • Graph los conecta todos

Cómo PeopleSphere usa Microsoft Graph

Implementar la seguridad de Azure para desarrolladores

Anatomía de una llamada a la Graph API

API unificada: Un endpoint para acceder a recursos de servicios de Microsoft Cloud Solicitud de Microsoft Graph API

Implementar la seguridad de Azure para desarrolladores

Desglosando la solicitud

  • Componentes de la solicitud:

    • Método: GET, POST, PATCH, etc.

    • Versión: v1.0, beta

    • Recurso: users, groups, etc.

    • Parámetros de consulta: $select, $filter

    • Cabeceras: Authorization, Content-Type

Solicitud de Microsoft Graph API

Implementar la seguridad de Azure para desarrolladores

Métodos

  • Métodos compatibles:

    • GET: Obtener datos

    • POST: Crear datos nuevos

    • PUT: Reemplazar datos por completo

    • PATCH: Actualizar datos existentes

    • DELETE: Eliminar datos

Implementar la seguridad de Azure para desarrolladores

Versionado: v1.0

  • https://graph.microsoft.com/v1.0/groups

  • APIs estables

  • Generalmente disponibles
  • Para apps en producción

Versionado - v1.0

Implementar la seguridad de Azure para desarrolladores

Versionado: beta

beta

  • https://graph.microsoft.com/beta/groups
  • Funciones en vista previa, experimentales
  • Inestable, puede romper
  • Solo pruebas, no producción

`

Versionado - Beta

Implementar la seguridad de Azure para desarrolladores

Recurso

  • Los datos concretos con los que interactúas.

  • Ejemplo:

    • Users: Acceder a información de usuarios
      • /users, /me
    • Groups: Trabajar con grupos
      • /groups
    • Events: Obtener eventos de calendario
      • /users/{userId}/events

Usuarios

Grupos

Eventos

Implementar la seguridad de Azure para desarrolladores

Parámetros de consulta

  • Opciones para filtrar, ordenar o seleccionar datos concretos

  • Select:

    • Elegir campos específicos
    • $select=id,displayName

  • Filter:

    • Filtrar datos
    • $filter=startswith(displayName, 'John')

  • Top:

    • Limitar el número de resultados
    • $top=5

Parámetros de consulta - Select

  Parámetros de consulta - Filter

  Parámetros de consulta - Top

Implementar la seguridad de Azure para desarrolladores

Cabeceras

Transportan metadatos en solicitudes y respuestas HTTP

Dos tipos de cabeceras: estándar y específicas de la API

Cabeceras

  • Estándar: Comunes a todas las solicitudes
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • Específicas de la API: Varían según la API
    • Retry-After: 30
    • Location: https://graph.microsoft.com/operationStatus
Implementar la seguridad de Azure para desarrolladores

¡Vamos a practicar!

Implementar la seguridad de Azure para desarrolladores

Preparing Video For Download...