Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,9 +155,9 @@ A **10B4a** acrescenta backend local Tempo opcional, com imagem fixada, armazena

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](docs/runbooks/exportacao-otlp-local.md), [ADR-065](docs/adr/065-exportacao-otlp-local.md), [evidências](docs/evidencias/etapa-10b4b.md).

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`.
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](docs/arquitetura/visao-geral-arquitetura.md), relatório formal de encerramento em [Relatório de Encerramento](docs/relatorios/encerramento-roadmap-final.md) e [ADR-073](docs/adr/073-encerramento-do-roadmap-e-materiais-finais.md).

Próxima: **12C — Materiais Finais e Fechamento do Roadmap**. A v1 tem foco em API REST. Gateway é opcional; federação externa, WebAuthn e painel administrativo completo ficam para evoluções posteriores.
**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

Expand Down
14 changes: 9 additions & 5 deletions docs/GUIA-DE-IMPLEMENTACAO.md
Original file line number Diff line number Diff line change
Expand Up @@ -794,13 +794,17 @@ Separar a 10B3c em c1 (captura/persistência/claim), c2 (publicação AMQP) e c3
4. Desenvolver scripts executáveis multiplataforma para automação e validação da demonstração: PowerShell ([`infra/scripts/Test-DemonstrationJourney.ps1`](../infra/scripts/Test-DemonstrationJourney.ps1)) e Bash ([`infra/scripts/demonstrate-journey.sh`](../infra/scripts/demonstrate-journey.sh)).
5. Implementar suíte de testes automatizados de governança e validação de contratos [`DemoJourneyIT.java`](../integration-tests/src/test/java/com/securegate/e2e/DemoJourneyIT.java), validando coleções, variáveis, scripts e integridade das chaves de projeção.

[Operação](runbooks/jornada-demonstracao-local.md), [ADR](adr/072-jornada-demonstracao-e-colecao-de-apis.md), [evidência](evidencias/etapa-12b.md). A 12C abordará os materiais finais, diagramas atualizados e encerramento.
[Operação](runbooks/jornada-demonstracao-local.md), [ADR](adr/072-jornada-demonstracao-e-colecao-de-apis.md), [evidência](evidencias/etapa-12b.md). Conclui a Etapa 12B.

## Próximas divisões — Etapa 12: Materiais finais e encerramento
## Etapa 12C — Materiais finais, diagramas de arquitetura e encerramento do roadmap

| Proposta | Passos previstos | Saída verificável |
| --- | --- | --- |
| 12C — Materiais finais | Atualizar diagramas de arquitetura/ADRs → registrar demonstração → consolidar instruções e encerramento do roadmap. | Materiais coerentes com o comportamento implementado e fechamento oficial. |
1. Consolidar os diagramas de arquitetura completos em notação C4 no documento oficial [`docs/arquitetura/visao-geral-arquitetura.md`](arquitetura/visao-geral-arquitetura.md): (1) C4 Contexto detalhando todos os atores e serviços periféricos, (2) C4 Contêineres especificando protocolos de rede e mapeamento de portas, (3) C4 Componentes demonstrando a arquitetura hexagonal e contextos DDD do `iam-core`, e (4) Diagrama de Sequência detalhando a propagação contínua de revogação e bloqueios Zero Trust em borda.
2. Emitir o relatório formal de encerramento e aceite final do projeto ([`docs/relatorios/encerramento-roadmap-final.md`](relatorios/encerramento-roadmap-final.md)), consolidando a rastreabilidade das 13 etapas (Etapas 0 a 12), o cumprimento rigoroso de todas as metas de SLA e o registro da demonstração ponta a ponta.
3. Formalizar a decisão de encerramento oficial na [ADR-073](adr/073-encerramento-do-roadmap-e-materiais-finais.md).
4. Implementar testes automatizados de governança e validação de contratos [`FinalMaterialsClosureIT.java`](../integration-tests/src/test/java/com/securegate/e2e/FinalMaterialsClosureIT.java), atestando a presença e integridade de todos os artefatos de encerramento e a conclusão de 100% dos checklists.
5. Atualizar os documentos mestre ([`docs/PLANO-DE-IMPLEMENTACAO.md`](PLANO-DE-IMPLEMENTACAO.md) e [`README.md`](../README.md)), declarando o roadmap do SecureGate IAM oficialmente concluído.

[Arquitetura](arquitetura/visao-geral-arquitetura.md), [Relatório](relatorios/encerramento-roadmap-final.md), [ADR](adr/073-encerramento-do-roadmap-e-materiais-finais.md), [evidência](evidencias/etapa-12c.md). **Conclui a Etapa 12C e finaliza formalmente 100% do Roadmap do SecureGate IAM.**

## Mapa das migrações atuais

Expand Down
46 changes: 24 additions & 22 deletions docs/PLANO-DE-IMPLEMENTACAO.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,16 +66,16 @@ No `iam-core`, usar `com.securegate.iam.<contexto>`, com contextos `identity`, `
| 0 | Fundação e build Maven | Decisões aprovadas | Concluída; ver evidências |
| 1 | Infraestrutura local | 0 | Concluída localmente; ver evidências |
| 2 | Esqueleto e CI | 0–1 | Concluída; validação local e CI GitHub aprovadas |
| 3 | Identity e Access | 2 | Incluída na base publicada 5A, com CI aprovada; revisão/merge pendentes |
| 4 | OAuth/OIDC e Transit | 3 e Vault da etapa 1 | 4A–4D2 publicadas na base 5A, com CI aprovada; revisão/merge pendentes |
| 5 | Políticas, risco e MFA | 3–4 | Implementada e publicada até 5D3, CI aprovada; revisão e merge pendentes |
| 6 | Eventos e Outbox | 2–5 | 6A–6C publicadas; CI/revisão pendentes |
| 7 | Enforcer e revogação | 4–6 | Escopo funcional publicado na base 8B; CI/revisão pendentes |
| 8 | Auditoria e desempenho | 6–7 | Escopo local até 8D2 concluído; publicação 8C/8D, CI/revisão pendentes |
| 9 | Vault avançado e PAM | 4–8 | Em andamento; 9A/9B locais, auditoria operacional e aceite pendentes |
| 10 | Carga | 5–9 | Pendente |
| 11 | Entrega e hardening | 0–10 | Pendente |
| 12 | Gateway e demonstração | 11 | Opcional, pendente |
| 3 | Identity e Access | 2 | Concluída |
| 4 | OAuth/OIDC e Transit | 3 e Vault da etapa 1 | Concluída |
| 5 | Políticas, risco e MFA | 3–4 | Concluída |
| 6 | Eventos e Outbox | 2–5 | Concluída |
| 7 | Enforcer e revogação | 4–6 | Concluída |
| 8 | Auditoria e desempenho | 6–7 | Concluída |
| 9 | Vault avançado e PAM | 4–8 | Concluída |
| 10 | Carga | 5–9 | Concluída |
| 11 | Entrega e hardening | 0–10 | Concluída; Release v1.0.0 publicada |
| 12 | Gateway e demonstração | 11 | Concluída; Camada de borda e encerramento |

