Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

SecureGate IAM

Status do Projeto: 100% Concluído e Homologado (Versão 1.0.0 + Gateway de Borda)
Todas as 13 etapas do Roadmap (Etapas 0 a 12C), 73 ADRs, relatórios técnicos, matriz OWASP ASVS v4.0.3 Nível 2 e suíte completa de testes de governança e CI/CD aprovados no GitHub.

Plataforma de identidade e acesso baseada em Zero Trust, com provisionamento, OAuth/OIDC, políticas contextuais, eventos de segurança e auditoria.

Documentação: índice, implementação passo a passo e subdivisões e plano com critérios de aceite.

Estado atual

Fundação, infraestrutura e API administrativa de Identity/Access implementadas. O core gerencia usuários, credenciais Argon2id, grupos, papéis, permissões e auditoria transacional. Administração fica desabilitada por padrão e exige ativação explícita com token bootstrap temporário. A etapa 3 teve 106 testes no aceite original e está incluída na base publicada até a 5A. Consulte as evidências históricas.

A entrega 4A acrescenta assinatura RS256 via Vault Transit e JWKS; a 4B integra Client Credentials/JDBC. A 4C acrescenta login, clientes web confidenciais e Authorization Code com PKCE S256 e consentimento protegido. A 4D1 implementa refresh opcional com rotação, janela absoluta de 30 minutos, detecção de reuso, introspecção e revogação pelo cliente proprietário. A 4D2 adiciona discovery, ID token Transit e userinfo com claims limitadas aos escopos aprovados. Access tokens e ID tokens duram cinco minutos. Consulte os guias PKCE, refresh e OIDC, com validação registrada nas evidências 4D2.

A 5A acrescenta políticas JSONB versionadas e auditadas e uma avaliação administrativa por papéis atuais. O motor nega por padrão, faz DENY prevalecer e combina exigência de MFA com limites de escopo/TTL. A prévia administrativa permanece separada da aplicação à emissão de tokens da 5D1. Consulte o guia de políticas e as evidências 5A.

A 5B1 adiciona condições ABAC tipadas na gramática v2, risco determinístico de 0–100 e cenários administrativos separados da avaliação normal. Documentos v1 permanecem compatíveis. Consulte o guia ABAC/risco e as evidências 5B1.

A 5B2 coleta contexto de navegador autenticado, rede da conexão, falhas reais de login e sensibilidade administrada de recursos. Aprovação de navegador tem prazo e versão; contextos de outro usuário, antigos ou fechados não fornecem confiança. Há cinco minutos de aquecimento do contador após iniciar o processo. Consulte o guia de coleta e as evidências 5B2.

A 5C1 inicia MFA com TOTP e proteção da semente por uma chave AES-256-GCM separada no Vault Transit, vinculada ao usuário e à inscrição. A 5C2 acrescenta cadastro/ativação em /mfa, recuperação de uso único, limite de tentativas por conta e prova de step-up de cinco minutos vinculada à sessão. Consulte o guia MFA, as evidências 5C2 e a base criptográfica.

A 5D1 exige política para emissão e renovação de tokens de usuário: alvo oauth:<client_id>, ação issue. Sem permissão correspondente, a troca é negada; limites reduzem escopos/TTL e MFA exige prova no sid original. Isso vale também para clientes existentes, sem ALLOW automático. Consulte o guia de políticas na emissão e as evidências 5D1.

A 5D2 integra o desafio MFA à navegação de autorização, antes do consentimento e novamente na aprovação. O retorno exige CSRF, ticket de uso único, prazo e a mesma identidade/sessão; preserva state, nonce e PKCE e revalida a autorização. A 5D3 acrescenta a API Bearer por operação, descrita abaixo. Consulte o guia do desafio MFA e as evidências 5D2.

A 6A1 adiciona o envelope de eventos v1 e a Outbox PostgreSQL: cada nova auditoria produz um evento na mesma transação, com ID/horário compartilhados e rollback conjunto. Os eventos persistidos são a entrada do publicador da 6B. Consulte o guia da Outbox, a ADR-018 e as evidências 6A1.

