Migración de botones de REST API a Graph API

Información general sobre la migración

Como se anunció en noviembre de 2021, la REST API será completamente retirada por Microsoft en noviembre de 2022 a nivel global para todos los clientes que utilicen Microsoft Exchange Online.

Esto significa que realizaremos la transición a Graph API, y pedimos a todos los clientes que utilizan Microsoft Exchange Online (Cloud, MS356) que cambien de REST API a Graph API si es posible, con el fin de continuar ofreciendo las mismas funcionalidades del Phishing Report Button.

De parte de Microsoft: https://docs.microsoft.com/en-us/previous-versions/office/office-365-api/api/version-2.0/use-outlook-rest-api

¿Qué es Graph API?

Graph API es una API RESTful desarrollada por Microsoft y constituye la nueva forma de comunicarse con los servicios de Microsoft 365. Funciona de la misma manera que REST API, pero añade una capa adicional de autenticación y autorización.

¿Qué significa esto?

• Esto significa que todo lo que una aplicación puede hacer depende de la interacción del usuario con dicha aplicación. Esto otorga un mayor control al usuario, al administrador y a la empresa.

• No obstante, tenga en cuenta que Graph API es exclusiva para usuarios de MS365, y los usuarios que no sean de MS365 no pueden utilizar Graph API.

De parte de Microsoft: https://docs.microsoft.com/en-us/graph/overview

¿Quién necesita migrar a Graph API?

Exchange online (MS365)

Para todos los clientes que utilicen las soluciones en la nube de Exchange Online en combinación con una suscripción a Microsoft 365, se recomienda encarecidamente cambiar a Graph API antes de noviembre de 2022. El Phishing Report Button ya no podrá procesar información de correos electrónicos con la REST API. Como alternativa, y según su configuración, los clientes pueden recurrir a EWS API en caso necesario. Sin embargo, esto no es recomendable, ya que limitará las funcionalidades del Phishing Report Button. Consulte nuestra matriz de compatibilidad de API de cliente y servidor de Outlook actualizada para asegurarse de elegir la API adecuada según su configuración.

Exchange On-Premises hybrid deployments

Los clientes que utilicen una configuración híbrida (Microsoft 365 + Exchange On-Premises) podrán usar REST API hasta junio de 2023. A partir de entonces, Microsoft bloqueará todas las solicitudes de REST API, y le pedimos que contacte con Microsoft para conocer los pasos a seguir en la migración.

Consulte aquí nuestra compatibilidad de API de cliente y servidor de Outlook actualizada: Compatibilidad de API de cliente y servidor de Outlook del Phishing Report Button

De parte de Microsoft: Using the Outlook REST API (version 2.0):https://docs.microsoft.com/en-us/graph/hybrid-rest-support

Recomendado: Recomendamos encarecidamente a los clientes que contacten con el soporte de Microsoft para proceder correctamente con la migración según su configuración.

¿Cómo migrar el Phishing Report Button a Graph API?

Pasos para la migración:

1. Descargue el nuevo archivo de manifiesto de Graph desde la configuración del Phishing Report Button en Manager.

   • Phishing Report Button / Microsoft Integrations / Phishing Report Button manifest

   • Seleccione el entorno que utiliza.

   • Haga clic en Download manifest file para descargar el archivo.

2. Actualice el Phishing Report Button con el archivo de manifiesto de Graph.

3. Durante la instalación, será necesario conceder permisos para los ámbitos solicitados por la aplicación Phishing Report Button. Se recomienda conceder los permisos para todos los usuarios de antemano; de lo contrario, cada usuario deberá conceder su permiso por separado tras la actualización, introduciendo sus credenciales.

4. Tras la instalación del manifiesto de Graph, se recomienda esperar 24 horas hasta que la actualización se haya implementado para todos los usuarios del tenant.

5. Por último, active Graph API en Manager en la configuración del Phishing Report Button.

   • Phishing Report Button > Email Integrations > Microsoft API

¿Cambiará algo para los usuarios finales?

Nada cambiará para los usuarios finales.

Una vez completada la transición a Graph API, los usuarios no deberían notar ninguna diferencia en el uso del Phishing Report Button, ya que el flujo de usuario y la funcionalidad seguirán siendo los mismos.

¿Será necesario pausar la Phishing Simulation?

Durante el proceso de migración, la Phishing Simulation no necesita pausarse, ya que el cambio a Graph API lleva solo unos minutos.

¿Seguirán siendo compatibles EWS y RestAPI?

Tenga en cuenta que Microsoft limita y/o depreca la funcionalidad de RestAPI y EWS. Debido a estas limitaciones, el Phishing Report Button podría dejar de funcionar correctamente en configuraciones Cloud e híbridas. Por este motivo, el Phishing Report Button ya no es totalmente compatible con EWS y RestAPI.