Uno strumento di sicurezza basato su API può ispezionare il contenuto della casella di posta senza essere il firmatario in uscita o il gateway SMTP in entrata. La sua presenza non pubblica il tuo SPF politica, autorizzare a DKIM firmatario o stabilito DMARC allineamento. Documenta quale messaggio vede lo strumento, quando lo vede e quali azioni può eseguire prima di descriverlo come protezione per ogni percorso.
Definire copertura e tempistica
Disegna separatamente i percorsi in entrata e in uscita. Un'applicazione che legge i messaggi dopo la consegna può rilevare o correggere il contenuto che ha già raggiunto una casella di posta; ciò non dimostra la prevenzione al momento SMTP . La posta in uscita dell'applicazione potrebbe non passare mai attraverso la casella di posta monitorata. Registra l'ambito della casella di posta, le cartelle, le autorizzazioni, il comportamento di polling o notifica e i ritardi di elaborazione previsti come proprietà di implementazione da verificare.
Microsoft Graph message delta v1.0 è un esempio concreto di un'interfaccia di cassetta postale con versione, non un prodotto di sicurezza completo. La relativa documentazione definisce il rilevamento delle modifiche per una raccolta di messaggi e collegamenti di continuazione. API delta dei messaggi. Blocca la superficie API e la revisione dell'adattatore in modo che le modifiche successive possano essere distinte da un incidente nei dati.
Segui lo stato di continuazione senza abbandonare il lavoro
Utilizza gli URL della pagina successiva restituiti come continuazioni opache anziché ricostruire i relativi token. Salva l'URL delta finale per il turno successivo solo dopo che le modifiche correnti sono state gestite in modo duraturo. Impaginazione del grafico. Mantenere una strategia di ripristino per uno stato di continuazione scaduto o non valido; un riavvio non deve essere considerato silenziosamente come copertura ininterrotta.
L'idempotenza necessita di una chiave specifica dell'operazione. La deduplicazione permanente solo sull'ID del messaggio può eliminare gli aggiornamenti autentici dello stesso messaggio. Distinguere gli eventi riprodotti dalle modifiche ed eliminazioni successive. Registra l'ambito della cassetta postale e della cartella con il checkpoint per evitare di applicare un token a una raccolta diversa. Si tratta di raccomandazioni per la progettazione dell'adattatore, non di un'affermazione secondo cui Graph fornisce un campo di revisione degli eventi universale.
Progettare un ipotetico registro di continuazione
Supponiamo che due pagine inventate contengano m1 revisione1 e m2 revisione1, seguite da una riproduzione di m1 revisione1, m2 revisione2 e un indicatore di cancellazione per m3. La revisione è un campo di insegnamento locale, non una proprietà di Graph promessa o un algoritmo di deduplicazione della produzione suggerito. Le decisioni previste sono quelle di evitare di riprodurre lo stesso effetto di m1, mantenere lo stato m2 successivo ed elaborare l'eliminazione di m3 secondo le regole di conservazione dell'applicazione. L'adattatore reale deve definire le proprie chiavi dal contratto API effettivo.
In un batch ipotetico separato, la richiesta A restituisce successo, B restituisce 429 con Retry-After:3 e C restituisce 403. Contrassegnare A come completo, programmare B non prima del ritardo documentato e lasciare C bloccato per l'indagine sulle autorizzazioni anziché riprovare alla cieca. Se Retry-After è assente, Microsoft consiglia il backoff esponenziale. Per questi casi scritti non è stata eseguita alcuna richiesta, sospensione, esecuzione batch, commit del database o test di ripristino da arresto anomalo del sistema.
Gestire esplicitamente il fallimento parziale
La limitazione dei documenti grafici è a livello di richiesta singola, comprese le richieste inserite all'interno di un batch. Esamina ogni risposta secondaria anziché interpretare una busta batch accettata come un successo universale. Utilizzare il ritardo Retry-After documentato ed evitare cicli di tentativi immediati. Limitazione E batch JSON.
Monitora l'ultima finestra elaborata correttamente, i tentativi in sospeso e gli errori di autorizzazione bloccati. Esporta solo i dati dei messaggi necessari a fini di sicurezza, con accesso e conservazione approvati. Una connessione API integra non dimostra che tutti i messaggi siano stati controllati e un'ispezione completata non stabilisce che la correzione abbia avuto esito positivo.
Mantieni indipendenti i test di accettazione dell'autenticazione in uscita: esamina un vero messaggio finale autorizzato, la sua firma e le identità della busta e il risultato di ricezione attendibile. L'API chiusa e l'autenticazione funzionano con prove separate. Queste decisioni scritte costituiscono aiuti alla pianificazione; le autorizzazioni del tenant, il paging effettivo, il ripristino, le azioni di risposta e la verifica della posta in uscita rimangono test di distribuzione anziché risultati completati.
Mantieni un checkpoint quando l'elaborazione è incompleta
Supponiamo che la pagina finale contenga un errore di scrittura non risolto. L'avanzamento al deltaLink potrebbe nascondere le modifiche non confermate dal prossimo round dell'applicazione. Mantieni recuperabile il lavoro incompleto e registra il divario di copertura fino a quando una strategia di elaborazione duratura testata non lo risolve. Si tratta di un consiglio per la progettazione dell'adattatore, non di una garanzia che il semplice mantenimento di un token renda il ripristino atomico. Il delta del messaggio tiene traccia di una cartella specificata; documentare in che modo la casella di posta e l'ambito della cartella scelti coprono il carico di lavoro di sicurezza previsto.
Confine di origine e di esecuzione
RFC 9989 Sezioni 4.4, 5.3.5 e 5.4 distinguere autenticazione, allineamento e gestione; un passaggio non approva il contenuto del messaggio. Le decisioni operative qui sono raccomandazioni mirate ed esempi esplicitamente ipotetici, non nuovi test di un cliente, fornitore o appuntamento storico. Qualsiasi cambiamento reale richiede un proprio ambito autorizzato, prove conservate e una decisione responsabile.