Guía de migración: servicios web de Exchange (EWS) a la API de Microsoft Graph

Información general

Microsoft está dejando obsoleta la API de servicios web de Exchange (EWS), con la desactivación completa programada para octubre de 2026.

Debes migrar todas las integraciones de Exchange que actualmente utilizan EWS a la API de Microsoft Graph para asegurarte de que siguen funcionando.

Requisitos previos

Antes de iniciar la migración, asegúrate de cumplir los siguientes requisitos:

• Acceso al portal de Azure: acceso administrativo al portal de Azure de tu organización.
• Permisos: la capacidad de registrar aplicaciones y otorgar consentimiento de administrador en Azure AD.
• Acceso a la integración: acceso administrativo a tus integraciones de Communications Mining.
• Información del buzón: lista de todos los buzones conectados actualmente a través de integraciones de EWS.

Proceso de migración

Paso 1: Identifica tus integraciones de EWS actuales

1. Inicia sesión en Communications Mining a través de Extracción y Procesamiento Inteligentes (IXP) en Automation Cloud.
2. Ve a Configuración y luego a la pestaña Integraciones .
3. Documenta todas las integraciones de Exchange existentes, incluyendo:
   • Nombres de integración
   • Buzones conectados
   • Proyectos asociados

Paso 2: registrar una aplicación de Azure

Si aún no has creado una aplicación de Azure para acceder a Graph API, aplica los siguientes pasos:

2.1 Crear el registro de la aplicación

1. Inicia sesión en tu portal de Azure.

2. Ve a Registros de aplicaciones y selecciona Nuevo registro.

   

3. Configura la aplicación de la siguiente manera:

   • Nombre: utiliza un nombre descriptivo, por ejemplo, uipath-exchange-graph-integration.
   • Tipos de cuenta admitidos: selecciona Cuentas solo en este directorio organizativo (Tenant único).

4. Selecciona Registrar.

5. Anota los siguientes valores de la página de información general de la aplicación:

   • ID de la aplicación (cliente)
   • ID (de tenant) del Directorio

2.2 Crear un secreto de cliente

1. En tu aplicación, selecciona Certificados y secretos en el menú de la izquierda.

2. En Secretos de cliente, selecciona Nuevo secreto de cliente.

   

3. Esto abre el panel lateral Añadir un secreto de cliente . Configura el secreto:

   • Descripción: introduce una descripción significativa, por ejemplo, Exchange Graph Integration Secret.
   • Caduca: selecciona un período de vencimiento. La opción recomendada es 12 o 24 meses.

4. Selecciona Añadir.

5. Copia inmediatamente el valor secreto y guárdalo de forma segura.

   

Nota:

Azure muestra el valor del secreto solo una vez. Si lo pierde, debe crear un nuevo secreto.

2.3 Establecer permisos de API para Microsoft Graph

1. Selecciona Permisos de API en el menú de la izquierda.

2. Selecciona Añadir un permiso.

   

3. Selecciona Microsoft Graph en la pestaña API de Microsoft .

   

4. Selecciona Permisos de aplicación.

   

5. Expande Correo y selecciona Mail.Read.

   

6. Selecciona Añadir permisos.

7. Selecciona Añadir un permiso de nuevo y luego selecciona Microsoft Graph → Permisos de aplicación.

8. Expande MailboxSettings y selecciona MailboxFolder.Read.All.

11. Selecciona Añadir permisos.

12. Volviendo al menú de permisos de la API , selecciona Conceder consentimiento de administrador para [Your Organization].

13. Selecciona Sí en el cuadro de diálogo de confirmación.

    

Tus permisos configurados deben mostrar:

• Mail.Read (Aplicación): marca de verificación verde en Estado.
• MailboxFolder.Read.All (Aplicación): marca de verificación verde en Estado.

2.4 Restringir el acceso al buzón (recomendado)

Para mejorar la seguridad, limita la aplicación para acceder solo a los buzones necesarios. Asegúrate de seguir la guía de Microsoft: Limitar los permisos de la aplicación a buzones de correo específicos de Exchange Online.

Paso 3: prueba tus credenciales de Graph API (recomendado)

Antes de actualizar tus integraciones de producción, prueba primero las nuevas credenciales de Graph API en una integración de prueba independiente.

1. Ve a Communications Mining en Extracción y Procesamiento Inteligentes (IXP) en Automation Cloud.
2. Dirígete a la pestaña Configuración → Integraciones .
3. Selecciona Nueva integración.
4. Configura la integración de prueba:
   • Selecciona un proyecto de prueba.
   • Introduce un nombre de prueba claro, por ejemplo, Exchange Graph Test o [Production Name] - Test.
5. Rellena las credenciales del paso 2:
   • Autoridad OAuth: https://login.microsoftonline.com/{tenant_id}
   • ID de cliente OAuth: tu ID de aplicación (cliente).
   • Secreto de cliente: tu valor de secreto de cliente.
   • Método de autenticación: selecciona Con acceso a la aplicación.
   • Versión de la API: selecciona Microsoft Graph.
6. Selecciona Validar y guardar credenciales.
7. Añade los buzones utilizados en tu integración de producción. Utilice una marca de tiempo de inicio reciente para limitar la cantidad de datos sincronizados inicialmente.
8. Selecciona Crear integración.
9. Espera entre 15 y 30 minutos para que se complete la primera sincronización y, a continuación, comprueba que los correos electrónicos se sincronizan correctamente y que no aparecen mensajes de error en la página de estado de la integración.

Una vez confirmado, procede a actualizar tus integraciones de producción.

Paso 4: Haz una copia de seguridad de tu configuración actual de EWS

Antes de modificar tu integración de producción, registra tus credenciales de EWS actuales y los detalles de conexión. Esto le permite revertir si es necesario, ya que los cambios de credenciales no se pueden deshacer dentro de la plataforma.

Paso 5: actualiza tu integración de producción

Información:

Si necesitas revertir, edita la integración y cambia las credenciales a tus detalles de EWS.

1. Ve a Communications Mining en Extracción y Procesamiento Inteligentes (IXP) en Automation Cloud.

2. Ve a Configuración y luego a la pestaña Integraciones .

3. Localiza la integración de producción que deseas migrar y abre su configuración.

4. Selecciona la pestaña Credenciales y luego selecciona Cambiar credenciales.

5. Actualiza los siguientes campos:

   • Autoridad OAuth: https://login.microsoftonline.com/{tenant_id} : sustituye {tenant_id} por tu ID de Azure Directory (tenant).
   • ID de cliente OAuth: tu ID de aplicación (cliente).
   • Secreto de cliente: tu valor de secreto de cliente.
   • Método de autenticación: selecciona Con acceso a la aplicación.
   • Versión de la API: selecciona Microsoft Graph.

6. Selecciona Validar y guardar credenciales para verificar tu configuración.

   Nota:

   Si la validación falla, vuelve a comprobar tu ID de tenant, ID de cliente y secreto de cliente. Asegúrese de que se haya concedido el consentimiento del administrador para los permisos de la API.

7. Selecciona Guardar o Continuar para aplicar la configuración actualizada.

8. Supervise la integración durante al menos una hora para confirmar un funcionamiento estable y una sincronización de correo electrónico correcta.

Paso 6: Actualizar las integraciones restantes

Repite los pasos 3 a 5 para cada integración de EWS restante en tu organización.