Panoramica
I parchi proxy Apigee crescono per copia e incolla. Quando le stesse policy di autenticazione, logging e gestione degli errori esistono in centinaia di bundle mantenuti in modo indipendente, una singola modifica di sicurezza diventa un progetto da centinaia di pull request.
Sfida
Una modifica obbligatoria alla validazione dei token doveva essere applicata a ogni proxy singolarmente, e il team non era in grado di confermare che fosse stata applicata in modo coerente. Le risposte di errore variavano da un proxy all'altro, quindi i team client gestivano i fallimenti in modo diverso a seconda dell'API chiamata. Non esisteva una strategia di shared flow né una convenzione di naming o di versioning.
Ambiente
Apigee X con proxy di proprietà di più team di prodotto, posti davanti a servizi interni e ad API esposte ai partner, nel rispetto dei requisiti di sicurezza del settore finanziario.
Approccio
AceMQ ha analizzato i bundle dei proxy come codice sorgente, raggruppando i blocchi di policy quasi identici per quantificare la duplicazione e individuare i confini naturali degli shared flow. Il risultato è stato un'architettura di shared flow di riferimento, più una sequenza di refactoring eseguibile in modo incrementale senza congelare le modifiche.
Soluzione
- Analisi statica di tutti i bundle dei proxy per raggruppare la logica di policy duplicata e quantificare la duplicazione
- Definizione di un'architettura di shared flow per autenticazione, logging, gestione degli errori e CORS
- Standardizzazione del formato delle risposte di errore e della gestione dei fault in tutto il parco
- Definizione di convenzioni di naming, versioning e deployment dei proxy, con una checklist di revisione
- Pianificazione di un refactoring incrementale che consente ai proxy di adottare gli shared flow senza un change freeze
- Definizione di quali decisioni di policy vanno negli shared flow e quali restano legittimamente a livello di singolo proxy
Esito
Le modifiche alle policy rilevanti per la sicurezza sono diventate un unico aggiornamento di uno shared flow invece di una campagna proxy per proxy, e i team client hanno ottenuto una semantica degli errori coerente su tutta la superficie delle API.