Table of contents
TOC
Collapse the table of content
Expand the table of content
Última actualización: 25/07/2018

Autentica las API de Office 365 y Outlook.com usando la vista previa del punto de conexión de autenticación v2.0

Se aplica a: Office 365 | Outlook.com

Vista previa de la documentación
Hay características y funciones del punto de conexión de autenticación v2.0 que todavía no son compatibles en el periodo de vista previa pública. Debes tenerlos en cuenta si estás creando aplicaciones durante la vista previa pública. Para más información, ver Limitaciones y restricciones de la vista previa del modelo de app V2.0.

Inicio de sesión en la cuenta de Microsoft y Azure AD para usuarios con un único modelo de autenticación

La vista previa del extremo de autenticación v2.0 permite crear aplicaciones que aceptan identidades profesionales o educativas (Azure AD) y personales (cuenta Microsoft).

Antes, un desarrollador de apps que quisiese que fuesen compatibles con las cuentas Microsoft y con Azure Active Directory tenía que integrarlas con dos sistemas completamente separados. Ahora puedes compilar apps usando el punto de conexión de autenticación v2.0, que permite que los usuarios inicien sesión con ambos tipos de cuentas. Un sencillo proceso permite llegar de inmediato a una audiencia que abarca a millones de usuarios con cuentas personales y laborales/educativas.

Actualmente las apps pueden acceder a las siguientes API usando la vista previa del punto de conexión de autenticación v2.0:

  • Correo de Outlook
  • Contactos de Outlook
  • Calendarios de Outlook

con más servicios de Microsoft que se añadirán en un futuro próximo.

Ejemplos de código

Explora el siguiente ejemplo de código para aprender a crear apps que usen la vista previa del punto de conexión de autenticación v2.0 para acceder a las API de Office.

Ámbitos de autenticación para las API de Office

La siguiente tabla muestra los ámbitos de autenticación que se deben usar con la vista previa del punto de conexión de autenticación v2. Para más información sobre el uso de los ámbitos con el punto de conexión v2.0 y sobre cómo se diferencia del uso de recursos en Azure AD, ver Ámbitos, no recursos.

Ámbitos del correo, el calendario y los contactos de Outlook

ÁmbitoPermisoDescripción
https://outlook.office.com/mail.readLeer el correo del usuarioPermite que esta aplicación lea mensajes en los buzones de los usuarios.
https://outlook.office.com/mail.readwriteAcceso de lectura y escritura en el correo del usuarioPermite a la aplicación leer, actualizar, crear y eliminar mensajes en los buzones de los usuarios.
https://outlook.office.com/mail.sendEnviar correo como usuarioPermite a la aplicación enviar mensajes como usuarios de la organización.
https://outlook.office.com/contacts.readLeer los contactos del usuarioPermite a la aplicación leer los contactos del usuario.
https://outlook.office.com/contacts.readwriteObtener acceso total a los contactos del usuarioPermite a la aplicación crear, leer, actualizar y eliminar los contactos del usuario.
https://outlook.office.com/calendars.readLeer los calendarios del usuarioPermite que la aplicación lea los eventos de los calendarios del usuario.
https://outlook.office.com/calendars.readwriteObtener acceso completo a los calendarios del usuarioPermite a la aplicación leer, actualizar, crear y eliminar eventos de los calendarios del usuario.

APIs de Outlook

  • Estas API funcionan para todos los usuarios de Office 365. Estamos habilitando gradualmente estas API para los usuarios de Outlook.com. Cuando una app hace una solicitud dirigida a un buzón de Outlook.com que todavía no está habilitado para las API de REST, devolvemos el mensaje de error especial "UsuarioNoAdmitido" con estatus Http 404. Tu app debe manejar este caso con soltura.

  • Para un rendimiento óptimo, recomendamos añadir el encabezado x-AnchorMailbox para cada solicitud y configurarlo en la dirección de correo del buzón de destino.

  • Actualmente, debes hacer las solicitudes de API REST directamente al punto de conexión. Los SDK de Office 365 continúan usando el punto de conexión de Azure AD.

  • Consulta el siguiente ejemplo de código para usar la vista previa del modelo de la app v2.0 con las API de Outlook:

Siguientes pasos

Registrar una aplicación para usar con el extremo de autenticación v2.0

Más información

Limitaciones y restricciones de la vista previa del punto de conexión v2.0

Novedades sobre la vista previa del punto de conexión v2.0

Más documentación de la vista previa del punto de conexión de autenticación v2.0 en azure.microsoft.com

© 2018 Microsoft