DIRECTORY / PRIMEIRO PROJETO
O Directory centraliza o cadastro das instituições, verifica etapas da integração e publica os participantes ativos em uma API comum. Quem opera o ecossistema acompanha a entrada das instituições; quem integra encontra uma referência compartilhada para estabelecer conexões.
A aplicação está disponível para conhecer o projeto. A equipe de manutenção está em formação. A adoção em um ambiente real exige avaliar a documentação, a configuração de segurança e os requisitos do seu ecossistema.
01 / O PROBLEMA
Quando várias organizações precisam integrar seus sistemas, cada conexão exige identificar os participantes, localizar seus serviços e verificar informações técnicas. Sem uma referência comum, esses dados ficam dispersos e as verificações se repetem. O Directory reúne esse cadastro e acompanha a ativação dos participantes.
Bancos e fintechs precisam encontrar as instituições participantes e seus dados de integração. Quem opera o ecossistema usa o Directory para acompanhar cadastros e etapas de ativação. Os sistemas das instituições consultam a API pública para encontrar os participantes ativos, reduzindo cadastros dispersos e verificações repetidas.
Instituições registram seus dados e confirmam o e-mail. O cadastro permanece pendente até concluir as verificações de ativação.
O fluxo de ativação testa o registro dinâmico de clientes (DCR) com mTLS e consulta as chaves públicas no endereço JWKS informado.
A API pública de participantes apresenta as instituições ativas para consulta e integração com outros sistemas.
02 / RECURSOS DO PROJETO
Contas com perfis de administrador e visualizador permitem organizar o acesso de diferentes pessoas à mesma instituição.
Especificação OpenAPI e documentação dos endpoints ajudam a entender os contratos da API e os fluxos de integração.
O núcleo trabalha com certificados, assinaturas JWS e proteção das chaves privadas armazenadas. As políticas de confiança dependem da configuração do ambiente.
Tipos de instituições, papéis e famílias de APIs podem ser ajustados para diferentes contextos Open X.
Passkeys com WebAuthn e vinculação de tokens a certificados estão previstas no projeto e exigem configuração específica. A obrigatoriedade de mTLS depende da política adotada.
Métricas Prometheus e integração opcional com OpenTelemetry apoiam a operação. Endpoints de métricas e a confiança no proxy precisam de controle de acesso adequado.
03 / QUEM CUIDA
A INBOX coordena o projeto e a formação das parcerias. Queremos construir uma manutenção contínua, com compromissos claros e responsáveis identificados.
Articulação da iniciativa, relacionamento com parceiros e organização da continuidade do projeto.
Os responsáveis por revisão de código, versões e correções serão identificados conforme assumirem essas funções.
Buscamos apoio recorrente em desenvolvimento Go, testes de interoperabilidade, documentação e infraestrutura. Escopo, contatos e período de participação serão combinados antes da divulgação de cada parceria.
04 / LIBERDADE E ACESSO
O Directory utiliza a licença MIT. A entrega inicial do código acontece mediante solicitação e conversa com a INBOX. Quem recebe o código mantém os direitos de usar, modificar e redistribuir, inclusive comercialmente, conforme os termos da licença.
05 / PRÓXIMOS PASSOS