Visão geral
Parques de proxies Apigee crescem na base do copiar e colar. Quando as mesmas políticas de autenticação, logging e tratamento de erros existem em centenas de bundles mantidos de forma independente, uma única mudança de segurança vira um projeto de centenas de pull requests.
Desafio
Uma mudança obrigatória na validação de tokens precisava ser aplicada a cada proxy individualmente, e a equipe não conseguia confirmar que ela tinha sido aplicada de forma consistente. As respostas de erro variavam entre os proxies, então as equipes clientes tratavam as falhas de maneiras diferentes dependendo da API que chamavam. Não havia estratégia de shared flows nem convenção de nomenclatura ou de versionamento.
Ambiente
Apigee X com proxies de responsabilidade de várias equipes de produto, na frente de serviços internos e de APIs voltadas a parceiros, sob requisitos de segurança do setor financeiro.
Abordagem
A AceMQ analisou os bundles de proxies como código-fonte, agrupando blocos de políticas quase idênticos para quantificar a duplicação e identificar as fronteiras naturais dos shared flows. O resultado foi uma arquitetura-alvo de shared flows e uma sequência de refatoração que podia ser executada de forma incremental, sem congelamento de mudanças.
Solução
- Análise estática de todos os bundles de proxies para agrupar a lógica de políticas duplicada e quantificar a duplicação
- Definição de uma arquitetura de shared flows cobrindo autenticação, logging, tratamento de erros e CORS
- Padronização do formato das respostas de erro e do tratamento de falhas em todo o parque
- Definição de convenções de nomenclatura, versionamento e implantação de proxies, com um checklist de revisão
- Sequenciamento da refatoração incremental para que os proxies adotem os shared flows sem congelamento de mudanças
- Definição de quais decisões de política pertencem aos shared flows e quais devem legitimamente continuar em cada proxy
Resultado obtido
Mudanças de políticas relevantes para a segurança passaram a ser uma única atualização de shared flow, e não uma campanha proxy por proxy, e as equipes clientes ganharam uma semântica de erros consistente em toda a superfície de APIs.