Tornar al Blog

El substitut d'EWS canvia de permisos el 30 de novembre, i continua en Preview

Oficina diàfana gairebé buida al final del dia, amb una sola persona treballant davant d'un portàtil

El 5 de novembre Microsoft va publicar l'avís MC1540345: els permisos de l'Exchange Online Admin API v2.0 canvien de nom i cal completar la migració abans del 30 de novembre. Avui és 16: queden catorze dies, deu de laborables sense comptar el d'avui. Això és el que diu l'avís. El que no diu és l'altra cosa: aquesta API és la peça on Microsoft envia els escenaris d'administració que encara van per EWS, continua etiquetada com a Preview i el seu manual oficial —datat el 25 de setembre i sense tocar des de llavors— encara et diu que concedeixis exactament el permís que queda obsolet l'1 de desembre.

El canvi en si és petit i s'explica en dues línies. Exchange.ManageV2, el permís delegat, passa a dir-se Exchange.AdminAPI.Manage. Exchange.ManageAsAppV2, el d'aplicació (sense usuari), passa a Exchange.AdminAPI.ManageAsApp. Els nous estan disponibles des de l'1 de novembre a l'entorn mundial; els vells queden obsolets l'1 de desembre, i a GCC, GCC High i DoD l'1 de gener del 2027. L'API no es retira, ni canvien els seus extrems ni la seva versió: l'únic que canvia és amb quin permís es demana el testimoni.

Convé ser exacte amb el que passa l'1 de desembre, perquè l'avís no ho deixa a l'aire. Diu, literal: «Applications relying exclusively on the retired permissions after the applicable deprecation date will no longer be able to access the APIs». Permisos retirats, i la conseqüència escrita: l'aplicació que arribi a aquella data amb el permís vell i res més deixa d'entrar. La data està publicada i és la que és, així que no hi ha marge per esperar a veure què passa. El que sí que hi ha és una manera de fer-ho sense risc, perquè la part que pots fer avui no costa res i no trenca res. Després hi arribem.

El primer no és tocar res: és mirar quin permís tenen les teves aplicacions

L'avís nomena només els dos permisos acabats en V2. No nomena Exchange.ManageAsApp —sense el V2—, que és el que fa anys que fa servir l'autenticació només-aplicació d'Exchange Online PowerShell amb certificat. Si la teva automatització és un Connect-ExchangeOnline desatès amb empremta de certificat, el més probable és que aquest avís no vagi amb tu. Dir-ho ens treu feina, però és el que hi ha: bona part dels nervis d'aquestes dues setmanes seran de gent que no està afectada.

I aquí hi ha el detall que converteix «comprovar-ho» en obligatori en comptes d'opcional. El manual oficial de l'API et porta, pas a pas i amb captures, a marcar Exchange.ManageAsAppV2 al registre d'aplicació. Al pas següent, el de verificar que la concessió ha quedat bé, el mateix document et diu que hauries de veure llistat Exchange.ManageAsApp, sense el V2. Són dos permisos diferents i només un dels dos surt a l'avís del 5 de novembre. No és una interpretació nostra: està escrit així a la pàgina d'autenticació i autorització de l'Admin API, consultada el 16 de novembre del 2026, i la seva data interna continua sent el 25 de setembre.

Una sola passada de lectura que resol dues migracions

Els permisos d'EWS i els de l'Admin API pengen de la mateixa aplicació de recurs al Microsoft Entra: «Office 365 Exchange Online», identificador 00000002-0000-0ff1-ce00-000000000000. Això vol dir que una única consulta de només lectura sobre aquest objecte et contesta les dues preguntes que tens damunt la taula: qui ha de canviar de permís abans del 30 de novembre, i qui ha de sortir d'EWS abans que l'apaguin del tot. Això no ens ho hem inventat: el mateix identificador és el que Microsoft indica per localitzar aplicacions que fan servir EWS.

1. Permisos d'aplicació (sense usuari): qui té què concedit

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 delegats: què s'ha consentit en nom d'usuaris

Get-MgOauth2PermissionGrant -All -Filter "resourceId eq '$($exo.Id)'" |
  Where-Object { $_.Scope -match 'Exchange\.Manage|Exchange\.AdminAPI|EWS\.AccessAsUser' } |
  Select-Object ClientId, ConsentType, PrincipalId, Scope

Les dues consultes són de lectura: no concedeixen, no revoquen i no consenteixen res. Calen totes dues, perquè la primera cobreix els permisos d'aplicació i la segona els delegats; si totes dues surten buides, l'avís MC1540345 no va amb tu i pots tancar aquesta pestanya amb la consciència tranquil·la. Un apunt honest sobre la primera: els permisos nous només apareixeran al catàleg de l'inquilí si ja han arribat al teu entorn; estan disponibles a l'entorn mundial des de l'1 de novembre, però si encara no els veus, això és desplegament, no pas error teu.