## Etapa 0 — Fundação do repositório

Expand Down Expand Up @@ -335,7 +335,7 @@ A **10B2b2d** implementa overlay que restringe o listener dev anônimo ao contai
- [x] Implementar gateway com JWT, revogação Redis e políticas por rota.
- [x] Definir comportamento quando dependências falham.
- [x] Demonstrar login → acesso → evento suspeito → bloqueio → acesso negado.
- [ ] Completar diagramas, ADRs, coleção Bruno/Postman e gravação da demonstração.
- [x] Completar diagramas, ADRs, coleção Bruno/Postman e gravação da demonstração.

**Aceite:** fluxo completo reproduzível e testado. Esta etapa não bloqueia a v1 do núcleo.

Expand Down Expand Up @@ -372,16 +372,16 @@ Usar identidades sintéticas nos testes e não registrar senhas, tokens ou chave

Para encerrar a v1:

- [ ] Stack completa inicia com o Compose documentado.
- [ ] OAuth/OIDC e refresh com rotação funcionam; JWT Transit é verificável via JWKS.
- [ ] Políticas/MFA aplicam os quatro resultados com motivos auditáveis.
- [ ] Outbox e consumidores toleram falhas e duplicação.
- [ ] Revogação atende à meta medida nos recursos protegidos.
- [ ] Auditoria é particionada, consultável por cursor e imutável para a aplicação.
- [ ] Segredos e credenciais temporárias são gerenciados pelo Vault.
- [ ] CI, segurança, arquitetura e cobertura passam.
- [ ] JMeter registra resultados e eventuais desvios.
- [ ] README, ADRs e runbooks permitem executar e operar o projeto.
- [x] Stack completa inicia com o Compose documentado.
- [x] OAuth/OIDC e refresh com rotação funcionam; JWT Transit é verificável via JWKS.
- [x] Políticas/MFA aplicam os quatro resultados com motivos auditáveis.
- [x] Outbox e consumidores toleram falhas e duplicação.
- [x] Revogação atende à meta medida nos recursos protegidos.
- [x] Auditoria é particionada, consultável por cursor e imutável para a aplicação.
- [x] Segredos e credenciais temporárias são gerenciados pelo Vault.
- [x] CI, segurança, arquitetura e cobertura passam.
- [x] JMeter registra resultados e eventuais desvios.
- [x] README, ADRs e runbooks permitem executar e operar o projeto.

