> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração de streaming de eventos e contratos de saída do STA

> Orientação corrigida de configuração, de catálogo e de saídas de trilho nativo para Lender, Streaming Hub e STA.

<Badge stroke icon="calendar-days" iconType="regular">25 de agosto de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Correção da documentação</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Ação necessária</Badge>

## Afeta

***

Equipes que configuram a entrega de eventos do Lender ou do Streaming Hub, que buscam manifestos do Consignado ou que operam transferências de arquivos do STA.

## O que mudou

***

`STREAMING_TLS_CA_CERT` no Lender deve conter um certificado PEM codificado em base64. Base64 inválido ou conteúdo decodificado que não seja PEM impede a inicialização.

As aplicações baseadas em Kafka que usam o runtime atual de streaming de eventos tentam criar seus tópicos de fato e de dead-letter no Kafka durante a inicialização. Esse comportamento vem habilitado por padrão e usa os padrões do broker para a contagem de partições e o fator de replicação. Uma ACL `CREATE` ausente ou um erro do broker gera um aviso, mas não impede a inicialização. Se a sua plataforma provisiona tópicos por infraestrutura como código, defina `STREAMING_TOPIC_AUTO_PROVISION=false`. Use `STREAMING_TOPIC_PARTITIONS` e `STREAMING_TOPIC_REPLICATION_FACTOR` apenas quando a aplicação, e não o broker, precisar escolher esses valores.

O Consignado expõe seu manifesto de streaming em `GET /v1/streaming/manifest`. Em deploys BYOC do Streaming Hub, `STREAMING_HUB_MANIFEST_SOURCES` descobre os manifestos dos produtores; as credenciais opcionais de manifesto devem ser definidas em par. A correspondência no catálogo usa `<resourceType>.<eventType>`, enquanto `topic` é o tópico da aplicação produtora.

As orientações de SILOC e de STA agora distinguem os estados de processamento local das saídas externas. Em particular, uma resposta out-of-band do STA fica registrada no histórico de auditoria local, mas não emite um evento de saída externo.

Isso corrige a documentação de contratos implementados. Não anuncia um release de runtime.

## Impacto

***

**Classificação: Ação necessária.** Valores PEM crus, o caminho anterior do manifesto do Consignado, a correspondência de catálogo baseada em tópicos ou a falta de provisionamento de tópicos podem fazer integrações falharem ou resolver a identidade de evento errada.

## O que você precisa fazer

***

<Steps>
  <Step>Codifique o valor PEM em base64 antes de definir `STREAMING_TLS_CA_CERT` no Lender.</Step>
  <Step>Conceda ao principal da aplicação o `CREATE` para seus tópicos de fato e de dead-letter no Kafka, ou provisione-os antes e defina `STREAMING_TOPIC_AUTO_PROVISION=false`.</Step>
  <Step>Atualize a descoberta de manifesto do Consignado para `GET /v1/streaming/manifest` e verifique as fontes de manifesto e os pares de credenciais do Streaming Hub.</Step>
  <Step>Faça a correspondência dos eventos do catálogo por `resourceType` e `eventType`, e não pelo tópico compartilhado do produtor.</Step>
  <Step>Mantenha as respostas out-of-band do STA como saídas de auditoria local; não as trate como eventos de aceitação ou de rejeição do BACEN.</Step>
</Steps>

### Prazo

Revise antes do próximo deploy de integração de streaming de eventos ou do STA.