Si l'inventari retorna… Què vol dir Data
Exchange.ManageAsAppV2 Automatització desatesa contra l'Admin API. Cal afegir Exchange.AdminAPI.ManageAsApp. 30 nov 2026
Exchange.ManageV2 Aplicació que actua en nom d'un administrador. Cal afegir Exchange.AdminAPI.Manage. 30 nov 2026
full_access_as_app EWS només-aplicació: accés a totes les bústies. Una altra migració, un altre termini i molta més feina. 1 abr 2027
EWS.AccessAsUser.All EWS delegat. Mateix destí: fora abans que s'apagui. 1 abr 2027
Exchange.ManageAsApp PowerShell només-aplicació amb certificat. No surt a l'avís del 5 de novembre. —

De la fila d'EWS ja en vam escriure fa uns dies, des d'un altre angle: quan la retirada va començar a mossegar, el que es va quedar a les fosques va ser allò que la teva còpia de Microsoft 365 havia deixat de veure. Aquí la lectura és la contrària i més incòmoda: no només hi ha coses que deixen de funcionar, és que el lloc on les envies encara s'està construint.

L'ordre juga a favor teu: això és additiu, no pas un dia D

La paraula «termini» suggereix una nit de tall amb tothom despert, i aquí no n'hi ha. El testimoni de l'Admin API es demana amb l'àmbit https://outlook.office365.com/.default, i la documentació, en descriure el flux només-aplicació, explica què fa aquest sufix: «This value informs the Microsoft identity platform endpoint to include all app-level permissions the admin consented to in the access token». Tots els permisos consentits per a aquest recurs. És a dir: una aplicació que tingui el vell i el nou alhora rep tots dos al mateix testimoni.

Per això l'ordre correcte és l'avorrit: afegir el permís nou, consentir-lo, provar que la integració continua funcionant i només llavors treure el vell. En cap moment l'aplicació es queda sense permís vàlid, i si alguna cosa surt malament el vell continua allà fins a l'1 de desembre. El que no es pot fer és el contrari —treure primer— ni deixar-ho per al 30 a la tarda, perquè el consentiment d'administrador en una empresa seriosa passa per un comitè o, com a mínim, per algú que ho ha d'aprovar i avui és de vacances.

I si després d'afegir el permís la integració continua trencada, el codi d'error et diu on mirar sense perdre la tarda. 401 és problema de testimoni: falta, ha caducat o no porta l'àmbit correcte. 403 és una cosa completament diferent, i la documentació ho diu sense embuts: «Without the appropriate RBAC role assignments, even valid tokens fail with the error: 403 Forbidden». Un testimoni perfecte i un rol d'Exchange que falta. Al flux delegat el rol el necessita l'usuari; al només-aplicació, el service principal de l'aplicació. Els extrems /OrganizationConfig i /AcceptedDomain demanen «View-Only Organization Management»; /Mailbox, /MailboxFolderPermission i els de membres de grups de distribució demanen «Recipient Management». Afegir un permís d'Entra no et dóna cap d'aquests rols.

La part incòmoda: el destí de la teva sortida d'EWS s'està movent

Posa les dues coses l'una al costat de l'altra. L'anunci de retirada d'EWS, publicat al febrer i actualitzat el 27 d'octubre, va donar el calendari: desactivació per fases des de l'1 d'octubre del 2026, una finestra en què l'administrador encara pot reactivar-lo fins al 31 de març del 2027 i apagada definitiva l'1 d'abril del 2027. Des d'avui són 135 dies —el compte és nostre—. Aquell anunci recomana una sola cosa, el Microsoft Graph, i afirma que «Microsoft Graph has reached near-complete feature parity for the vast majority of EWS scenarios». No esmenta l'Admin API ni una sola vegada.

La documentació de l'Admin API, en canvi, es presenta a si mateixa així: «The Exchange Online Admin API provides a REST-based way to execute specific PowerShell cmdlets, replacing legacy Exchange Web Services (EWS) scenarios». Les dues frases són de Microsoft i totes dues són certes, perquè parlen de meitats diferents del problema. El que va al Graph és l'accés a dades de bústia: llegir correu, calendaris, contactes. El que va a l'Admin API és el que té forma de cmdlet i no pas de dada: Get-Mailbox, permisos de carpeta, membres de grups, configuració de l'organització. La teva sortida d'EWS no té un destí. En té dos.

I les dues meitats no estan igual de fermes. La del Graph fa anys que hi és i el mateix fabricant li posa l'etiqueta de paritat gairebé completa. L'altra arrossega, al seu manual, aquest avís a la capçalera: «The features described in this article are currently in Preview, aren't available in all organizations, and are subject to change». Preview, no disponible a totes les organitzacions i subjecte a canvis. Entre la data de la seva documentació pública —25 de setembre— i avui no han passat dos mesos, i en aquest termini ja ha canviat el seu model de permisos amb una finestra de trenta dies. No és una crítica gratuïta: és exactament el que diu l'etiqueta, i és informació que canvia com planifiques.