A 6A2 integra os seis produtores de segurança, preserva a auditoria legada e valida seus dados: tentativa/suspeita de login, mudança de política, bloqueio administrativo, revogação e encerramento de sessão. Access tokens novos de usuário recebem authorization_id estável entre refreshes. Consulte o guia de eventos, a ADR-019 e as evidências 6A2.

A 6B acrescenta publicação opcional no RabbitMQ com mensagens persistentes, confirmação/mandatory return, leases concorrentes e retry na Outbox. Use -EnableOutboxPublisher para ativar. A entrega preserva eventId/payload nas tentativas e cobre falha/recuperação com broker real. Consulte o guia de publicação, a ADR-020 e as evidências 6B.

A 6C acrescenta métricas administrativas de backlog, quarentena com histórico e limpeza opcional de publicações confirmadas. Use -EnableOutboxRetention para ativar a retenção de sete dias; pendências e auditoria são preservadas. Consulte o guia operacional, a ADR-021 e as evidências 6C.

A 7A inicia o policy-enforcer com consumo opcional da fila de revogação, ACK manual após efeito Redis e deduplicação atômica. Projeta jti, família de autorização e sid encerrado, sem reduzir prazos em eventos fora de ordem. A consulta no recurso passa a ser opcional na 7C1, descrita abaixo. Consulte o guia do consumidor, a ADR-022 e as evidências 7A.

A 7B acrescenta a fila de bloqueio/política ao mesmo processo: status e versões exatas de identidade/política, contadores limitados por conta/versão e IP e sinais temporários de risco. Eventos antigos não revertem desbloqueio nem ressuscitam sinais expirados. Consulte o guia de bloqueio/política, a ADR-023 e as evidências 7B.

A 7C1 adiciona -EnableResourceEnforcement: o recurso humano consulta revogação, identidade, bloqueios e versões de política no Redis, preservando verificações locais. Falha de consulta impede acesso com 503; bloqueio temporário usa 429. A 7C2 estende o modo ao login e à emissão/refresh humanos. Consulte o guia, a ADR-024 e as evidências 7C1.

A 7C2 aplica sinais Redis no login e na emissão/refresh, preserva códigos e refresh tokens após recusa transitória e exige prova MFA real diante de risco. Consulte o guia de autenticação, a ADR-025 e as evidências 7C2.

A 7D1 acrescenta o módulo de testes ponta a ponta, executando IAM/enforcer empacotados com infraestrutura descartável. Mede revogação por jti, família após refresh e logout, correlacionando Outbox, Redis e rejeição HTTP. Consulte o guia, a ADR-026 e as evidências 7D1.

A 7D2 valida reinício do enforcer, indisponibilidade do broker/Redis, replay exato, política fora de ordem e bloqueios reais por conta/IP com expiração. Consulte o guia, a ADR-027 e as evidências 7D2.

A 8A1 cria a área de ingestão iam_audit.event_log particionada por mês, recibos globais de deduplicação e manutenção opcional das partições futuras. Preserva a auditoria legada e a Outbox, sem conectar consumidor nesta entrega. Consulte o guia, a ADR-028 e as evidências 8A1.

A 8A2 acrescenta logins/pools dedicados para ingestão e manutenção, provisionamento administrativo separado do Flyway e timeouts. O login de ingestão recebe INSERT/SELECT no log; manutenção só executa uma função limitada. Consulte o guia, a ADR-029 e as evidências 8A2.

A 8B conecta o consumidor opcional de audit.persist ao pool dedicado: JDBC batch atômico, ACK após commit, isolamento de conflitos para DLQ e recuperação por requeue/reconexão. Use -EnableAuditConsumer. Consulte o guia, a ADR-030 e as evidências 8B.

A 8C acrescenta consulta administrativa opcional por cursor estável e filtros exatos, usando transações somente leitura no pool de auditoria. Use -EnableAuditQuery com bootstrap administrativo. A V15 adiciona índices para ator/correlação. Consulte o guia, a ADR-031 e as evidências 8C.

