Überblick
Apigee-Proxy-Landschaften wachsen durch Copy-and-paste. Sobald dieselben Policies für Authentifizierung, Logging und Fehlerbehandlung in Hunderten unabhängig gepflegter Bundles stecken, wird aus einer einzigen Sicherheitsänderung ein Projekt mit Hunderten von Pull Requests.
Herausforderung
Eine verpflichtende Änderung an der Token-Validierung musste in jedem Proxy einzeln umgesetzt werden, und das Team konnte nicht bestätigen, dass sie überall einheitlich angewendet worden war. Die Fehlerantworten unterschieden sich von Proxy zu Proxy, sodass Client-Teams Fehler je nach aufgerufener API unterschiedlich behandelten. Es gab weder eine Shared-Flow-Strategie noch Konventionen für Benennung und Versionierung.
Umgebung
Apigee X mit Proxys im Besitz mehrerer Produktteams, die interne Services und APIs für Partner unter den Sicherheitsanforderungen der Finanzbranche bereitstellen.
Vorgehen
AceMQ analysierte die Proxy-Bundles als Quellcode und gruppierte nahezu identische Policy-Blöcke, um das Ausmaß der Duplizierung zu beziffern und die natürlichen Grenzen der Shared Flows zu bestimmen. Ergebnis war eine Ziel-Architektur für Shared Flows samt einer Refactoring-Reihenfolge, die sich schrittweise und ohne Änderungsstopp umsetzen ließ.
Lösung
- Statische Analyse aller Proxy-Bundles, um duplizierte Policy-Logik zu gruppieren und die Duplizierung zu beziffern
- Definition einer Shared-Flow-Architektur für Auth, Logging, Fehlerbehandlung und CORS
- Vereinheitlichung von Fehlerantworten und Fault Handling über die gesamte Landschaft
- Konventionen für Benennung, Versionierung und Deployment von Proxys samt Review-Checkliste
- Schrittweises Refactoring in festgelegter Reihenfolge, sodass Proxys Shared Flows ohne Änderungsstopp übernehmen
- Festlegung, welche Policy-Entscheidungen in Shared Flows gehören und welche berechtigterweise pro Proxy bleiben
Resultat
Sicherheitsrelevante Policy-Änderungen sind jetzt ein einziges Update eines Shared Flow statt einer Kampagne Proxy für Proxy, und die Client-Teams erhalten über die gesamte API-Landschaft hinweg eine einheitliche Fehlersemantik.