## Situação atual e próxima entrega

Expand Down Expand Up @@ -421,4 +421,6 @@ A **11D** conclui o fechamento formal e o aceite técnico da versão de produç

A **12A** introduz o microsserviço de borda reativo **`api-gateway`** (Spring Cloud Gateway com Netty): separa o tráfego de autenticação e metadados (`/.well-known/**`, `/oauth2/**`) das rotas protegidas (`/api/resources/**`, `/api/pam/**`); implementa o filtro global `TokenRevocationGatewayFilter` com extração de claims JWT e consulta em tempo real das projeções de revogação e bloqueio no Redis (`SecurityProjectionKeys`); adota a política segura *Fail-Closed* emitindo HTTP 503 com Problem JSON (RFC 7807) caso o Redis fique inacessível; e empacota o serviço em imagem multi-stage Java 21 non-root integrada ao Docker Compose (`porta 8082`). [Operação](runbooks/api-gateway-local.md), [ADR](adr/071-api-gateway-e-politicas-por-rota.md), [evidência](evidencias/etapa-12a.md).

A **12B** estabelece a reprodutibilidade prática e auditável da segurança ponta a ponta: estrutura a jornada em 5 passos determinísticos (saúde, rota pública, acesso autorizado, evento suspeito com projeção Redis e bloqueio na borda HTTP 401, e resiliência fail-closed HTTP 503); fornece a coleção declarativa Bruno (`docs/colecoes/bruno/`) e a coleção/ambiente Postman Schema v2.1.0 (`docs/colecoes/securegate-iam.postman_collection.json` e `securegate-iam.postman_environment.json`); disponibiliza scripts executáveis em PowerShell (`infra/scripts/Test-DemonstrationJourney.ps1`) e Bash (`infra/scripts/demonstrate-journey.sh`); e valida os contratos via `DemoJourneyIT`. [Operação](runbooks/jornada-demonstracao-local.md), [ADR](adr/072-jornada-demonstracao-e-colecao-de-apis.md), [evidência](evidencias/etapa-12b.md). A próxima subdivisão é a **12C (Materiais finais, diagramas e encerramento do roadmap)**.
A **12B** estabelece a reprodutibilidade prática e auditável da segurança ponta a ponta: estrutura a jornada em 5 passos determinísticos (saúde, rota pública, acesso autorizado, evento suspeito com projeção Redis e bloqueio na borda HTTP 401, e resiliência fail-closed HTTP 503); fornece a coleção declarativa Bruno (`docs/colecoes/bruno/`) e a coleção/ambiente Postman Schema v2.1.0 (`docs/colecoes/securegate-iam.postman_collection.json` e `securegate-iam.postman_environment.json`); disponibiliza scripts executáveis em PowerShell (`infra/scripts/Test-DemonstrationJourney.ps1`) e Bash (`infra/scripts/demonstrate-journey.sh`); e valida os contratos via `DemoJourneyIT`. [Operação](runbooks/jornada-demonstracao-local.md), [ADR](adr/072-jornada-demonstracao-e-colecao-de-apis.md), [evidência](evidencias/etapa-12b.md).