A 8D1 acrescenta arquivamento administrativo de meses antigos no mesmo PostgreSQL, com catálogo imutável, preservação de recibos e tratamento de replays/eventos tardios. Não remove dados nem reduz disco. O script opera em modo de plano por padrão; consulte o guia, a ADR-032 e as evidências 8D1.

A 8D2 adiciona um benchmark optativo de ingestão JDBC e consultas com milhões de eventos sintéticos, planos SQL e contagem de SELECTs por página. Execute Measure-Audit.ps1; consulte o guia, a ADR-033 e as evidências 8D2.

A 9A1 adiciona leitura opcional de segredos KV v2 antes da criação das conexões do IAM, com AppRole, snapshot validado e revogação do token de leitura. Use Start-IamCore.ps1 -EnableVaultKv. Consulte o guia, a ADR-034 e as evidências 9A1.

A 9A2a prepara o grupo PostgreSQL securegate_iam_runtime, sem login e com concessões explícitas, e valida o IAM com uma identidade de execução sem propriedade das tabelas. A V17 permite ao trigger registrar histórico da Outbox sem INSERT direto pelo runtime. O startup padrão ainda usa a conta proprietária. Consulte o guia, a ADR-035 e as evidências.

A 9A2b integra credenciais PostgreSQL temporárias do Vault com -EnableVaultDatabase, AppRole/KV de execução sem senha proprietária e migração em processo separado (Migrate-Database.ps1). A 9A2c acrescenta renovação e troca de gerações. Consulte o guia, a ADR-036 e as evidências.

A 9A2c renova token e lease do pool, valida novas credenciais antes da troca e drena a geração anterior com prazo limitado. Em indisponibilidade, fecha sessões ao vencer o prazo confirmado e pode reconstruir o pool após recuperação do Vault, sem reiniciar. Consulte o guia de renovação, a ADR-037 e as evidências.

A 9B1 adiciona pedidos de acesso privilegiado com escopo dedicado, MFA obrigatório, justificativa, expiração e revogação pelo proprietário, com auditoria/Outbox atômicas. A 9B2 abaixo acrescenta a emissão de credenciais Vault. Consulte o guia, a ADR-038 e as evidências.

A 9B2 emite uma única credencial de diagnóstico por pedido, com escopo/MFA e reautorização, Vault/AppRole e emissor separados, prazo SQL limitado e revogação recuperável. Senhas não são persistidas; sessões abertas podem ultrapassar o TTL durante indisponibilidade do Vault. Consulte o guia, a ADR-039 e as evidências.

A 9C1 acrescenta auditoria de expiração lógica de pedidos/credenciais, correlação de origem e recusas autenticadas com códigos fixos. Expiração observada não é confirmação de revogação pelo Vault. Consulte o guia, a ADR-040 e as evidências.

Decisões aprovadas

  • Java 21, Spring Boot e Spring Authorization Server.
  • Maven com Wrapper e build multimódulo.
  • Vault Transit para assinatura JWT desde a etapa de autenticação.
  • PostgreSQL, Redis e RabbitMQ para dados, estado distribuído e eventos.

Documentação

O roteiro deriva do documento SecureGate IAM – Documentação e Plano de Implementação, versão 0.1, outubro de 2026, disponível em PDF na pasta local do projeto.

Próximo passo

A 9C2a acrescenta V21, retry persistido de limpeza com intervalos de 2–60 s, avanço de outros itens durante falhas e métricas agregadas das pendências/resultados incertos. Consulte o guia de recuperação PAM, a ADR-041 e as evidências 9C2a. O passo a passo documenta a divisão da 9C2.

A 9C2b acrescenta V22, retry persistido e isolamento por item no observador de pedidos, métricas de pendências e teste com reinício real da JVM do IAM após falha de auditoria. Consulte a ADR-042, o runbook e as evidências 9C2b. Prazo e correlação permanecem inalterados; o teste de reinício cobre o observador com fixture SQL e emissão desabilitada.

A 9C3 valida com JARs reais a jornada OAuth/MFA → pedido → credencial Vault → uso PostgreSQL → revogação/expiração → Outbox/RabbitMQ → ingestão dedicada → consulta central. Inclui pausa do Vault/reinício do IAM, indisponibilidade do broker e isolamento das identidades, além da correção do bootstrap OAuth para execução com migração externa/Flyway desabilitado. Consulte o guia integrado, a ADR-043 e as evidências 9C3. V22 continua sendo a migração atual.