La nostra lectura: això no és motiu per parar, és motiu per seqüenciar. El que es pugui portar al Graph, porta-ho ja; allà el terra no es mou i el termini de l'1 d'abril és real. El que depengui de l'Admin API, fes avui la part que és gratis —el permís nou, afegit i provat— i no comprometis data per reescriure la resta mentre continuï posada l'etiqueta de Preview. Comprometre una data de migració contra una interfície que avisa que pot canviar és el tipus de decisió que després es paga en hores extra d'una altra persona.

Quan això no va amb tu

Si les dues consultes de dalt retornen zero files, ja està: tanca l'avís. Si l'única cosa que surt és Exchange.ManageAsApp sense V2, tampoc. I si l'aplicació que apareix no és teva sinó d'un proveïdor —una eina de còpies, d'informes, de migració de bústies—, el permís el declara el registre d'aplicació d'aquell fabricant i a tu el que et tocarà és tornar a donar consentiment quan el publiquin. El que és útil allà no és tocar l'Entra: és escriure-li avui una línia preguntant si ja han migrat i guardar-te la resposta. Nosaltres ho fem amb els nostres, i no per desconfiança: per tenir la data d'algú que no som nosaltres abans que ens faci falta.

El que no és opcional per a ningú és la pregunta de sota, que no va de permisos. Una aplicació registrada al teu inquilí amb un permís d'abast organitzatiu és un sistema de producció: s'autentica sola, de matinada, contra les teves bústies, i quan deixa de funcionar ningú no ho nota fins que falta un informe o una còpia. Nosaltres tractem així la nostra automatització interna —l'n8n autoallotjat que publica i mou tasques— exactament igual que un servidor: inventariat, amb propietari i amb finestra d'actualització. Els registres d'aplicació que ens trobem quan entrem en un inquilí aliè rarament tenen les tres. Del preu d'aquell compte sense propietari ja en vam escriure quan van entrar com una aplicació i l'Entra ID no va demanar MFA: la identitat d'una aplicació no es cansa, no s'oblida la contrasenya i no passa pel segon factor.

Així que el termini del 30 de novembre, vist de prop, és una excusa barata per fer una feina que calia fer igualment: posar nom i propietari a cada identitat no humana que entra al teu correu. Si l'inventari surt buit, has perdut deu minuts. Si surt ple, acabes de descobrir quantes coses de la teva empresa depenen d'un permís que ningú no recorda haver concedit. Per a la part de govern de l'inquilí —identitats, consentiments, polítiques— aquella conversa és Microsoft 365 gestionat; per a la de «això qui ho mira i quan», que és la que de debò falla, és manteniment informàtic. Si vols que passem l'inventari amb tu i et diguem sense adorns si t'afecta o no, escriu-nos.

Fonts (verificades el 16 de novembre del 2026): l'avís MC1540345 «Action required: Update permissions for Exchange Online Admin API», publicat el 5 de novembre del 2026, amb els dos reemplaçaments de permís, la disponibilitat des de l'1 de novembre, el termini del 30 i l'obsolescència de l'1 de desembre (1 de gener del 2027 a GCC, GCC High i DoD), a el mirall públic del Centre de missatges. Que l'API no es retira i que només canvien els permisos, i la frase sobre errors d'autenticació, a Petri (9 de novembre del 2026). Els noms de permís que mana concedir el manual, la incoherència entre el pas de selecció i el de verificació, l'avís de Preview, l'àmbit /.default i el que inclou al testimoni, la distinció entre 401 i 403 i la taula d'extrems contra grups de rol, a les pàgines d'autenticació i autorització i primers passos de l'Admin API, totes dues amb data interna del 25 de setembre del 2026. El calendari d'EWS (fases des de l'1 d'octubre del 2026, finestra administrable fins al 31 de març del 2027, apagada l'1 d'abril del 2027) i la cita sobre la paritat del Graph, a l'anunci de retirada d'EWS. L'identificador d'«Office 365 Exchange Online» i els noms de permís d'EWS, a la guia de Microsoft per identificar aplicacions que fan servir EWS. Són compte nostre els catorze dies naturals i deu de laborables (sense comptar avui) fins al 30 de novembre i els 135 dies fins a l'1 d'abril del 2027. Les dues consultes de PowerShell són nostres, de només lectura, i estan escrites per al mòdul Microsoft.Graph.

Qui és el propietari de l'aplicació que entra al teu correu?

Si la resposta triga més d'un minut, el problema no és el permís que caduca el 30 de novembre. Passem l'inventari d'identitats del teu inquilí amb tu i et diem sense adorns què t'afecta i què no.

Parlar amb everyWAN

Etiquetes:

Compartir:

Subscriu-te al nostre butlletí

Per rebre històries del món IT, novetats d'everyWAN i ofertes exclusives per a subscriptors, dona't d'alta a la nostra llista de correu

everyWAN
everyWAN