Introducción al Kit de herramientas de Microsoft Graph

El Kit de herramientas de Microsoft Graph es una colección de componentes y proveedores de autenticación independientes y reutilizables que sirven para acceder y trabajar con Microsoft Graph. Los componentes son totalmente funcionales desde el principio, con proveedores integrados que se autentican y capturan datos con el uso de Microsoft Graph.

El Kit de herramientas de Microsoft Graph facilita el uso de Microsoft Graph en su aplicación. En el ejemplo siguiente, un usuario que ha iniciado sesión y sus eventos de calendario se muestran con solo dos líneas de código mediante los componentes Login y Agenda .

Abra este ejemplo en mgt.dev.

¿Qué hay en Microsoft Graph Toolkit?

Componentes

Microsoft Graph Toolkit incluye una colección de componentes web para las experiencias más comunes creadas con tecnología de las API de Microsoft Graph.

Los componentes también están disponibles como componentes React.

Componente Descripción
Inicio de sesión Un botón y un control flotante para autenticar a un usuario con la plataforma Microsoft Identity y mostrar la información de perfil del usuario cuando inicia sesión.
Persona Muestra una persona o contacto por su foto, nombre o dirección de correo electrónico.
Personas Muestra un grupo de personas o contactos por sus fotos o iniciales.
Agenda Muestra eventos en el calendario de un usuario o grupo.
Selector de personas Proporciona la capacidad de buscar personas y representa la lista de resultados.
Tarjeta para personas Control flotante que se usa en el componente de persona para mostrar más información de perfil sobre un usuario.
Archivo Representa un archivo o carpeta con un icono, un nombre de archivo, un autor y mucho más.
Lista de archivos Muestra una lista de varios archivos o carpetas.
Get Permite realizar una consulta GET a cualquier Graph API de Microsoft directamente en el HTML.
Selector de canales Proporciona la capacidad de buscar canales de Microsoft Teams para seleccionar un canal de una lista representada de resultados.
To Do Muestra y permite agregar, quitar, completar o editar tareas de Microsoft To Do.
Tasks Muestra y permite agregar, quitar, completar o editar tareas de Microsoft Planner o Microsoft To Do.

Proveedores

Los proveedores habilitan la autenticación, proporcionan la implementación para adquirir tokens de acceso en varias plataformas y exponen un cliente de Microsoft Graph para llamar a las API de Microsoft Graph. Los componentes funcionan mejor cuando se usan con un proveedor, pero los proveedores se pueden usar por sí mismos.

Proveedores Descripción
MSAL Usa msal.js para iniciar sesión de usuarios y adquirir tokens para usarlos con Microsoft Graph.
MSAL2 Usa msal-browser para iniciar sesión de usuarios y adquirir tokens para usarlos con Microsoft Graph.
Electrón Autentica y proporciona acceso de Microsoft Graph a los componentes dentro de las aplicaciones de Electron.
SharePoint Autentica y proporciona acceso de Microsoft Graph a los componentes dentro de elementos web de SharePoint.
Teams Usa msal.js para iniciar sesión de usuarios y adquirir tokens en el cliente en las pestañas de Microsoft Teams.
Teams MSAL2 Usa msal-browser para iniciar sesión de usuarios y adquirir tokens en las pestañas de Microsoft Teams. Admite el inicio de sesión único (SSO) con un back-end personalizado.
Proxy Permite el uso de la autenticación de back-end enrutando todas las llamadas a Microsoft Graph a través del back-end.
Personalizados Crea un proveedor personalizado para habilitar la autenticación y el acceso a Microsoft Graph mediante el código de autenticación existente de la aplicación.

¿Por qué usar Microsoft Graph Toolkit?

Microsoft Graph Toolkit le permite integrar rápida y fácilmente experiencias comunes con tecnología de Microsoft Graph en su propia aplicación. El kit de herramientas:

  • Reduce el tiempo de desarrollo. El trabajo para conectarse a las API de Microsoft Graph y representar los datos en una interfaz de usuario que se ve y se siente como una experiencia de Microsoft 365 se realiza por usted, sin que sea necesario personalizarlos.

  • Funciona en todas partes. Todos los componentes se basan en estándares web y funcionan sin problemas con cualquier marco web y explorador moderno (como React, Angular o Vue).

  • Es hermoso pero flexible. Los componentes están diseñados para parecerse a las experiencias de Microsoft 365, pero también se pueden personalizar mediante el uso de propiedades personalizadas css y plantillas.

¿Quién debe usarlo?

Microsoft Graph Toolkit es ideal para desarrolladores de todos los niveles de experiencia que desean desarrollar una aplicación que se conecte a los datos de Microsoft Graph y acceda a ellos, como:

  • Aplicación web
  • Pestaña Microsoft Teams
  • Aplicación web progresiva (PWA)
  • Aplicación electron
  • Elemento web de SharePoint

¿Dónde puedo usarlo?

Microsoft Graph Toolkit se admite en los siguientes exploradores:

Microsoft Edge Firefox Chrome Safari Opera Samsung Internet
Microsoft Edge Firefox Chrome Safari Opera Samsung

Siguientes pasos