A 9A3 permite iniciar o enforcer com Start-PolicyEnforcer.ps1 -EnableConsumer -EnableVaultKv. Obtém credenciais Redis/RabbitMQ por AppRole e KV v2, valida o snapshot completo e revoga o token antes de iniciar os clientes; falhas impedem o startup sem fallback local. Consulte operação, ADR-044 e evidências 9A3. Não há refresh em execução nem nova migração.

A 9D consolida o aceite técnico local da etapa 9, com matriz de controles, testes e riscos residuais; consulte as evidências 9D. Usa os 778 testes do build da 9A3, sem nova execução funcional. A 9A3 está versionada em 6d08c2a.

A 10A1 inicia a etapa de carga com massa sintética de clientes, plano JMeter Client Credentials, sucesso/invalid_client separados e runner que falha quando as asserções não passam. O smoke opt-in usa IAM real e serviços descartáveis; resultados não incluem corpos/tokens/cabeçalhos. Consultar operação, ADR-045 e evidências. Não comprova capacidade ou metas de latência.

A 10A2a acrescenta massa humana sintética e jornada PKCE com cookies, CSRF, state, consentimento, identidade/TTL e recusa de replay. O smoke opt-in prova também que verifier incorreto resulta em HTTP 400 e falha do runner. Consultar operação humana, ADR-046 e evidências. A duração é agregada por jornada, sem comprovar capacidade ou metas.

A 10A2b1 acrescenta plano de falhas de login com senha incorreta e usuário inexistente, mensagem genérica/CSRF/cookies verificados e sessão anônima confirmada. O smoke opt-in prova dois fatos na Outbox e detecta autenticação inesperada ao injetar senha correta. Consultar operação, ADR-047 e evidências. Não comprova tempo constante ou capacidade.

A 10A2b2 acrescenta acesso Bearer ao recurso de conta, recusa de token inválido, revogação e recusa posterior antes da expiração. Reutiliza PKCE/massa humana com opções explícitas; teste isolado confere publicação/projeção e detecta revogação omitida. Consultar operação, ADR-048 e evidências. O ledger local também recusa tokens: este smoke não mede SLA distribuído.

A 10A2b3 acrescenta produção de fatos pela API, consulta central por correlação/tipo, duas páginas com cursor real e recusa sem credencial. O smoke compara envelopes com a Outbox e detecta correlação inexistente. Consultar operação, ADR-049 e evidências. Os planos 10A cobrem os cenários funcionais; medições de capacidade/SLA permanecem pendentes.

A 10B1 acrescenta exportação Prometheus opt-in no IAM, token próprio de leitura por arquivo e histogramas HTTP opcionais. Preserva saúde e administração, sem expor métricas publicamente. Consultar inventário, operação, ADR-050 e evidências.

A 10B2a acrescenta Compose local de Prometheus/Grafana, token de scrape por arquivo, senha própria do Grafana e dashboard IAM de 12 painéis. O smoke usa IAM real, valida expressões/datasource, acesso anônimo negado e falha/recuperação de credencial. Consultar operação, Compose, ADR-051 e evidências.

A 10B2b1 acrescenta listener opcional de métricas do enforcer, token separado, job Prometheus e dashboard de seis painéis. Preserva Spring non-web e modo padrão sem listener. O smoke comprova evento real/projeção/ACK, coleta autenticada e falha de credencial isolada do IAM. Consultar operação, ADR-052 e evidências.

A 10B2b2a acrescenta coleta opcional RabbitMQ com plugin nativo, porta loopback, métricas agregadas, script de migração com backup e dashboard de seis painéis. O smoke usa mensagens AMQP reais e verifica ready/unacked/ACK e pausa/recuperação do scrape. Consultar operação, ADR-053 e evidências.

