/api/v1/siloc. A superfície ativa cobre conectividade e administração. Um descritor de conexão MQ do SILOC completo ativa o processamento SFN de entrada, que despacha os códigos de mensagem aceitos. O serviço também mantém os registros de participante, certificado e cobertura que dão suporte a esse trabalho.
Ciclo de vida da conexão de gateway
Quando um descritor de conexão MQ do SILOC completo ativa o processamento SFN de entrada, o serviço abre e mantém uma conexão de gateway de mensageria com o SILOC da Nuclea pela rede do sistema financeiro nacional. Quatro proteções protegem a conexão:
- um circuit breaker que abre após falhas repetidas,
- reconexão automática com backoff limitado,
- uma parada por credencial desabilitada que interrompe o gateway após uma revogação de certificado, e
- uma sonda de readiness que informa a conexão e a saúde do gateway.
MQ_HOST, MQ_CHANNEL, MQ_QUEUE_MANAGER, MQ_SEND_QUEUE ou MQ_RECEIVE_QUEUE aciona a validação do descritor completo na inicialização. Fornecer apenas parte do descritor falha de forma fechada e impede o serviço de iniciar. Com o descritor completo configurado, o serviço descriptografa e decodifica as mensagens de entrada a partir do envelope regulado antes de despachar uma mensagem aceita.
Despacho SFN de entrada
Após a decodificação, a ingestão seleciona uma rota a partir de uma política fechada (
CodProdt, CodMsg). Os mesmos três códigos de funding têm destinos diferentes por produto:
| Código | OT | SLC |
| --- | --- |
| PAG0102 | Adiamento durável de abertura de período | Repasse ao Lerian SLC |
| LDL0021 | Adiamento durável de instrução de depósito | Repasse ao Lerian SLC |
| PAG0103 | Adiamento durável de encerramento de período | Repasse ao Lerian SLC |
| PAG0101 | Adiamento durável de status de participante | Adiamento durável de status de participante |
O serviço não aceita LDL0020, LDL0006 nem nenhum outro par produto/código. Eles falham de forma fechada para uma exceção de operador. O serviço nunca os repassa como funding de liquidação. Um envelope não decodificável ou uma mensagem com BCMSG.NUOp em branco segue o mesmo caminho de falha fechada.
Despacho pelo menos uma vez com deduplicação durável
A origem pode reenviar uma mensagem, então o repasse ao SLC é pelo menos uma vez. Para um frame de funding do SLC decodificado com sucesso e com
BCMSG.NUOp não em branco, o serviço verifica a deduplicação durável por BCMSG.NUOp antes do repasse. A política trata esse número de operação como globalmente único. O serviço não usa uma chave baseada apenas no ID da mensagem.
O serviço grava o registro de mensagem processada apenas após um repasse bem-sucedido e antes de confirmar o recebimento à origem. Ele não cria esse registro para uma mensagem não decodificada ou não aceita. Uma falha antes da gravação desse registro pode deixar a mensagem elegível para outra entrega. Não trate esse comportamento como uma garantia incondicional de exatamente uma vez de ponta a ponta.
Resultados de falha
- Uma falha de despacho sujeita a nova tentativa permanece sem confirmação. Com commits de origem seguros por offset, o serviço lê a mensagem novamente após um reinício, a partir do último offset confirmado. Uma falha transitória persistente pode travar sua partição até o reinício.
- Uma falha não sujeita a nova tentativa, como um envelope malformado ou um par (
CodProdt,CodMsg) não aceito, falha de forma fechada para uma exceção de operador durável. O serviço confirma a mensagem apenas após o commit desse registro de exceção, para que a partição possa avançar. - O registro de mensagem processada protege apenas as mensagens decodificadas com sucesso e aceitas descritas acima. Ele não garante a retenção de todo frame nem efeitos de exatamente uma vez em todo sistema downstream.
Observabilidade da ingestão
- Listar mensagens processadas: o feed de auditoria das mensagens SFN aceitas que o serviço despachou.
- Ler status da ingestão: o estado de saúde atual do caminho de ingestão habilitado, além do timestamp do último despacho.
Diretório de participantes
O Lerian SILOC mantém um diretório dos participantes do SILOC para os quais ele liquida. Você registra, lista, consulta e atualiza um participante, e lê o status de um participante. Cada participante carrega seu ISPB, seu papel e seu status operacional. Todo registro gera uma entrada no histórico de status e emite um fato de participante. As gravações de registro são idempotentes por meio de uma chave de idempotência, então um registro repetido não cria uma duplicata.
O status operacional usa o domínio de sete valores de status do SILOC:
Certificados regulados
O serviço mantém os certificados regulados da conexão como referências, não como segredos. Você registra um certificado público junto com uma referência de custódia externa. O serviço extrai do certificado seu assunto, número de série e janela de validade, e não armazena nenhuma chave privada. Você então lista, consulta e revoga certificados pela mesma superfície.
Cobertura de capacidades
Uma listagem de capacidades somente leitura descreve as capacidades de cobertura de liquidação como uma superfície de transparência. Para cada tipo de mensagem, ela informa a direção, o estado de implementação e a disposição.