EWS lõpeb Exchange Online'is 1. aprillil 2027: kuidas viia oma integratsioonid Microsoft Graphile

Microsoft on hakanud Exchange Online'is Exchange Web Services'it (EWS) välja lülitama. Esimesed jõustamissammud toimuvad sel kuul ja seejärel lülitatakse ükshaaval välja rentnikud (tenant), kes pole oma EWS-i seadeid kunagi puutunud. Microsofti eesmärk on lülitada EWS täielikult välja 1. aprillil 2027, kuigi tema 1. oktoobri Message Centeri teade MC1485116 eeldab, et ülemaailmse ja USA valitsuse pilve ulatuses lõpeb kasutuselevõtt 2027. aasta juuli alguseks. Planeerige 1. aprilli järgi. Microsoft on selgelt öelnud, et pärast 2027. aasta aprilli erandeid ei tehta.

Kui midagi, mille teie ettevõte on ehitanud, suhtleb Microsoft 365 postkastidega EWS-i kaudu, lakkab see töötamast hiljemalt selleks kuupäevaks ja võib-olla palju varem. Tavalised kahtlusalused: CRM, mis seob kliendikirjad kontodega, arhiveerimis- või säilitusskript, nõupidamisruumide broneerimisekraan, piletisüsteem, mis loeb jagatud tugipostkasti, aruandlustöö, mis loeb kokku e-kirjad meeskonna kohta. Lahendus on ümberkirjutamine Microsoft Graphi vastu ja osale sellest, mida EWS suutis, pole Graphis üldse vastet.

Mis juhtub, kuupäevade kaupa

Microsoft juhib EWS-i rentnikupõhiselt seadega EWSEnabled, millel on kolm väärtust: Null (vaikimisi), True ja False. Selle kõrval on nüüd teine seade, EWSAllowedAppIDs: rakenduste ID-de loend, mis tohivad EWS-i endiselt kasutada. Microsoft Learni praegune leht annab üldpildi: „2026. aasta oktoober: EWS-i hakatakse kõigi organisatsioonide jaoks ülemaailmselt välja lülitama“ ja „2027. aasta aprill: EWS on täielikult välja lülitatud.“

Üksikasjad on Exchange'i meeskonna 1. oktoobri postituses EWS Deprecation Is Here. Ülemaailmse kommertspilve kohta:

• 2. oktoober 2026, päeva lõpp Vaikse ookeani aja järgi: Microsoft registreerib iga rentniku, kelle EWSEnabled on True, kuid lubatud loend puudub.
• 8. ja 9. oktoober 2026: nende rentnike jaoks loob Microsoft lubatud loendi ja täidab selle rakenduste ID-dega, mis kasutasid EWS-i eelneva 60 päeva jooksul.
• Alates 10. oktoobrist 2026: kui EWSEnabled on True, on lubatud loend kohustuslik. Rakendus, mida loendis pole, lükatakse tagasi.
• Teine etapp, pärast seda: rentnikel, kelle väärtus on endiselt Null, seatakse EWSEnabled väärtuseks False, mis blokeerib EWS-i kõigile rakendustele. Igaüks saab Message Centeris 7-päevase hoiatuse ja Microsoft täidab vahetult enne seda lubatud loendi 60 päeva kasutuse põhjal, nii et administraator saab EWS-i väärtusega True uuesti sisse lülitada.
• 1. aprill 2027: Microsofti sihtkuupäev, mil EWS on „täielikult ja jäädavalt välja lülitatud“ ning pärast mida kaotavad rentnike administraatorid võimaluse EWSEnabled väärtust üldse muuta. MC1485116 nimetab kasutuselevõtu eeldatavaks lõpuks Worldwide, GCC, GCC High ja DoD pilvedes 2027. aasta juuli algust, seega võivad mõned rentnikud EWS-i veidi kauem alles hoida. Keegi ei tohiks loota, et ta on üks neist.

Microsofti teiste pilvede rentnikud saavad oma ajakava Message Centeri kaudu.

Lubatud loend annab aega, mitte lahenduse

Automaatne loend koostatakse 60 päeva liikluse põhjal ja Microsofti enda 4. septembri juhis hoiatab, et see „võib jätta välja harva töötavad rakendused“. Kvartalilõpu eksport või aastalõpu arhiveerimistöö ei ole loendis ja ebaõnnestub järgmisel käivitamisel.

Lubatud loendi muudatused jõustuvad 24 tunni pärast ja EWSEnabled muudatused umbes tunni pärast. Iga parandus, mille teete pärast tõrget, maksab vähemalt ühe päeva.

Et näha, kus teie rentnik seisab, saab Exchange Online PowerShelliga administraator käivitada:

Get-OrganizationConfig | Format-List EWSEnabled
Get-OrganizationConfig -RetrieveEwsOperationAccessPolicy | Format-List EwsAllowedAppIDs

Keda see puudutab ja kes võib lugemise lõpetada

Kohapealset Exchange Serverit see ei mõjuta. Microsofti sõnul kehtib lõpetamine „ainult Microsoft 365-le ja Exchange Online'ile“ ning „Exchange Serveris EWS-is muudatusi ei tehta“. Kui kõik teie postkastid asuvad teie enda serverites, võite siin lõpetada.

Hübriidlahendusi tuleb lähemalt vaadata. Kohapealsed postkastid võivad EWS-i edasi kasutada; pilves olevad postkastid peavad minema üle Graphile. Microsofti 30. septembri hübriidpostitus käsitleb kahte juhtumit, mis nõuavad tegutsemist kohe, sealhulgas kohapealseid postkaste, mille arhiivid on Exchange Online'is: praegu on soovitus hoida EWS sisse lülitatuna ja lisada hübriidrakendus lubatud loendisse.

Pakendatud tarkvara on tarnija mure. Kui EWS-i kutsub välja kommertstoode, on Graphi versiooni väljastamine tarnija töö ning teie töö on saada temalt kuupäev ja uuendus paigaldada. Microsofti enda kliendid ei ole erand: mõned ilmuvad endiselt kasutusaruannetesse ja vajavad kuni uuendamiseni lubatud loendit.

Ettevõttesisene kood on teie töö. Skriptidel, sisemistel teenustel, kohandatud avatud lähtekoodiga tööriistadel ja integratsioonidel, mille mõni agentuur aastaid tagasi ehitas, pole kedagi, kes neid ülesvoolu parandaks. Just seal on töö. Mastaabi mõistmiseks: exchangelibi, Pythoni teeki Exchange'iga EWS-i kaudu suhtlemiseks, laaditi PyPI-st viimase kuu jooksul alla 1 174 625 korda. Osa sellest on kohapealne kasutus, kuid see annab aimu, kui palju koodi räägib otse EWS-i keelt.

Esimene samm: leidke kõik, mis EWS-i kasutab

Alustage EWS-i kasutusaruandest Microsoft 365 halduskeskuses (Reports, Usage, Exchange ja seejärel vahekaart EWS usage). Iga rakenduse kohta näitab see Microsoft Entra rakenduse ID-d, iga SOAP-toimingut, mida rakendus välja kutsus, kutsete mahtu ja viimase tegevuse kuupäeva. Saate vaadata 7, 30 või 90 päeva tagasi ja eksportida CSV-failiks.

Kolm asja, mida selle kohta teada:

• Andmeid koondatakse kord nädalas ja nende ilmumine võib võtta kuni 10 päeva.
• Rakenduse ID ei ole omanik. Sobitage iga ID Microsoft Entra jaotisega Enterprise applications ja leidke seejärel inimene või meeskond, kes seda käitab. Arvestage, et mõnda ID-d ei tunne keegi ära.
• SOAP-toimingute veerg ütleb, kui suur iga töö on. Rakendus, mis kutsub välja ainult FindItem ja GetItem, on lühike töö. Rakendus, mis kutsub välja SyncFolderItems, Subscribe ja ExportItems, on projekt.

Isegi 90 päeva jätab aastased tööd välja, seega kontrollige ka teist poolt: ajastatud ülesandeid ja croni kirjeid ning otsige koodihoidlatest EWS-i lõpp-punkti (Exchange.asmx), .NET-i EWS Managed API-t ja exchangelibi. Microsofti lõpetamislehel on ka link .NET-koodi EWS-analüsaatorile (see märgib Visual Studios ja VS Code'is EWS-i kutsed ja pakub Graphi vasteid) ning juhendile tehisintellekti abil ümberkujundamise kohta.

Teine samm: otsustage, milleks iga integratsioon muutub

Iga loendis olev rakendus saab ühe neljast vastusest:

1. Lõpetage see. Mõned integratsioonid on olemas ainult seetõttu, et keegi pole neid välja lülitanud.
2. Uuendage see. Tarnija tooted saavad tarnija uuenduse. Leppige kuupäev kokku kohe.
3. Kirjutage see Microsoft Graphi vastu ümber. Ettevõttesisese koodi puhul vaikevalik.
4. Kujundage see ümber. Kõige puhul, mis tugineb võimekusele, mida Graphil kunagi ei tule (vt allpool).

Microsoft nimetab töövoo uuesti teostamise võimalusena ka Power Platformi. Skripti puhul, mis edastab manuseid kausta, võib see olla odavaim vastus.

Mida Graphi ümberkirjutamine tegelikult hõlmab

Enamikul EWS-i toimingutel on Graphis otsene vaste ja Microsoft haldab EWS-i ja Graphi vastavustabelit. Vastavustabel on lihtne osa. Raskemad osad on need, mida see ei näita.

Õigused muutuvad kitsamaks ja see on eelis

Rakendusel, mis kasutab EWS-i ilma sisselogitud kasutajata, on EWS-i rakenduseõigus, mida Microsoft kirjeldab kui „täielikku juurdepääsu kõigile postkastidele“. Graph jagab selle eraldi õigusteks: Mail.Read, Mail.ReadBasic, Mail.Send, Calendars.ReadWrite, MailboxSettings.Read ja nii edasi.

Samuti saate piirata, milliste postkastideni rakendus jõuab. RBAC for Applications in Exchange Online määrab õiguse halduspiirkonna (management scope) või haldusüksuse suhtes ja asendab vanemad Application Access Policies. Ruumide broneerimise ekraan saab lugeda kaheteistkümne ruumipostkasti kalendreid ja mitte midagi muud. Üks lõks: sel viisil antud õigused lisanduvad Microsoft Entras antud kogu rentnikku hõlmavale õigusele, nii et kui Mail.Read on seal endiselt heaks kiidetud, ei piira teie ulatus midagi. Eemaldage Entra õigus.

Kasutage rakenduse autentimiseks võimaluse korral sertifikaate, mitte kliendisaladusi, ja hoidke mandaadid skriptidest ja koodihoidlatest eemal.

Sünkroonimine ja teavitused ehitatakse uuesti, mitte ei tõlgita

See on tavaliselt suurim muudatus kõige jaoks, mis hoiab postkasti andmetest kohalikku koopiat.

Sünkroonimine. SyncFolderItems vastab Graphi sõnumite delta-päringule ja SyncFolderHierarchy meilikaustade delta-päringule. Sõnumite delta töötab ühe kausta kaupa, nii et kogu postkasti sünkroonimine tähendab kaustapuu jälgimist ja iga kausta jaoks eraldi delta-lingi salvestamist. Filtreerimine on piiratud (ainult saabumiskuupäeva järgi) ning tulemused sisaldavad kustutamisi, kaustast välja teisaldamisi ja loetud oleku muutusi ka siis, kui need teie filtrile ei vasta.

Teavitused. EWS-i voog- ja tõukellimused muutuvad Graphi muudatusteavitusteks, mis edastatakse teie käitatavale veebihaagile (webhook) või Azure Event Hubsi või Event Gridi. Veebihaak peab olema Microsofti poolelt kättesaadav, mis on arhitektuurimuudatus skriptile, mis varem hoidis tulemüüri tagant ühendust avatuna. Meili, kalendri ja kontaktide tellimused kehtivad kõige rohkem 10 080 minutit (veidi alla seitsme päeva) või 1 440 minutit, kui teavitus sisaldab andmeid, nii et miski peab neid uuendama. Igal postkastil on kõigi rakenduste peale kokku kuni 1 000 aktiivset tellimust.

Muster, mis peab vastu: käsitlege teavitust vihjena, käivitage delta-päring, et näha, mis muutus, ja käivitage see ka taimeri järgi, et püüda kinni kõik, mis vahele jäänud teavituse tõttu oleks kaduma läinud.

Andmed, ID-d ja läbilaskevõime

• Salvestatud ID-d. Kui teie CRM või piletisüsteem salvestas e-kirjade kirjetega sidumiseks EWS-i üksuste ID-d, tuleb need lingid teisendada. Graphis on just selleks funktsioon translateExchangeIds. Planeerige teisendamine eraldi migratsioonisammuna.
• Päringud. ResolveNames vastab People API-le, GetUserAvailability funktsioonile getSchedule, kontorist eemal oleku seaded postkasti seadetele. Lähedased vasted, mitte identsed.
• Piiramine (throttling). Graph lubab iga rakenduse ja postkasti paarile 10 000 päringut 10 minuti kohta, neli samaaegset päringut ja 150 MB üleslaadimisi 5 minuti kohta. Hulgitöö, mis käitas ühe postkasti vastu kümneid paralleelseid EWS-i lõimi, tuleb nende arvude ümber uuesti kujundada.

Lüngad ja see, mida kunagi ei tule

Microsoft avaldab teekaardi EWS-i võimekustest, mis Graphist veel puuduvad. Sinna kuuluvad täieliku täpsusega import ja eksport arhiivi-, avalike kaustade ja grupipostkastide jaoks, juurdepääs kohapealsetele arhiividele (in-place archives), kaustaõigused Exchange Admin API kaudu ja mittemustandsõnumite loomine MIME-st. Enamiku sihtaeg on 2026. aasta neljas kvartal. Kolm pidid valmima kolmandas kvartalis, mis on nüüdseks lõppenud: märkmete API sai Graphis üldiselt kättesaadavaks 2026. aasta augustis ja isiklikud kontaktiloendid on eelvaates (beta) alates 2026. aasta juunist. Ülejäänute puhul kontrollige enne nende ümber kavandamist, mis on tegelikult välja antud. Microsofti enda hoiatus: kui võimekust pole teekaardil, „ärge planeerige“ Graphi vastet enne, kui EWS välja lülitatakse.

Kolm võimekust ei tule Graphisse kinnitatult kunagi:

• Üldine juurdepääs avalikele kaustadele (kaustade ja üksuste loomine, lugemine, uuendamine ja kustutamine).
• Üldine juurdepääs Microsoft 365 grupi postkastidele. Graph katab selle asemel grupivestlused, lõimed ja postitused.
• Juurdepääs avastuspostkastidele (discovery mailbox). Microsoft suunab selle asemel Purview eDiscovery juurde.

Kui tööriist sõltub mõnest neist, ei piisa koodi ülekandmisest: andmed või töövoog tuleb esmalt kuhugi mujale viia ja see võtab kauem aega kui ümberkirjutamine.

Kuue kuu plaan

Tänasest kuni 1. aprillini 2027 on veidi alla kuue kuu. Realistlik järjekord:

Oktoober 2026: vaadake, kus te seisate. Kontrollige EWSEnabled väärtust ja lubatud loendit. Eksportige 90 päeva kasutusaruanne. Vaadake üle Microsofti täidetud loend, eemaldage sealt see, mida seal olla ei tohiks, ja lisage harva töötavad tööd, millest teate. Kui teie rentnik on endiselt väärtusel Null, kaaluge loendi ja väärtuse True ise seadmist, selle asemel et oodata Microsofti ümberlülitust väärtusele False ja avastada, mis katki läheb.

November 2026: sorteerimine. Määrake igale rakenduse ID-le omanik ja vastus (lõpetada, uuendada, ümber kirjutada, ümber kujundada). Skannige kood. Märkige kõik, mis puudutab avalikke kaustu, grupipostkaste või avastuspostkaste, ja alustage ümberkujundamist kohe. Looge Graphi rakenduste registreeringud piiratud õigustega.

Detsember 2026 kuni jaanuar 2027: ehitamine. Alustage integratsioonist, millest ettevõte puudust tunneks esimesena. Ehitage sünkroonimise ja teavituste taristu üks kord ja kasutage seda korduvalt. Teisendage salvestatud ID-d.

Veebruar 2027: käitage mõlemat kõrvuti. Kuni EWS veel töötab, käitage vana ja uut versiooni samade postkastide vastu ja võrrelge väljundit. Kui üks on vastu võetud, eemaldage selle ID lubatud loendist. See on ühtlasi test: oodake 24 tundi ja veenduge, et midagi muud ei lakanud töötamast.

Märts 2027: lülitage EWS ise välja. Seadke EWSEnabled väärtuseks False aegsasti enne 1. aprilli. Kõik, mis jäi märkamata, ebaõnnestub ajal, mil saate EWS-i veel tagasi sisse lülitada. Pärast 1. aprilli seda võimalust enam pole. Tehke ka kvartali- ja aastatöödele enne seda teadlik proovikäivitus: töö, mis käivitub esimese kvartali lõppemisel, käivitub esimest korda alles pärast EWS-i kadumist.

Kust abi saada

Raske juhtum on integratsioon, mille algne arendaja on lahkunud. Meie pärandsüsteemide hooldusteenus on loodud just selleks: loeme olemasolevat koodi, kirjutame EWS-i osad Microsoft Graphi vastu ümber (õigused, sünkroonimine, teavitused, ID-de migratsioon) ning käitame vana ja uut kõrvuti, kuni numbrid klapivad. Kui vajate selle asemel insenere, kes töötaksid teie enda meeskonnas, vaadake meie personali täiendamise teenust.

Kui teie kasutusaruanne on täis rakenduste ID-sid, mida keegi ära ei tunne, kirjutage aadressile office@c9group.dev.