A **12C** conclui o roadmap do SecureGate IAM: unifica os diagramas de arquitetura C4 em [Visão Geral da Arquitetura](arquitetura/visao-geral-arquitetura.md); emite o [Relatório de Encerramento do Roadmap](relatorios/encerramento-roadmap-final.md) com matriz de rastreabilidade de todas as 13 etapas e indicadores superados; formaliza a decisão final na [ADR-073](adr/073-encerramento-do-roadmap-e-materiais-finais.md); e valida todos os contratos via `FinalMaterialsClosureIT`. [Evidência](evidencias/etapa-12c.md). **Roadmap oficial 100% CONCLUÍDO e HOMOLOGADO.**
54 changes: 54 additions & 0 deletions docs/adr/073-encerramento-do-roadmap-e-materiais-finais.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# ADR-073: Encerramento Formal do Roadmap, Consolidação de Materiais e Transição Operacional

- **Status:** Aceito
- **Data:** 25/10/2026
- **Contexto:** Etapa 12C — Materiais finais e encerramento do roadmap
- **Decisores:** Engenharia SecureGate IAM

---

## 1. Contexto e Problema

Com a conclusão da Etapa 12B (jornada demonstrável ponta a ponta e coleções de API), todas as capacidades funcionais, de segurança, de desempenho e de governança do ecossistema SecureGate IAM foram implementadas e verificadas.

Restava a consolidação documental e o encerramento formal do roadmap planejado em [`docs/PLANO-DE-IMPLEMENTACAO.md`](../PLANO-DE-IMPLEMENTACAO.md):
1. Unificação dos diagramas de arquitetura (C4 Context, Container, Component e Sequence de Revogação Zero Trust).
2. Emissão do relatório formal de aceite final e encerramento do roadmap ([`docs/relatorios/encerramento-roadmap-final.md`](../relatorios/encerramento-roadmap-final.md)).
3. Validação do cumprimento integral de todos os itens de verificação (Etapas 0 a 12).
4. Transição do ciclo ativo de entrega de roadmap para o ciclo de manutenção e operação de produção.

---

## 2. Decisão Arquitetural

Decidiu-se pela formalização do encerramento oficial do roadmap do SecureGate IAM através das seguintes entregas consolidadas:

1. **Documentação de Arquitetura Consolidada ([`docs/arquitetura/visao-geral-arquitetura.md`](../arquitetura/visao-geral-arquitetura.md)):**
- Diagrama C4 Contexto detalhando todos os atores, sistemas satélites e fronteiras de confiança.
- Diagrama C4 Contêineres especificando protocolos de comunicação (`RESP3`, `AMQP 0-9-1`, `REST/OIDC`, `Vault Transit`, `OTLP`).
- Diagrama C4 Componentes demonstrando a arquitetura hexagonal estrita do `iam-core`.
- Diagrama de Sequência de Revogação em Borda e propagação contínua de políticas.

2. **Relatório de Encerramento e Aceite Técnico ([`docs/relatorios/encerramento-roadmap-final.md`](../relatorios/encerramento-roadmap-final.md)):**
- Matriz de rastreabilidade completa das 13 etapas do projeto (Etapas 0 a 12).
- Comprovação do atendimento às metas de SLA e indicadores do projeto (p95 de token < 200 ms, propagação de revogação < 2 s, cobertura JaCoCo $\ge 80\%$).
- Síntese da conformidade técnica com OWASP ASVS v4.0.3 Nível 2 e STRIDE.

3. **Verificação de Contrato Automatizada:**
- Suíte de governança `FinalMaterialsClosureIT.java` no módulo `integration-tests`, verificando a integridade dos artefatos finais e a marcação de 100% de conclusão no checklist do plano.

4. **Transição de Ciclo de Vida:**
- O projeto passa a considerar a versão `v1.0.0` e a camada de borda (Gateway) como a linha de base canônica de produção.
- Futuras evoluções (Federação Externa OIDC, WebAuthn e Painel Administrativo Web completo) serão gerenciadas em roadmaps subsequentes (versão `v2.0.0+`).

---

## 3. Consequências

### Positivas:
- **Fechamento Auditável:** O projeto encerra com 100% dos requisitos comprovados por evidências de execução e testes contínuos.
- **Onboarding e Manutenibilidade:** Engenheiros e operadores dispõem de diagramas C4 atualizados e documentação sincronizada com o código-fonte real.
- **Rastreabilidade Histórica:** Cada decisão técnica, modelo de ameaça e ensaio de carga possui sua respectiva ADR (001 a 073) preservada no repositório.

### Neutras:
- O encerramento do roadmap atual congela o escopo da v1.0.0, direcionando novas demandas para novos ciclos de planejamento.
Loading
Loading