Skip to content

Caminho das requisições ​

Este diagrama mostra por onde passa cada tipo de tráfego, da internet até os dados. O tráfego regulado e o tráfego público seguem caminhos separados desde a entrada no cluster.

Caminho das requisições até os serviçosParticipantes, navegadores e aplicativos entram pelo balanceador de carga da nuvem e pelos Gateways do Cilium. O tráfego regulado passa pelo Kong com mTLS obrigatório; o público, com TLS terminado no gateway, pelo Kong de API; login, console e portal vão direto ao destino. Os serviços usam PostgreSQL e Redis em sub-redes privadas e o NATS dentro do cluster.Participantescertificado ICP-BrasilClientes finais e operadoresnavegadorAplicativos e integraçõesAPIs públicasNuvem da instituição (AWS ou Azure)Balanceador de carga da nuvemCluster KubernetesGateway Cilium (TLS passthrough)matls-api · matls-authGateway Cilium (termina TLS)api · auth · admin · docs · grafanaKong reguladoexige certificadoKong de APIsem certificado de clienteKeycloaklogin e consentimentoPower Admine portal de APIServiços da plataformabanking · insurance · data-public · powerNATS JetStreameventos internosSub-redes privadasPostgreSQL gerenciadosem acesso públicoRedis gerenciadosem acesso públicocertificadorepassado

Entrada ​

  • Balanceador de carga da nuvem. Recebe o tráfego da internet e o entrega aos Gateways do Cilium dentro do cluster.
  • Gateway em modo passthrough (matls-api., matls-auth.). Não abre o TLS: roteia pelo nome do host e entrega a conexão cifrada ao Kong regulado. Assim, o certificado de cliente chega intacto ao ponto que o valida.
  • Gateway que termina TLS (api., auth., admin., docs. e grafana.). Usa certificados públicos emitidos e renovados automaticamente pelo cert-manager. Em api., a instituição pode usar um certificado próprio. O host grafana. só existe quando o Grafana da instalação está ligado.
  • Em docs., os caminhos /data-public/public e /data-public/open-banking vão ao Kong de API, para o playground dos dados abertos.
  • Numa instalação sem Open Finance e sem Open Insurance, não há hosts matls-. Nesse caso, api. passa pelo gateway em modo passthrough, e o Kong de API pede certificado de cliente opcional.

Tráfego regulado ​

  • O Kong regulado atende matls-api. e matls-auth. e exige certificado de cliente, validado contra a cadeia ICP-Brasil informada pela instituição, só com TLS 1.2 e as cifras do perfil FAPI.
  • O Kong repassa o certificado ao serviço, que confere de novo a cadeia ICP-Brasil e compara o certificado com o vínculo do token de acesso.
  • Registro dinâmico, PAR e troca de código por token passam pela camada FAPI da plataforma antes de chegar ao Keycloak.

Tráfego público e administrativo ​

  • O Kong de API atende api., com limites de requisição e identificador de correlação. Ele não pede certificado de cliente: o TLS de api. termina no gateway.
  • O Keycloak recebe em auth. só os caminhos necessários ao login e ao consentimento; o realm master, de administração do próprio Keycloak, não é exposto.
  • O Power Admin e o portal de API da instalação ficam em admin. e docs..

Rede interna e dados ​

  • A rede do cluster nega todo tráfego por padrão. Cada fluxo permitido é declarado: por exemplo, o Keycloak só aceita conexões dos gateways e dos serviços que precisam dele.
  • As chamadas de saída para outros participantes saem direto dos serviços, com mTLS, e só para destinos autorizados.
  • O PostgreSQL e o Redis gerenciados ficam em sub-redes privadas, sem acesso público. O NATS JetStream roda dentro do cluster.

Finnest Power — plataforma Open Finance Brasil e Open Insurance Brasil. Contato: oi@finnest.com.br