A 10B2b2b acrescenta login de monitoração PostgreSQL, exporter opcional com senha por arquivo e imagem fixada por digest, coleta de estatísticas e dashboard de seis painéis. Smoke verifica ACLs reais e falha de credencial SQL com scrape HTTP disponível, seguida de recuperação. Consultar operação, ADR-054 e evidências.

A 10B2b2c acrescenta ACL própria Redis sem acesso a chaves/valores, exporter opcional com senha por arquivo e imagem fixada por digest, coleta agregada e dashboard de seis painéis. Smoke verifica recusas de dados/admin, reinício com ACL/AOF preservados e falha/recuperação de senha. Consultar operação, ADR-055 e evidências.

A 10B2b2d acrescenta listener Vault dev autenticado, política mínima, token de 1h por arquivo/rotação, coleta e dashboard de seis painéis. Aplicar o overlay recria Vault dev e perde estado em memória; esta entrega só o aplicou em testes descartáveis. Consultar operação/matriz de correlação, ADR-056 e evidências.

A 10B3a implementa perfil opcional structured-logs no IAM/enforcer: JSON com campos controlados, catálogo finito e hash de correlação, excluindo mensagens, argumentos, exceções e MDC livre. Consultar operação, ADR-057 e evidências.

A 10B3b1 acrescenta tracing HTTP entrante opcional (perfil http-tracing), W3C restrito, amostragem local, spans sem URL/payload/erros livres e IDs no JSON IAM. Sem envio externo. Consultar operação, ADR-058 e evidências.

A 10B3b2 instrumenta os envios JDK runtime para Vault (Transit/MFA, banco dinâmico e PAM), com contexto restrito à origem/rotas configuradas e spans sem segredos. KV pré-Spring permanece fora do tracing. Consultar operação, ADR-059 e evidências.

A 10B3c1 acrescenta V23: contexto W3C opcional e imutável persistido na mesma transação do outbox, fora do payload v1, preservado em claims/retries. Migrar antes do novo binário, inclusive com tracing desligado. Consultar operação, ADR-060 e evidências.

A 10B3c2 adiciona span PRODUCER por tentativa de publicação, com parent durável ou raiz explícita, e somente traceparent adicional nos headers AMQP. Mantém payload v1 e regras de confirm/retry/lease. Consultar operação, ADR-061 e evidências.

A 10B3c3a acrescenta tracing opcional nas duas filas do enforcer: contexto AMQP restrito, span CONSUMER por entrega e limpeza de escopo/MDC, preservando ACK/retry/DLQ e efeitos Redis. O perfil consumer-tracing é independente da ativação dos workers. Consultar operação, ADR-062 e evidências.

A 10B3c3b instrumenta a auditoria IAM em lote com raiz CONSUMER e links aos produtores distintos, preservando transação única, commit antes do ACK e isolamento/retry. Reutiliza http-tracing; sem novo schema/exporter. Consultar operação, ADR-063 e evidências.

A 10B4a acrescenta backend local Tempo opcional, com imagem fixada, armazenamento próprio, portas loopback e datasource Grafana autenticado. Traces sintéticos validam ingestão, links e consulta. Consultar operação, ADR-064 e evidências.

A 10B4b implementa exportação OTLP opcional no IAM/enforcer: destino local validado, transporte JDK sem redirects, fila limitada e timeouts curtos, sem retry. Amostragem e dados finitos da instrumentação anterior são preservados; backend indisponível causa perda de telemetria sem bloquear negócio. Operação, ADR-065, evidências.

