El 5 de noviembre Microsoft publicó el aviso MC1540345: los permisos de la Exchange Online Admin API v2.0 cambian de nombre y hay que completar la migración antes del 30 de noviembre. Hoy es 16: quedan catorce días, diez de ellos laborables sin contar el de hoy. Eso es lo que cuenta el aviso. Lo que no cuenta es lo otro: esa API es la pieza a la que Microsoft manda los escenarios de administración que todavía van por EWS, sigue etiquetada como Preview y su propio manual oficial —fechado el 25 de septiembre y sin tocar desde entonces— te sigue diciendo que concedas exactamente el permiso que queda obsoleto el 1 de diciembre.
El cambio en sí es pequeño y se explica en dos líneas. Exchange.ManageV2, el permiso delegado, pasa a llamarse Exchange.AdminAPI.Manage. Exchange.ManageAsAppV2, el de aplicación (sin usuario), pasa a Exchange.AdminAPI.ManageAsApp. Los nuevos están disponibles desde el 1 de noviembre en el entorno mundial; los viejos quedan obsoletos el 1 de diciembre, y en GCC, GCC High y DoD el 1 de enero de 2027. La API no se retira, ni cambian sus extremos ni su versión: lo único que cambia es con qué permiso se pide el token.
Conviene ser exacto con lo que pasa el 1 de diciembre, porque el aviso no lo deja en el aire. Dice, literal: «Applications relying exclusively on the retired permissions after the applicable deprecation date will no longer be able to access the APIs». Permisos retirados, y la consecuencia escrita: la aplicación que llegue a esa fecha con el permiso viejo y nada más deja de entrar. La fecha está publicada y es la que es, así que no hay margen para esperar a ver qué pasa. Lo que sí hay es una manera de hacerlo sin riesgo, porque la parte que puedes hacer hoy no cuesta nada y no rompe nada. Luego llegamos a por qué.
Lo primero no es tocar nada: es mirar qué permiso tienen tus aplicaciones
El aviso nombra solo los dos permisos acabados en V2. No nombra Exchange.ManageAsApp —sin el V2—, que es el que lleva años usando la autenticación solo-aplicación de Exchange Online PowerShell con certificado. Si tu automatización es un Connect-ExchangeOnline desatendido con huella de certificado, lo más probable es que este aviso no vaya contigo. Decirlo nos quita trabajo, pero es lo que hay: buena parte de los nervios de estas dos semanas van a ser de gente que no está afectada.
Y aquí está el detalle que convierte «comprobarlo» en obligatorio en vez de opcional. El manual oficial de la API te lleva, paso a paso y con capturas, a marcar Exchange.ManageAsAppV2 en el registro de aplicación. En el paso siguiente, el de verificar que la concesión ha quedado bien, el mismo documento te dice que deberías ver listado Exchange.ManageAsApp, sin el V2. Son dos permisos distintos y solo uno de los dos está en el aviso del 5 de noviembre. No es una interpretación nuestra: está escrito así en la página de autenticación y autorización de la Admin API, consultada el 16 de noviembre de 2026, cuya propia fecha interna sigue siendo el 25 de septiembre.
Una sola pasada de lectura que resuelve dos migraciones
Los permisos de EWS y los de la Admin API cuelgan de la misma aplicación de recurso en Microsoft Entra: «Office 365 Exchange Online», identificador 00000002-0000-0ff1-ce00-000000000000. Eso significa que una única consulta de solo lectura sobre ese objeto te contesta las dos preguntas que tienes encima de la mesa: quién tiene que cambiar de permiso antes del 30 de noviembre, y quién tiene que salir de EWS antes de que lo apaguen del todo. Esto no lo hemos inventado: el mismo identificador es el que Microsoft indica para localizar aplicaciones que usan EWS.
1. Permisos de aplicación (sin usuario): quién tiene qué concedido
Connect-MgGraph -Scopes "Application.Read.All","Directory.Read.All"
$exo = Get-MgServicePrincipal -Filter "appId eq '00000002-0000-0ff1-ce00-000000000000'" `
-Property "id,appId,displayName,appRoles" | Select-Object -First 1
$roles = @{}
$exo.AppRoles |
Where-Object { $_.Value -like 'Exchange.Manage*' -or
$_.Value -like 'Exchange.AdminAPI*' -or
$_.Value -eq 'full_access_as_app' } |
ForEach-Object { $roles[$_.Id] = $_.Value }
Get-MgServicePrincipalAppRoleAssignedTo -ServicePrincipalId $exo.Id -All |
Where-Object { $roles.ContainsKey($_.AppRoleId) } |
Select-Object PrincipalDisplayName,
@{n='Permiso';e={ $roles[$_.AppRoleId] }},
CreatedDateTime |
Sort-Object Permiso, PrincipalDisplayName
2. Permisos delegados: qué se ha consentido en nombre de usuarios
Get-MgOauth2PermissionGrant -All -Filter "resourceId eq '$($exo.Id)'" |
Where-Object { $_.Scope -match 'Exchange\.Manage|Exchange\.AdminAPI|EWS\.AccessAsUser' } |
Select-Object ClientId, ConsentType, PrincipalId, Scope
Las dos consultas son de lectura: no conceden, no revocan y no consienten nada. Hacen falta las dos, porque la primera cubre los permisos de aplicación y la segunda los delegados; si ambas salen vacías, el aviso MC1540345 no va contigo y puedes cerrar esta pestaña con la conciencia tranquila. Un apunte honesto sobre la primera: los permisos nuevos solo aparecerán en el catálogo del inquilino si ya han llegado a tu entorno; están disponibles en el entorno mundial desde el 1 de noviembre, pero si no los ves aún, eso es despliegue, no error tuyo.
| Si el inventario devuelve… | Qué significa | Fecha |
|---|---|---|
Exchange.ManageAsAppV2 |
Automatización desatendida contra la Admin API. Hay que añadir Exchange.AdminAPI.ManageAsApp. |
30 nov 2026 |
Exchange.ManageV2 |
Aplicación que actúa en nombre de un administrador. Hay que añadir Exchange.AdminAPI.Manage. |
30 nov 2026 |
full_access_as_app |
EWS solo-aplicación: acceso a todos los buzones. Otra migración, otro plazo y mucho más trabajo. | 1 abr 2027 |
EWS.AccessAsUser.All |
EWS delegado. Mismo destino: fuera antes de que se apague. | 1 abr 2027 |
Exchange.ManageAsApp |
PowerShell solo-aplicación con certificado. No está en el aviso del 5 de noviembre. | — |
De la fila de EWS ya escribimos hace unos días, desde otro ángulo: cuando la retirada empezó a morder, lo que se quedó a oscuras fue lo que tu copia de Microsoft 365 había dejado de ver. Aquí la lectura es la contraria y más incómoda: no solo hay cosas que dejan de funcionar, es que el sitio al que las mandas todavía se está construyendo.
El orden juega a tu favor: esto es aditivo, no un día D
La palabra «plazo» sugiere una noche de corte con todo el mundo despierto, y aquí no la hay. El token de la Admin API se pide con el ámbito https://outlook.office365.com/.default, y la documentación, al describir el flujo solo-aplicación, explica qué hace ese sufijo: «This value informs the Microsoft identity platform endpoint to include all app-level permissions the admin consented to in the access token». Todos los permisos consentidos para ese recurso. Es decir: una aplicación que tenga el viejo y el nuevo a la vez recibe los dos en el mismo token.
Por eso el orden correcto es el aburrido: añadir el permiso nuevo, consentirlo, probar que la integración sigue funcionando y solo entonces quitar el viejo. En ningún momento la aplicación se queda sin permiso válido, y si algo sale mal el viejo sigue ahí hasta el 1 de diciembre. Lo que no se puede hacer es lo contrario —quitar primero— ni dejarlo para el 30 por la tarde, porque el consentimiento de administrador en una empresa seria pasa por un comité o, como mínimo, por alguien que tiene que aprobarlo y hoy está de vacaciones.
Y si después de añadir el permiso la integración sigue rota, el código de error te dice dónde mirar sin perder la tarde. 401 es problema de token: falta, ha caducado o no lleva el ámbito correcto. 403 es otra cosa completamente distinta, y la documentación lo dice sin rodeos: «Without the appropriate RBAC role assignments, even valid tokens fail with the error: 403 Forbidden». Un token perfecto y un rol de Exchange que falta. En el flujo delegado el rol lo necesita el usuario; en el solo-aplicación, el service principal de la aplicación. Los extremos /OrganizationConfig y /AcceptedDomain piden «View-Only Organization Management»; /Mailbox, /MailboxFolderPermission y los de miembros de grupos de distribución piden «Recipient Management». Añadir un permiso de Entra no te da ninguno de esos roles.
La parte incómoda: el destino de tu salida de EWS se está moviendo
Pon las dos cosas una al lado de la otra. El anuncio de retirada de EWS, publicado en febrero y actualizado el 27 de octubre, dio el calendario: desactivación por fases desde el 1 de octubre de 2026, una ventana en la que el administrador todavía puede reactivarlo hasta el 31 de marzo de 2027 y apagado definitivo el 1 de abril de 2027. Desde hoy son 135 días —la cuenta es nuestra—. Ese anuncio recomienda una sola cosa, Microsoft Graph, y afirma que «Microsoft Graph has reached near-complete feature parity for the vast majority of EWS scenarios». No menciona la Admin API ni una vez.
La documentación de la Admin API, en cambio, se presenta a sí misma así: «The Exchange Online Admin API provides a REST-based way to execute specific PowerShell cmdlets, replacing legacy Exchange Web Services (EWS) scenarios». Las dos frases son de Microsoft y las dos son ciertas, porque hablan de mitades distintas del problema. Lo que va a Graph es el acceso a datos de buzón: leer correo, calendarios, contactos. Lo que va a la Admin API es lo que tiene forma de cmdlet y no de dato: Get-Mailbox, permisos de carpeta, miembros de grupos, configuración de la organización. Tu salida de EWS no tiene un destino. Tiene dos.
Y las dos mitades no están igual de firmes. La de Graph lleva años y el propio fabricante le pone la etiqueta de paridad casi completa. La otra arrastra, en su manual, este aviso en cabecera: «The features described in this article are currently in Preview, aren't available in all organizations, and are subject to change». Preview, no disponible en todas las organizaciones y sujeto a cambios. Entre la fecha de su documentación pública —25 de septiembre— y hoy no han pasado dos meses, y en ese plazo ya ha cambiado su modelo de permisos con una ventana de treinta días. No es una crítica gratuita: es exactamente lo que dice la etiqueta, y es información que cambia cómo planificas.
Nuestra lectura: esto no es motivo para parar, es motivo para secuenciar. Lo que se pueda llevar a Graph, llévalo ya; ahí el suelo no se mueve y el plazo del 1 de abril es real. Lo que dependa de la Admin API, haz hoy la parte que es gratis —el permiso nuevo, añadido y probado— y no comprometas fecha para reescribir el resto mientras siga puesta la etiqueta de Preview. Comprometer una fecha de migración contra una interfaz que avisa de que puede cambiar es el tipo de decisión que luego se paga en horas extra de otra persona.
Cuándo esto no va contigo
Si las dos consultas de arriba devuelven cero filas, ya está: cierra el aviso. Si lo único que sale es Exchange.ManageAsApp sin V2, tampoco. Y si la aplicación que aparece no es tuya sino de un proveedor —una herramienta de copias, de informes, de migración de buzones—, el permiso lo declara el registro de aplicación de ese fabricante y a ti lo que te tocará es volver a dar consentimiento cuando lo publiquen. Lo útil ahí no es tocar Entra: es escribirle hoy una línea preguntando si ya han migrado y guardarte la respuesta. Nosotros lo hacemos con los nuestros, y no por desconfianza: por tener la fecha de alguien que no somos nosotros antes de que nos haga falta.
Lo que no es opcional para nadie es la pregunta de debajo, que no va de permisos. Una aplicación registrada en tu inquilino con un permiso de alcance organizativo es un sistema de producción: se autentica sola, de madrugada, contra tus buzones, y cuando deja de funcionar nadie lo nota hasta que falta un informe o una copia. Nosotros tratamos así nuestra automatización interna —el n8n autoalojado que publica y mueve tareas— exactamente igual que un servidor: inventariado, con dueño y con ventana de actualización. Los registros de aplicación que nos encontramos cuando entramos en un inquilino ajeno rara vez tienen las tres. Del precio de esa cuenta sin dueño ya escribimos cuando entraron como una aplicación y Entra ID no pidió MFA: la identidad de una aplicación no se cansa, no se olvida la contraseña y no pasa por el segundo factor.
Así que el plazo del 30 de noviembre, visto de cerca, es una excusa barata para hacer un trabajo que había que hacer igual: poner nombre y dueño a cada identidad no humana que entra en tu correo. Si el inventario sale vacío, has perdido diez minutos. Si sale lleno, acabas de descubrir cuántas cosas de tu empresa dependen de un permiso que nadie recuerda haber concedido. Para la parte de gobierno del inquilino —identidades, consentimientos, políticas— esa conversación es Microsoft 365 gestionado; para la de «esto quién lo mira y cuándo», que es la que de verdad falla, es mantenimiento informático. Si quieres que pasemos el inventario contigo y te digamos sin adornos si te afecta o no, escríbenos.
Fuentes (verificadas el 16 de noviembre de 2026): el aviso MC1540345 «Action required: Update permissions for Exchange Online Admin API», publicado el 5 de noviembre de 2026, con los dos reemplazos de permiso, la disponibilidad desde el 1 de noviembre, el plazo del 30 y la obsolescencia del 1 de diciembre (1 de enero de 2027 en GCC, GCC High y DoD), en el espejo público del Centro de mensajes. Que la API no se retira y que solo cambian los permisos, y la frase sobre fallos de autenticación, en Petri (9 de noviembre de 2026). Los nombres de permiso que manda conceder el manual, la incoherencia entre el paso de selección y el de verificación, el aviso de Preview, el ámbito /.default y lo que incluye en el token, la distinción entre 401 y 403 y la tabla de extremos contra grupos de rol, en las páginas de autenticación y autorización y primeros pasos de la Admin API, ambas con fecha interna de 25 de septiembre de 2026. El calendario de EWS (fases desde el 1 de octubre de 2026, ventana administrable hasta el 31 de marzo de 2027, apagado el 1 de abril de 2027) y la cita sobre la paridad de Graph, en el anuncio de retirada de EWS. El identificador de «Office 365 Exchange Online» y los nombres de permiso de EWS, en la guía de Microsoft para identificar aplicaciones que usan EWS. Son cuenta nuestra los catorce días naturales y diez laborables (sin contar hoy) hasta el 30 de noviembre y los 135 días hasta el 1 de abril de 2027. Las dos consultas de PowerShell son nuestras, de solo lectura, y están escritas para el módulo Microsoft.Graph.
¿Quién es el dueño de la aplicación que entra en tu correo?
Si la respuesta tarda más de un minuto, el problema no es el permiso que caduca el 30 de noviembre. Pasamos el inventario de identidades de tu inquilino contigo y te decimos sin adornos qué te afecta y qué no.
Hablar con everyWAN