Aparência
Guia OFB da participante: instalação só Open Finance na AWS
Este guia leva a participante do zero a uma instalação do Finnest Power que atende só o Open Finance Brasil (receptora de dados e iniciadora de Pix), numa conta AWS dela, usando apenas a CLI finnest. Ele cobre os pré-requisitos no Diretório, a configuração, o material regulado, o deploy, a verificação, o Power Admin, o Grafana, a primeira jornada pela coleção Bruno e a desinstalação.
Os detalhes de cada etapa estão nos guias de referência: Deploy na AWS ou Azure, Rotação de certificados, Primeiros passos: receptora, Acesso por aplicação e Coleção Bruno.
1. Pré-requisitos no Diretório
Antes de instalar, a participante precisa ter no Diretório do Open Finance Brasil do ambiente (sandbox ou produção):
- [ ] a organização cadastrada, com o id dela (UUID);
- [ ] o certificado de transporte BRCAC (ICP-Brasil, uso clientAuth), com a chave, para o mTLS com as transmissoras e com o Diretório;
- [ ] o certificado BRSEAL, cuja chave assina os objetos da receptora e cuja parte pública o Diretório publica para o software;
- [ ] um software statement com os papéis DADOS (receptora) e PAGTO (iniciadora), e o
client_iddesse software no Diretório; - [ ] no software statement, em
software_redirect_uris, as callbacks de todos os apps que vão abrir consentimentos. A plataforma registra a receptora em cada transmissora com essa lista e recusa, com400 REDIRECT_URI_NOT_REGISTEREDe sem chamar a transmissora, todo consentimento cujoredirectUrinão esteja nela. As callbacks públicas da plataforma são:https://api.<domínio>/banking-receiver/consents/v1/callback/fragment(dados);https://api.<domínio>/banking-initiator/payments/v1/callback/fragment(Pix).
Para o certificado TLS do gateway regulado da instalação (o BRCAC servido em matls-auth.<domínio> e matls-api.<domínio>), veja os requisitos em Material regulado.
2. Uma instalação por conta AWS e ambiente
A identidade da instalação (cluster EKS, banco, chaves, papéis IAM e o nome das stacks) é derivada da nuvem e do ambiente. Por isso cabe uma instalação por conta AWS e por ambiente: use uma conta para o sandbox e outra (ou a mesma, com --environment=prod) para produção, nunca duas instalações sandbox na mesma conta.
finnest doctor --all confere isso: se a conta já tem um cluster com a identidade do alvo que o estado configurado não gerencia, ele falha com TARGET_IDENTITY_TAKEN antes de qualquer mudança.
3. Permissões na AWS e acesso ao EKS
Rode a CLI com uma sessão da AWS CLI na conta de destino (aws sts get-caller-identity). O principal precisa criar e gerenciar os recursos que o programa de plataforma cria: VPC e rede (EC2), EKS e Auto Scaling, IAM (papéis, políticas, o provedor OIDC do cluster e o provedor OIDC do GitHub que o bootstrap do estado cria ou reaproveita), KMS, S3 (o estado e os buckets da plataforma), SSM Parameter Store (os metadados do estado), Secrets Manager, RDS (Aurora PostgreSQL), ElastiCache, Route 53, balanceadores de carga, CloudWatch, SNS, SQS, Lambda, EventBridge Scheduler, CodeBuild, Budgets, Cost Explorer e CUR, além de ler as imagens no ECR (seção 6). A plataforma ainda não publica uma política IAM pronta com as ações exatas: até lá, monte a política da equipe de nuvem a partir dessa lista, ou use no sandbox um perfil administrativo da conta e restrinja depois.
O deploy anexa aos nós do EKS a política gerenciada AmazonEC2ContainerRegistryReadOnly, com que eles baixam as imagens do ECR.
Acesso à API do EKS. Por padrão, a CLI descobre o IP público da estação que roda o deploy e libera só esse /32 no endpoint público da API do cluster; o acesso privado continua ligado. Há duas alternativas:
- liberar faixas próprias:
FINNEST_AWS_API_SERVER_PUBLIC_ACCESS_CIDRS="203.0.113.10/32,198.51.100.0/28"(faixas/0são recusadas); - endpoint só privado, para quem roda a CLI de dentro da VPC (por exemplo, num bastion):
FINNEST_AWS_API_SERVER_ACCESS_MODE=private.
4. Configuração: finnest.toml
Instale a CLI na versão que a Finnest indicar para a sua instalação; veja Instalar a CLI. Num diretório próprio da instalação, o finnest.toml declara o alvo e liga só o Open Finance:
toml
[profile.aws-sandbox]
cloud = "aws"
environment = "sandbox"
region = "sa-east-1"
domain = "<domínio da instalação>"
cost_alert_emails = "<e-mail da equipe>"
[opin]
opin_enabled = false
ofb_enabled = true
ofb_org_id = "<id da organização no Diretório OFB>"
ofb_egress_fqdns = ["<host de autorização da transmissora>", "<host de APIs da transmissora>"]opin_enabled = falsedesliga o Open Insurance: o serviço de seguros, as rotas e o realmfinnest-opinnão são implantados, e o material OPIN não é exigido. Ele exigeofb_enabled = truee recusaparticipant_role, que é o papel do Open Insurance.- Uma instalação que já atende o Open Insurance não pode passar a só OFB: instale de novo.
- O domínio precisa ser delegável: com a zona pai no Cloudflare, informe
cloudflare_parent_zone; em outro provedor, crie na zona pai os registros NS da zona da instalação.
Egress das transmissoras. A política de rede já libera o Diretório do ambiente. Os hosts de cada transmissora vão em ofb_egress_fqdns. Para os servidores de autorização Mock Bank (c8f0bf49-4744-4933-8960-7add6e590841) e Mockbank (5843b74b-780e-496a-91eb-62221d4b2fcc) do sandbox, a descoberta OpenID e a lista pública de participantes do Diretório sandbox mostram estes hosts (conferidos em 13/11/2026):
| Host | Uso |
|---|---|
auth.mockbank.poc.raidiam.io | emissor, autorização e JWKS |
matls-auth.mockbank.poc.raidiam.io | PAR, token e registro DCR (mTLS) |
matls-api.mockbank.poc.raidiam.io | APIs de dados e de pagamento (mTLS) |
api.mockbank.poc.raidiam.io | APIs abertas que a lista de participantes também anuncia |
O servidor Mock Bank - Sandbox (7844e311-aa1f-4f67-9475-cbd989310b3e) usa outros hosts, em *.mockbank.openbankingbrasil.org.br (por exemplo auth.mockbank.openbankingbrasil.org.br); confira-os na descoberta dele.
Fontes: https://auth.mockbank.poc.raidiam.io/.well-known/openid-configuration e https://data.sandbox.directory.openbankingbrasil.org.br/participants. Os hosts mudam por transmissora e podem mudar com o tempo: antes de cada deploy, confira no Diretório sandbox os servidores de autorização das transmissoras que a participante vai usar.
Commit do configuration workspace. O deploy só aceita uma configuração que passou pelo commit do configuration workspace. Um finnest.toml escrito à mão precisa desse passo; finnest doctor aponta a falta (workspace-receipt) e o deploy recusa com RUNTIME_WORKSPACE_RECEIPT_INVALID:
bash
finnest config workspace open --goal=apply --json
finnest config workspace review <workspace> <revisão>
finnest config workspace commit <workspace> <revisão> reviewUse a revisão que cada resposta devolve. Se a resposta listar avisos, reconheça cada um com finnest config workspace acknowledge <workspace> <revisão> <requirement-id> antes do review. Toda mudança posterior no finnest.toml pede um novo commit.
5. Material regulado
Numa instalação só OFB, o doctor e o deploy exigem cinco itens de base e o material da receptora. Grave cada um com finnest secrets write (--file, --pair-file para certificado e chave, ou --stdin para um valor), ou pelo configuration workspace.
| Item | Conteúdo |
|---|---|
icp-brasil-roots-pem | Raízes ICP-Brasil, contra as quais o banking valida as transmissoras |
icp-brasil-intermediates-pem | Intermediárias ICP-Brasil, para a mesma validação |
icp-brasil-ca-crt | Cadeia ICP-Brasil do mTLS de entrada (gateway e Keycloak) |
brcac-tls-cert-pem, brcac-tls-key-pem | Certificado e chave do gateway regulado (matls-auth. e matls-api.) |
O material da receptora e da iniciadora é tudo ou nada: gravado um item, os demais passam a ser exigidos.
| Item | Conteúdo |
|---|---|
ofb-receiver-state-secret | Assina o state do redirecionamento; ao menos 32 caracteres |
ofb-receiver-secret-key-base64 | Chave AES-256 que cifra os segredos das conexões; 32 bytes em base64 |
ofb-directory-client-id | O client_id do software da participante no Diretório |
ofb-software-statement-id | O UUID do software statement (papéis DADOS e PAGTO) |
ofb-receiver-jwks-json | JWKS público: uma chave sig/PS256 e uma enc/RSA-OAEP |
ofb-receiver-jws-private-jwk-json, ofb-receiver-jwe-private-jwk-json | As chaves privadas de assinatura e de cifra que o JWKS publica |
ofb-receiver-client-cert-pem, ofb-receiver-client-key-pem | O certificado de transporte BRCAC (folha e ACs) e a chave |
Exemplo:
bash
finnest secrets write brcac-tls-cert-pem --file ./gateway.crt --pair-file ./gateway.key --yes
finnest secrets write ofb-receiver-client-cert-pem --file ./brcac.crt --pair-file ./brcac.key --yes
finnest secrets write ofb-directory-client-id --stdin --yes <<< '<client_id do software>'
finnest secrets listNão existe client_id de transmissora para gravar: a plataforma se registra sozinha em cada uma (seção 10). O deploy publica o material no Secrets Manager da conta.
Segredo do cliente de smoke. Com o material da receptora gravado, o doctor e o deploy exigem também ofb-smoke-client-secret (FINNEST_OFB_SMOKE_CLIENT_SECRET), o segredo do cliente finnest-ofb-smoke do realm finnest-ofb, com que os comandos da seção 8 obtêm o token. Ninguém o emite: a CLI gera o valor (32 bytes aleatórios) ao gravar o item sem fonte, e um valor já gravado nunca é trocado.
bash
finnest secrets write ofb-smoke-client-secret --yesO deploy publica o valor (OFB_SMOKE_CLIENT_SECRET) num alvo próprio, o Secret finnest-ofb-smoke-client (chave clientSecret), que só o Job de bootstrap do Keycloak lê para configurar o cliente. O cliente só tem conta de serviço e pede apenas os escopos de aplicação ofb:receiver:consents, ofb:receiver:customers, ofb:receiver:accounts, ofb:receiver:credit-cards e ofb:initiator:payments; ele não alcança as rotas reguladas nem as de operação.
6. Acesso às imagens
Registro de distribuição (recomendado). Informe à Finnest o id da conta AWS (aws sts get-caller-identity) e peça a liberação dela no registro de distribuição. Com a liberação confirmada, aponte o finnest.toml para o registro informado pela Finnest:
toml
[images]
registry = "<registro informado pela Finnest>"finnest doctor lê, com as credenciais da conta, cada imagem da versão da CLI. Enquanto a conta não estiver liberada, a verificação image-registry falha e mostra o id da conta a liberar. Nenhum token é criado no cluster.
Alternativa: token de leitura. Se a participante preferir, a Finnest fornece um usuário e um token somente leitura do registro de imagens; grave-os como descrito em Acesso às imagens. A desinstalação não revoga o token: depois dela, peça à Finnest que o revogue (seção 12).
7. Deploy
bash
finnest doctor --all
finnest bootstrap --yes
finnest deploy --preview
finnest deploy --apply --yesdoctorconfere credenciais, permissões, identidade do alvo, DNS, imagens, material e o commit do workspace. Resolva cadafailantes de seguir.bootstrap --yescria, só na primeira instalação, o armazenamento do estado da instalação na conta: o bucket S3, a chave KMS e o papel que o deploy usa. Odeploy --previewlê o estado desse armazenamento e não o cria; sem ele, o preview para e indica este comando.deploy --previewmostra o plano sem alterar nada, com a estimativa de custo.deploy --apply --yesaplica. As migrações e a configuração do Keycloak rodam sozinhas. No fim, o deploy roda os testes de fumaça.
Todos os comandos aceitam --non-interactive para pipelines. O andamento e as etapas estão em Onde o deploy parou.
8. Verificar a instalação
bash
finnest smoke
finnest health --suite=post-deploy
finnest status- O
smokede uma instalação só OFB confere que a receptora (/banking/banking-receiver/consents/v1/consents) e a iniciadora (/banking/banking-initiator/payments/v1/consents) respondem401sem token, e que a descoberta do realmfinnest-ofbemauth.<domínio>responde200. - O
healthfaz as mesmas sondas e confere o Grafana. As sondas do Open Insurance aparecem como não aplicáveis (skipped), sem falhar. - O
statusmostra o estado do alvo, os endereços e onde ler a senha do Grafana.
Smoke da receptora e da iniciadora
finnest ofb receiver smoke e finnest ofb initiator smoke percorrem a jornada da receptora e da iniciadora do alvo selecionado, em três modos:
| Modo | O que faz |
|---|---|
| Sem flag (plano) | Mostra cada passo como planned. Nenhuma requisição sai da máquina; exit 0 |
--live | Só leituras (GET): a lista de participantes do Diretório do ecossistema do alvo, o discovery do realm finnest-ofb, a página de callback e, com --transmitter, o registro de DCR |
--create-connection / --create-payment | A única escrita real, para um titular cujo CPF chega só por --stdin. Exige --live, --transmitter, --stdin e --yes; nunca roda em CI |
bash
finnest ofb receiver smoke --cloud=aws --environment=sandbox
finnest ofb receiver smoke --cloud=aws --environment=sandbox --live \
--transmitter <authorisationServerId>No --live, o --transmitter precisa estar na lista do Diretório. O passo dcr lê o registro com o cliente operador de DCR (FINNEST_OFB_DCR_OPERATOR_CLIENT_SECRET, seção 10) e fica skipped sem esse segredo ou sem --transmitter.
Receptora: criar uma conexão. Com o titular de teste da transmissora:
bash
printf '%s' "$HOLDER_CPF" | finnest ofb receiver smoke --cloud=aws --environment=sandbox \
--live --create-connection --stdin --transmitter <authorisationServerId> \
--auth-base http://127.0.0.1:18080 --yesO CPF nunca vai para a linha de comando e nunca aparece na saída, no JSON nem em arquivo. Depois das leituras, o comando pede um token ao cliente finnest-ofb-smoke (seção 5) com os escopos ofb:receiver:* e recusa um token que não traga exatamente esses escopos ofb:. O token vem do realm por um túnel até o Keycloak, como nos comandos de DCR da seção 10 (kubectl port-forward e --auth-base). Em seguida, cria o consentimento na transmissora, mostra o redirectUrl em que o titular autoriza e espera até 10 minutos pelo estado active. Então sincroniza a conexão e lê os cinco recursos: customers, accounts, balances, transactions e credit-cards.
Num alvo de produção (--environment=prod, Diretório de produção), a criação é uma escrita real com um titular real: o --yes continua obrigatório, o comando avisa REAL WRITE no stderr antes do envio e o relatório traz writeKind: "real" ("sandbox" no sandbox, "none" no plano e no --live).
Iniciadora: um Pix de teste. --create-payment só roda num alvo que segue o sandbox do Diretório; em produção é recusado (exit 2) antes de qualquer requisição. Os termos vêm de --payment-file, um JSON com consent (os dados do consentimento de pagamento v5, sem loggedUser, que vem do stdin) e payment (cnpjInitiator, endToEndId e, opcionais, remittanceInformation e transactionIdentification, o TxId do Pix que INIC, QRDN e APDN exigem e MANU e DICT proíbem; os campos seguem o contrato de pagamento Pix v5 e são conferidos antes de qualquer requisição). O endToEndId é gerado pelo iniciador a cada execução, no formato ExxxxxxxxyyyyMMddHHmmkkkkkkkkkkk do contrato de pagamentos v5: xxxxxxxx é o ISPB de quem gera o identificador, e a data e hora (UTC) ficam a no máximo 12 horas do envio; o mesmo identificador não pode ser reenviado ao SPI em outra execução. O valor máximo é R$ 1,00 ("1.00"), em BRL, num pagamento único imediato (date); um consentimento com schedule é recusado (exit 2) antes de qualquer requisição. Exemplo com valores fictícios:
json
{
"consent": {
"creditor": {
"personType": "PESSOA_JURIDICA",
"cpfCnpj": "11222333000181",
"name": "Recebedor de Teste"
},
"payment": {
"type": "PIX",
"purpose": "IMMEDIATE",
"date": "2026-11-19",
"currency": "BRL",
"amount": "1.00",
"details": {
"localInstrument": "DICT",
"proxy": "recebedor@example.test",
"creditorAccount": {
"ispb": "12345678",
"issuer": "0001",
"number": "1234567",
"accountType": "CACC"
}
}
},
"debtorAccount": {
"ispb": "87654321",
"issuer": "0001",
"number": "7654321",
"accountType": "CACC"
}
},
"payment": {
"cnpjInitiator": "11222333000181",
"endToEndId": "E11222333202611191345smokeE2E001",
"remittanceInformation": "smoke finnest"
}
}bash
printf '%s' "$HOLDER_CPF" | finnest ofb initiator smoke --cloud=aws --environment=sandbox \
--live --create-payment --payment-file ./pagamento.json --stdin \
--transmitter <authorisationServerId> --auth-base http://127.0.0.1:18080 --yesO token pede só ofb:initiator:payments. O comando cria o consentimento de pagamento, mostra o redirectUrl, espera até 10 minutos por AUTHORISED (REJECTED é erro), cria o Pix e espera a liquidação: ACSC passa, RJCT e CANC são erro.
Chave de idempotência e retry. Antes de enviar a escrita, o comando mostra no stderr o x-idempotency-key (gerado, ou o de --idempotency-key <uuid>) e o comando exato para repeti-la, que parte do mesmo diretório e da mesma configuração, repete o --auth-base da execução e lê o CPF de novo pelo stdin:
bash
cd '<diretório>' && printf '%s' "$HOLDER_CPF" | finnest ofb receiver smoke --cloud=aws \
--environment=sandbox --live --create-connection --stdin --transmitter '<authorisationServerId>' \
--idempotency-key <uuid> --yesRepetido com o mesmo CPF e a mesma chave, ele reaproveita o consentimento já criado em vez de criar outro; na iniciadora, a chave do Pix deriva dessa chave, então o mesmo pagamento é reaproveitado. Enquanto o registro na transmissora está pendente (409 DCR_PENDING), o comando espera o Retry-After (no máximo 120 s por espera, até 5 tentativas) e reenvia com a mesma chave. Um desfecho incerto depois do envio (falha de transporte, 408, 429 ou 5xx) termina como unconfirmed (exit 5), com o comando de retry no relatório. O mesmo vale depois de uma escrita aceita, quando a leitura que acompanha o consentimento ou o pagamento não decide o desfecho (leitura perdida, recusada, ilegível, sobre outro recurso, ou o prazo de 10 minutos): só RJCT, CANC, REJECTED, error e revoked falham. Um cancelamento depois do envio termina com exit 7. Nos dois casos, repita com o comando mostrado: uma chave nova poderia escrever duas vezes.
Relatório. Cada passo (directory, discovery, callback, dcr, token, consent, authorisation, sync na receptora ou payment na iniciadora) e cada recurso tem uma linha com status, HTTP e x-fapi-interaction-id, que localiza a chamada na trilha. --json traz o mesmo relatório (action, mode, cliVersion, target, environment, directoryEcosystem, writeKind, transmitter, retryCommand, steps, resources, verdict).
| Status do recurso | Significado |
|---|---|
ok | A transmissora respondeu com dados |
no-data | Respondeu sem dados, ou não há o recurso de que ele depende (sem conta, não há saldo nem transações; sem cartão, não há credit-cards) |
error | Resposta não 2xx, coleta com erro ou ainda pendente no prazo, resposta ilegível, falha de transporte ou token recusado |
skipped | Fora do modo (plano e --live) ou depois de um passo que falhou |
| Veredito | Exit |
|---|---|
ok | 0 |
ok-no-data | 0: a massa de teste da transmissora não tem algum recurso; não é falha |
error | 2 (configuração ou requisição), 3 (credencial recusada) ou 5 (rede ou plataforma) |
unconfirmed | 5; repita com o comando de retry e a mesma chave |
| Cancelado | 7 |
9. Power Admin e Grafana
Usuário administrador. Crie o primeiro proprietário do Admin:
bash
finnest admin owner create --email=<e-mail> --name="<nome>"A senha temporária aparece uma única vez (ou vai para --password-file fora de um terminal) e é trocada no primeiro acesso, em https://admin.<domínio>. Os detalhes estão em Primeiro proprietário.
Numa instalação só OFB, o menu não mostra as telas do Open Insurance (Receptora, Monitoramento e Aplicações), e um link direto para elas mostra "Esta tela não é atendida nesta instalação."
A tela DCR lista os registros da receptora em cada transmissora, com o filtro só nos ecossistemas que a instalação atende. Até a primeira autorização com uma transmissora, aparece a identidade do software no Diretório. O Power lê esses registros com um token client credentials do seu cliente finnest-power-ofb-admin (escopo ofb:dcr:read) no realm finnest-ofb, cujo segredo chega ao Power em POWER_OFB_ADMIN_CLIENT_SECRET. Esse segredo é da Finnest, e o finnest secrets write o gera junto com o material da receptora OFB.
O token interno FINNEST_PCM_INTERNAL_TOKEN continua servindo às telas de PCM, KPI e conexões da receptora. Se uma delas avisar que ele falta, refaça finnest deploy --apply --yes: a CLI gera esse token e o entrega ao banking e ao Power. Para fixar um valor próprio, defina FINNEST_PCM_INTERNAL_TOKEN (ou FINNEST_PCM_INTERNAL_TOKEN_FILE) no ambiente do deploy.
Grafana. Sem destino de telemetria externo, a instalação traz o Grafana em https://grafana.<domínio>, com os painéis da plataforma. Ele vem ligado por padrão; a participante que não quiser o Grafana declara grafana_enabled = false no alvo do finnest.toml.
- A senha do
adminé gerada no primeiro deploy e fica no segredofinnest-grafana-admindo namespacefinnest-power; ofinnest statusmostra o comandokubectlque a lê. - O
adminé a conta de emergência. A senha dela é sempre a do segredo: cada vez que o pod do Grafana é criado (num deploy que muda a senha ou a versão, ou quando o pod é apagado ou muda de nó), um contêiner de inicialização a redefine para a do segredo, e uma troca feita pela interface volta à do segredo na próxima recriação do pod. Para trocá-la, gere a nova senha no arquivo de credencial e rodefinnest deploy. Se a redefinição falhar ou o Grafana não a confirmar, o deploy falha e o Grafana fica indisponível até a causa ser corrigida e um novo deploy rodar. - Ao atualizar para esta versão, uma senha trocada pela interface volta à do segredo no primeiro deploy. Para manter a atual, grave-a no arquivo de credencial (ou em
FINNEST_GRAFANA_ADMIN_PASSWORD) antes de atualizar. - Para dar à Finnest acesso de leitura aos logs e métricas, crie no Grafana um usuário com o papel Viewer e envie o acesso pelo canal que a participante escolher. Para revogar, remova o usuário.
O passo a passo está em Grafana.
10. Primeira jornada pela coleção Bruno
Com uma aplicação criada e o usuário de teste da transmissora em mãos, siga Primeiros passos: receptora. Pela linha de comando, com o relatório JUnit:
bash
npx @usebruno/cli@4.2.1 run receptora/consentimento/criar-consentimento.yml --env sandbox \
--env-var authorisationServerId=<id do servidor no Diretório>
# depois que o cliente final autorizar no redirectUrl:
npx @usebruno/cli@4.2.1 run receptora/consentimento/consultar-consentimento.yml receptora/dados \
--env sandbox --env-var connectionId=<connectionId> --bail \
--reporter-junit ../resultados/bruno.xml --reporter-skip-all-headers --reporter-skip-bodyO fluxo do Pix fica em iniciadora/pagamento-pix. Veja Coleção Bruno.
Registro automático em cada transmissora (DCR). Na primeira autorização com uma transmissora, a plataforma pede um token ao Diretório como o software da participante, obtém o SSA do software statement e se registra no servidor de autorização dela. Cada transmissora tem o próprio registro, e cada conexão e cada Pix usam o client_id do servidor em que foram autorizados.
Enquanto um registro está pendente (por exemplo, quando o POST de registro não respondeu), a criação do consentimento responde
409com o códigoDCR_PENDINGe o cabeçalhoRetry-After. Espere esse tempo e repita. A plataforma reconcilia a tentativa sozinha e nunca envia um segundo registro às cegas.Uma tentativa ambígua bloqueia a transmissora por até 15 minutos e depois expira sozinha. Para liberá-la antes, o operador confirma com a transmissora que ela não criou o cliente (ou que o apagou) e registra essa evidência pela CLI, com o segredo do cliente operador de DCR do Open Finance em
FINNEST_OFB_DCR_OPERATOR_CLIENT_SECRET:bashfinnest dcr registration-status <authorisationServerId> --ecosystem ofb finnest dcr reconcile <authorisationServerId> <attemptId> \ <provider_confirmed_not_created|provider_confirmed_deleted> --ecosystem ofb \ --evidence-reference <protocolo-da-transmissora> --yesO primeiro comando mostra o
attemptIdda tentativa pendente; o segundo grava a evidência, com o cliente operador como autor, e libera a tentativa, e a próxima criação de consentimento registra a plataforma de novo. Uma tentativa que já foi reconciliada, que expirou ou cujoattemptIdnão confere responde409. A tela DCR do Power Admin só mostra o estado; a reconciliação é sempre pela CLI.Uma instalação que serve o Open Finance publica os endpoints de token do realm só em
matls-auth., que exige certificado ICP-Brasil; o hostauth.não tem rota de token, por decisão de segurança. O operador obtém o token por um túnel até o Keycloak (kubectl port-forward) e passa--auth-base http://127.0.0.1:<porta>nos comandos acima; a rota de operações continua no hostapi.. Antes, confira que o discovery do túnel anuncia o issuer público (https://auth.<domínio>/realms/finnest-ofb); o passo a passo está no README da CLI.O token de acesso da transmissora é renovado com o refresh token. Se a transmissora recusar a renovação, a conexão vai para
errorcom o motivoreauthorisation-required, e o cliente final precisa autorizar de novo, num consentimento novo.
11. Rotação de certificado ou de software statement
Trocar o certificado de transporte (ofb-receiver-client-cert-pem) ou o software statement gera um registro novo em cada transmissora. As conexões ativas continuam presas ao registro antigo: a próxima renovação de token delas é recusada, e elas passam a error com reauthorisation-required. Planeje a rotação com a reautorização das conexões ativas. O certificado novo só é usado depois do deploy que o publica. O procedimento está em Rotação de certificados.
12. Desinstalar
bash
finnest destroy --preview
finnest destroy --apply --yes --confirm=aws:<conta>:<ambiente>destroy --apply remove a instalação inclusive os dados. Ele exige --yes e a confirmação do alvo em --confirm (aws:<conta>:<ambiente>). Sem --preview nem --apply, o comando não muda nada e falha com DESTROY_MODE_REQUIRED. Para manter os dados e remover só o processamento, use finnest undeploy --preview e depois finnest undeploy --apply --yes --confirm=aws:<conta>:<ambiente>. O undeploy --apply exige a mesma confirmação do alvo. Depois da desinstalação, peça à Finnest que retire a liberação da conta no registro de distribuição, ou que revogue o token de leitura.