Aparência
Componentes da implantação
Uma implantação do Finnest Power tem a mesma forma na AWS e na Azure: um cluster Kubernetes com os gateways, o servidor de autorização e os serviços da plataforma, apoiado por serviços gerenciados da nuvem.
Responsabilidades
| Componente | Responsabilidade |
|---|---|
| Gateway regulado (Kong) | Recebe o tráfego das APIs reguladas, exige certificado de cliente e valida a cadeia ICP-Brasil. |
| Gateway de API (Kong) | Recebe o tráfego público e administrativo, com rate limit, CORS e identificador de correlação. |
| Keycloak | Servidor de autorização com o perfil FAPI-BR: PAR, PKCE, PS256, ID token criptografado e tokens vinculados ao certificado. |
| Serviços da plataforma | APIs do Open Finance (banking), do Open Insurance (insurance), dados abertos (data-public) e administração (power). |
| Power Admin | Console web do operador em admin.<domínio>, servido direto pelo Gateway: início e indicadores, onboarding, conformidade e drift regulatório, DCR, testes de endpoint, relatórios regulatórios (PCM e Relatório do Diretor), receptora, monitoramento e operações, área do desenvolvedor e usuários. |
| NATS JetStream e event-runtime | O NATS entrega os eventos publicados a partir do outbox transacional. O event-runtime é opcional e vem desligado. Ele encerra a sessão do cliente quando um consentimento do Open Finance deixa de estar autorizado. Ele só consome e envia os eventos da PCM do Open Finance quando a captura grava no outbox, um caminho opcional. No caminho padrão, tarefas agendadas enviam a PCM, do Open Finance e do Open Insurance. |
| Gateway do MOP | Cliente oficial do MOP do Open Insurance, com o RabbitMQ dele. Roda em toda instalação que serve o Open Insurance: reporta as chamadas que a participante faz como receptora e as que atende como transmissora. Vem ligado; o operador só o desliga informando o motivo. Em produção, tem duas réplicas. |
| PostgreSQL gerenciado | Guarda dados de negócio, consentimentos, auditoria e outbox. Backup e recuperação ficam com o provedor. |
| Redis gerenciado | Limites de requisição do Gateway, tokens de registro do DCR e proteção contra replay de request objects. |
| Cofre de segredos | Guarda credenciais, certificados e chaves ICP-Brasil. O External Secrets Operator sincroniza com o cluster. |
Serviços de apoio no cluster
- Cilium: rede do cluster, com tráfego negado por padrão, e Gateway de entrada.
- cert-manager: certificados TLS públicos dos hosts da instituição.
- External Secrets Operator: sincroniza os segredos do cofre da nuvem.
- Kyverno: políticas de admissão, como limites de recursos e bloqueio de exposição direta.
- KEDA: escala sob demanda, incluindo desligar serviços ociosos no sandbox.
- external-dns: publica os registros DNS dos hosts da implantação.
- Operador do Keycloak: instala e mantém o Keycloak da implantação.
- Observabilidade: o Grafana Alloy coleta traces, métricas e logs dos serviços.
- Portal de API da instalação (opcional): referência interativa das APIs em
docs.<domínio>. Veja Portal de API da instalação.
No perfil padrão, a telemetria fica na instalação: o Grafana Alloy grava no Grafana Mimir, Loki e Tempo, dentro do cluster, e o Grafana fica em grafana.<domínio>. Para desligar só o Grafana, use grafana_enabled = false. Para enviar a telemetria ao backend da instituição, por OTLP, declare FINNEST_OTLP_EXPORT_ENDPOINT. Nesse caso, a instalação não guarda a telemetria e não instala o Grafana. Veja Grafana.