As entregas 10C e 10D completaram os ensaios de carga e investigação de gargalos arquiteturais sob a Lei de Little ($N = X \cdot (R + Z)$), calibrando semáforos e pools de conexão. A 11A empacotou a stack com imagens multi-stage Java 21 non-root e orquestração Docker Compose via perfil full. A 11B estabeleceu a esteira de integridade e release com CodeQL SAST, varredura de vulnerabilidades Trivy no CI, workflow oficial de publicação GHCR por tag e governança via testes de contrato automatizados. A 11C consolidou o hardening com Threat Model STRIDE, matriz de conformidade OWASP ASVS v4.0.3 Nível 2, catálogo de cabeçalhos de segurança HTTP e diretrizes de proteção da branch main. A 11D concluiu o fechamento da versão estável v1.0.0, com runbook de instalação limpa, relatório de aceite técnico final e validação de release. A 12A introduziu o módulo reativo api-gateway (Spring Cloud Gateway na porta 8082) com roteamento de borda, filtro global de revogação via Redis e postura Fail-Closed. A 12B estabeleceu a jornada demonstrável ponta a ponta em 5 passos, coleções de API para Bruno e Postman (docs/colecoes/), automação via scripts PowerShell e Bash, e verificação de contratos via DemoJourneyIT. A 12C concluiu os materiais finais com diagramas C4 em Visão Geral da Arquitetura, relatório formal de encerramento em Relatório de Encerramento e ADR-073.

Status do Roadmap: 100% CONCLUÍDO E HOMOLOGADO. A v1 tem foco em API REST e gateway de borda reativo; federação externa OIDC, WebAuthn e painel administrativo completo ficam para evoluções da v2.

Build local

Pré-requisitos: JDK 21, JAVA_HOME apontando para esse JDK, Docker Engine disponível e internet na primeira execução. O Wrapper baixa Maven 3.9.11. Testcontainers inicia PostgreSQL, Vault, RabbitMQ e Redis temporários; não é necessário subir o Compose para executar verify.

Windows PowerShell:

.\mvnw.cmd -version
.\mvnw.cmd -B -ntp clean verify

Linux/macOS:

./mvnw -version
./mvnw -B -ntp clean verify

O build valida JDK/Maven, verifica formatação, executa testes unitários e de integração e gera os JARs. iam-core/target/iam-core-0.1.0-SNAPSHOT.jar e policy-enforcer/target/policy-enforcer-0.1.0-SNAPSHOT.jar são executáveis Spring Boot. O enforcer não possui servidor HTTP e seu consumidor é opcional. Os testes de integração falham se Docker não estiver disponível, sem serem ignorados silenciosamente.

JaCoCo exige pelo menos 80% de cobertura de linhas por pacote de domínio/aplicação de Identity, Access, Authorization e Policy. O relatório HTML fica em iam-core/target/site/jacoco/index.html, e a CI inclui os relatórios de cobertura no artefato de testes.

Para executar apenas testes unitários/arquitetura sem iniciar containers, use ./mvnw test ou .\mvnw.cmd test. Isso não substitui o aceite completo de verify. Relatórios ficam em target/surefire-reports/ e target/failsafe-reports/ dos módulos.

Para corrigir formatação Java, execute .\mvnw.cmd spotless:apply no Windows ou ./mvnw spotless:apply no Linux/macOS. O verify apenas verifica a formatação, sem alterar o código.

Módulo Responsabilidade atual
libs/security-events Biblioteca Java sem Spring, com validação inicial dos tipos de evento
iam-core Identity/Access, políticas e simulação administrativa, auditoria básica, OAuth/OIDC com refresh, Transit/JWKS, Actuator e Flyway
policy-enforcer Consumidores de revogação e bloqueio/política com projeções Redis, consultadas opcionalmente pelo recurso do IAM
api-gateway Gateway de borda reativo com Spring Cloud Gateway, roteamento de APIs e validação precoce de revogação Redis
integration-tests Testes ponta a ponta dos JARs com infraestrutura descartável e medição da propagação

