Przegląd
Środowiska proxy Apigee rozrastają się metodą kopiuj-wklej. Gdy te same polityki uwierzytelniania, logowania i obsługi błędów istnieją w setkach niezależnie utrzymywanych pakietów, pojedyncza zmiana bezpieczeństwa zamienia się w projekt na setki pull requestów.
Wyzwanie
Wymaganą zmianę walidacji tokenów trzeba było wprowadzić w każdym proxy z osobna, a zespół nie był w stanie potwierdzić, że zastosowano ją wszędzie w ten sam sposób. Odpowiedzi błędów różniły się między proxy, więc zespoły klienckie obsługiwały awarie inaczej w zależności od tego, które API wywoływały. Nie było strategii shared flows ani konwencji nazewnictwa i wersjonowania.
Środowisko
Apigee X z proxy należącymi do wielu zespołów produktowych, stojącymi przed usługami wewnętrznymi i API dla partnerów, objętymi wymogami bezpieczeństwa sektora finansowego.
Podejście
AceMQ przeanalizował pakiety proxy jak kod źródłowy, grupując niemal identyczne bloki polityk, aby zmierzyć skalę duplikacji i wskazać naturalne granice shared flows. Rezultatem była docelowa architektura shared flows oraz kolejność refaktoryzacji, którą można realizować przyrostowo, bez zamrażania zmian.
Rozwiązanie
- Statyczna analiza wszystkich pakietów proxy w celu pogrupowania zduplikowanej logiki polityk i zmierzenia skali duplikacji
- Zdefiniowanie architektury shared flows obejmującej uwierzytelnianie, logowanie, obsługę błędów i CORS
- Ujednolicenie struktury odpowiedzi błędów i obsługi fault w całym środowisku
- Wprowadzenie konwencji nazewnictwa, wersjonowania i wdrażania proxy wraz z listą kontrolną do przeglądów
- Zaplanowanie przyrostowej refaktoryzacji, dzięki której proxy przechodzą na shared flows bez zamrażania zmian
- Określenie, które decyzje dotyczące polityk należą do shared flows, a które w uzasadniony sposób pozostają na poziomie pojedynczych proxy
Efekt
Zmiany polityk istotne dla bezpieczeństwa stały się pojedynczą aktualizacją shared flow zamiast kampanii prowadzonej proxy po proxy, a zespoły klienckie zyskały spójną semantykę błędów w całej powierzchni API.