Et API-baseret sikkerhedsværktøj kan inspicere postkasseindhold uden at være den udgående underskriver eller indgående SMTP gateway. Dens tilstedeværelse udgiver ikke din SPF politik, bemyndige en DKIM underskriver eller etablere DMARC justering. Dokumentér, hvilken meddelelsespopulation værktøjet ser, hvornår det ser det, og hvilke handlinger det kan udføre, før du beskriver det som beskyttelse for hver rute.
Definer dækning og timing
Tegn de indgående og udgående stier separat. Et program, der læser beskeder efter levering, kan finde eller rette indhold, der allerede nåede en postkasse; der ikke demonstrerer forebyggelse på SMTP tid. Udgående applikationsmail må aldrig passere gennem den overvågede postkasse overhovedet. Registrer postkasseomfang, mapper, tilladelser, polling- eller notifikationsadfærd og forventede behandlingsforsinkelser som implementeringsegenskaber, der skal verificeres.
Microsoft Graph message delta v1.0 er et konkret eksempel på en versioneret postkassegrænseflade, ikke et komplet sikkerhedsprodukt. Dens dokumentation definerer ændringssporing for en beskedsamling og fortsættelseslinks. Message delta API. Fastgør API-overfladen og din adapterrevision, så senere ændringer kan skelnes fra en hændelse i dataene.
Følg fortsættelsestilstand uden at droppe arbejdet
Brug returnerede URL'er på næste side som uigennemsigtige fortsættelser i stedet for at genopbygge deres tokens. Gem den endelige delta-URL til næste runde, efter at de aktuelle ændringer er varigt håndteret. Diagramsøgning. Behold en gendannelsesstrategi for en udløbet eller ugyldig fortsættelsestilstand; en genstart må ikke stille og roligt tælle som uafbrudt dækning.
Idempotens kræver en operationsspecifik nøgle. Deduplikering for evigt på besked-id alene kan kassere ægte opdateringer til den samme besked. Skelne genafspillede begivenheder fra senere ændringer og sletninger. Optag postkasse- og mappeomfang med kontrolpunktet for at undgå at anvende et token til en anden samling. Disse er adapterdesignanbefalinger, ikke en påstand om, at Graph leverer et universelt hændelsesrevisionsfelt.
Design en hypotetisk fortsættelsesbog
Antag, at to opfundne sider indeholder m1 revision1 og m2 revision1, efterfulgt af en gentagelse af m1 revision1, m2 revision2 og en slettemarkør for m3. Revision er et lokalt undervisningsområde, ikke en lovet Graph-egenskab eller foreslået produktionsdeduplikeringsalgoritme. De påtænkte beslutninger er at undgå at genafspille m1's samme effekt, bevare den senere m2-tilstand og behandle m3-sletningen under applikationens opbevaringsregler. Den rigtige adapter skal definere sine nøgler fra den faktiske API-kontrakt.
I en separat hypotetisk batch returnerer anmodning A succes, B returnerer 429 med Retry-After:3 og C returnerer403. Marker A fuldført, tidsplan B ikke tidligere end den dokumenterede forsinkelse, og lad C være blokeret for tilladelsesundersøgelse i stedet for blindt at prøve det igen. Hvis Retry-After er fraværende, anbefaler Microsoft eksponentiel backoff. Ingen anmodning, dvale, batch-udførelse, database-commit eller crash-recovery-test blev udført for disse skriftlige cases.
Håndter delvis fejl eksplicit
Tegn dokumenter, der begrænser på individuel anmodningsniveau, inklusive anmodninger, der er placeret i en batch. Undersøg hvert undersvar i stedet for at fortolke en accepteret batch-konvolut som universel succes. Brug den dokumenterede Retry-After-forsinkelse og undgå øjeblikkelige genforsøgsløkker. Drossel og JSON batching.
Overvåg det sidst behandlede vindue, afventende genforsøg og blokerede tilladelsesfejl. Eksporter kun de beskeddata, der er nødvendige til sikkerhedsformålet, med godkendt adgang og opbevaring. En sund API-forbindelse beviser ikke, at hver meddelelse blev inspiceret, og en gennemført inspektion fastslår ikke, at afhjælpningen lykkedes.
Hold udgående godkendelsesaccepttests uafhængige: undersøg en ægte autoriseret endelig besked, dens underskrifts- og kuvertidentiteter og det betroede modtageresultat. Luk API og godkendelsesarbejde med separate beviser. Disse skriftlige beslutninger er planlægningshjælpemidler; lejertilladelser, faktisk personsøgning, gendannelse, svarhandlinger og udgående e-mailbekræftelse forbliver implementeringstest frem for afsluttede resultater.
Hold et kontrolpunkt, når behandlingen er ufuldstændig
Antag, at den sidste side indeholder en uløst skrivefejl. At gå videre til dens deltaLink kan skjule uforpligtende ændringer fra applikationens næste runde. Hold det ufuldstændige arbejde genopretteligt, og registrer dækningsgabet, indtil en testet holdbar behandlingsstrategi løser det. Dette er råd om adapterdesign, ikke en garanti for, at blot at beholde et token gør genoprettelsen atomisk. Meddelelsesdelta sporer en specificeret mappe; dokumentere, hvordan det valgte postkasse- og mappeomfang dækker den påtænkte sikkerhedsbelastning.
Kilde og udførelsesgrænse
RFC 9989 afsnit 4.4, 5.3.5 og 5.4 skelne autentificering, justering og håndtering; et pas godkender ikke beskedindhold. De operationelle beslutninger her er scoped anbefalinger og eksplicit hypotetiske eksempler, ikke nye test af en kunde, udbyder eller historisk inventar. Enhver reel ændring kræver sit eget autoriserede omfang, bevarede beviser og ansvarlig beslutning.