O contrato inicial SecurityEventType aceita segmentos minúsculos separados por ponto, até 128 caracteres, e rejeita curingas de binding (* e #). O envelope v1 e a persistência transacional estão na 6A1; os seis produtores foram integrados na 6A2; a 6B publica no broker quando habilitada; consumidores continuam na etapa 7. Relatórios de teste ficam em libs/security-events/target/surefire-reports/.

Infraestrutura local

Com Docker Desktop em execução, na raiz do repositório:

.\infra\scripts\Initialize-Local.ps1
docker compose --env-file .env -f infra/docker-compose.yml up -d --wait --wait-timeout 180
.\infra\scripts\Test-Local.ps1

PostgreSQL fica em 127.0.0.1:15432, Redis em 127.0.0.1:6379, RabbitMQ em 127.0.0.1:5672 com painel na porta 15672, e Vault na porta 8200. Credenciais são geradas em .env e infra/.local/, ignorados pelo Git.

Vault usa modo dev e perde chaves ao reiniciar. Consulte o guia de infraestrutura para reexecutar o bootstrap, operar a stack e entender os limites do ambiente local.

Executar o iam-core

Após o build e a subida da infraestrutura:

.\infra\scripts\Start-IamCore.ps1

O script lê o .env local e transmite a senha por variável de ambiente ao processo Java, sem gravá-la no código ou passá-la na linha de comando. A aplicação escuta em 127.0.0.1:8080; -Port 18080 permite trocar a porta. As migrações serão aplicadas ao banco local na primeira inicialização.

Endpoints públicos: GET /actuator/health, /actuator/health/liveness e /actuator/health/readiness. Por padrão, as rotas administrativas permanecem bloqueadas. Para provisionar no ambiente local, iniciar explicitamente com:

.\infra\scripts\Start-IamCore.ps1 -EnableBootstrap

As rotas /api/admin/** e a leitura de /actuator/metrics/** exigem o token gerado em .env. Consulte o guia de provisionamento para exemplos, controle de versão e atribuições. A sessão de usuário e os JWTs OAuth não concedem acesso administrativo.

Para habilitar GET /oauth2/jwks, use Start-IamCore.ps1 -EnableTransit. Essa opção lê os arquivos AppRole de infra/.local/ e é independente do bootstrap administrativo. Operação, rotação e diagnóstico estão no guia Transit.

Para emitir tokens máquina a máquina, use Start-IamCore.ps1 -EnableAuthorization -EnableBootstrap, cadastre um cliente confidencial e solicite client_credentials com Basic Auth em POST /oauth2/token, conforme o guia Client Credentials. Authorization ativa Transit automaticamente; bootstrap só é necessário para administrar. O segredo é entregue uma vez e fica armazenado como hash Argon2id.

Os mesmos parâmetros habilitam o fluxo de navegador. Cadastre o cliente em /api/admin/oauth-clients/browser, provisione um usuário ACTIVE e siga o guia de login e PKCE. A sessão local dura 15 minutos por inatividade, o consentimento pendente cinco minutos e o código dois minutos. refreshTokens: true habilita a renovação descrita no guia de refresh. Bloqueios e mudanças de versão da identidade impedem usar sessões/códigos/refresh antigos. Introspecção consulta o estado atual; recursos que verificam apenas assinatura JWT dependem da futura propagação de revogação ou da expiração do token.

Para autenticação OIDC, cadastre o cliente web com oidc: true, que adiciona openid automaticamente, e siga o guia OIDC. Discovery fica em /.well-known/openid-configuration; userinfo exige Bearer access token do fluxo OIDC. O ID token tem audiência do cliente, e o access token, da API. O cliente deve validar assinatura, issuer, audiência, expiração e nonce antes de concluir seu login.

Para administrar políticas, basta -EnableBootstrap; OAuth/Transit são independentes. Use /api/admin/policies e POST /api/admin/policies/evaluate, conforme o guia de políticas. /api/admin/policies/simulate testa cenários sintéticos com simulation: true, conforme o guia ABAC/risco. A API protegida GET /api/resources/account exige Bearer de usuário, audiência configurada e política account:self / read; consulte o guia de recursos, a ADR-017 e as evidências 5D3. A política e sua auditoria são gravadas na mesma transação; edições exigem a versão atual.

Para coletar contexto real, habilite Authorization e faça login no navegador. A administração lista contextos em /api/admin/risk/users/{userId}/contexts; informe o contextId correspondente em evaluate. Redes, sensibilidade e aprovação de navegador ficam sob /api/admin/risk/**, conforme o guia de coleta. Headers de encaminhamento não definem a origem observada. A 5D usa esses sinais na navegação, emissão/refresh e recurso local; evaluate/simulate permanecem ferramentas administrativas.

Arquivos locais

A pasta .firecrawl/ contém cache local de pesquisa e extração de documentos e é ignorada pelo Git.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages