Plataforma de acesso privilegiado (bastion/gateway) da IntegrAllTech.
Operadores e agentes acessam máquinas, bancos, Kubernetes e painéis de clientes sem receber a credencial do alvo. Identidade é central (offboarding em um ponto); sessões são auditáveis; a stack roda self-hosted (LGPD / soberania de dados).
ArchGuard é o módulo de identidade dentro do ArchGate — “o Guard controla quem passa pelo Gate” (ver ADR-005).
Open source (Apache 2.0) · monorepo de produto, governança OpenSpec, ADRs e deploy Docker Swarm.
| Problema atual | Com ArchGate |
|---|---|
| Credenciais de cliente nas máquinas dos devs | Gateway injeta o segredo; o dev não vê |
| Offboarding = rotacionar dezenas de senhas | Revoga identidade no ArchGuard → acesso cai |
| Auditoria fraca / espalhada | Sessões gravadas no bastion (WG / Guac) |
| Escala multi-cliente manual | Tenants + inventário de sites + control plane |
Princípios: zero-credencial-no-dev, política no gateway, identidade como alicerce, efemeridade por padrão, API-first.
Documento de arquitetura: PLATAFORMA_ACESSO_PRIVILEGIADO.md.
Invariantes: CONSTITUTION.md.
Plano 100%: documentos/PLAN-PRODUTO-100.md.
Ops / VPS / Cloudflare: repositório irmão archgate-devops (../archgate-devops).
| Serviço (scaffold) | Path | Porta dev |
|---|---|---|
| UnifiedUI | frontend/unified-ui |
5174 |
| ArchGate Connect (CLI+tray) | clients/archgate-connect |
— |
| Orchestration (Axis) | services/orchestration |
8090 |
| Agent control (OpenSRE) | services/agent-control |
8091 |
| Oracle proxy | services/oracle-proxy |
(Spring) |
Clique na imagem para abrir a versão em alta resolução (PNG 4800×3030).
Caixas tracejadas são componentes planejados ou parciais (NetBird, HA do OpenBao, Oracle real, Agent-control em produção). O fluxo detalhado de cada sessão está em PLATAFORMA_ACESSO_PRIVILEGIADO.md.
| Camada | Papel | Componente |
|---|---|---|
| Controle | Tenants, sites, orquestração | Mentors Axis + console ArchGuard |
| Identidade | SSO, memberships, MFA/step-up, service accounts | ArchGuard (fork Casdoor) |
| Autorização | Tuplas checadas na abertura de sessão | OpenFGA |
| Gateway | Proxy + gravação | Warpgate (SSH/PG) + RustGuac/guacd (RDP/VNC/SSH web); Apache Guacamole como legado |
| Segredos | Credenciais de curta duração | OpenBao |
| Rede | Alcance aos sites | Connector site (WG/OpenVPN/…) · NetBird (fase futura) |
| Borda | TLS / roteamento | Traefik + Cloudflare Tunnel |
Console de identidade e UI admin (ArchGate Manager) vivem no repositório irmão ../_archguard/archguard-console; este monorepo concentra produto ArchGate, deploy, specs e runbooks.
Atenção:
../archguardé um fork legado do Casdoor e não é o console. O console em uso é../_archguard/archguard-console(corrigido na auditoria 2026-07-28).
Ambiente de staging: host runtime Swarm edson-ai · domínio *.archgate.com.br.
| Pacote OpenSpec | Status |
|---|---|
add-identity-axis |
Legado concluído; identidade atual é ArchGuard (ADR-014) |
add-operator-client-access-standard |
Lab-ready (ADR-008, smoke operador, bastion-first) |
add-ephemeral-credentials |
MVP lab (OpenBao, JWT←ArchGuard, broker DB) |
| Control plane admin (ADR-009) | Lab: sites SoT, apply gateways, Axis sync, /platform |
| Aceite piloto | PASS com waiver — ver runbooks |
Matriz viva: documentos/MATRIZ_FUNCIONALIDADES.md
Checklist de aceite: documentos/runbooks/ACEITE-PILOTO-LAB.md
| Host | Serviço |
|---|---|
app.archguard.com.br |
ArchGuard IdP |
console.archgate.com.br |
ArchGuard Console |
wg.archgate.com.br |
Warpgate (UI + SSH :2222 + PG :55432) |
guac.archgate.com.br |
Guacamole (portão oauth2-proxy) |
adr/ Decisões de arquitetura (ADR-00x)
openspec/ Changes, designs, specs e tasks (governança)
deploy/ Docker Swarm stacks, Traefik, connectors, validação
documentos/ Runbooks, inventário de sites, matriz, evidências
services/ Serviços próprios (Oracle proxy, orquestração — fases futuras)
frontend/ UnifiedUI (Fase 4)
CONSTITUTION.md Invariantes do produto
PLATAFORMA_ACESSO_PRIVILEGIADO.md
# No host runtime (Swarm), com bootstrap.env fora do git (mode 600):
# ver deploy/README.md e deploy/env.example/bootstrap.env
./deploy/bootstrap-networks.sh
# O deploy oficial da VPS é feito pelo repositório `archgate-devops`.O diretório deploy/ deste repositório é histórico; não use seus manifests para provisionar a VPS.
Segredos: bootstrap.env e chaves age fora do git (ver .gitignore).
| Ordem | Documento | Conteúdo |
|---|---|---|
| 1 | CONSTITUTION.md |
Invariantes (precede tudo) |
| 2 | INICIAR_ARCHGATE.md |
Como começar a trabalhar no repo |
| 3 | PLATAFORMA_ACESSO_PRIVILEGIADO.md |
Arquitetura completa |
| 4 | openspec/project.md |
Stack, topologia, convenções |
| 5 | openspec/changes/README.md |
Fases e pacotes |
| 6 | deploy/README.md |
Swarm, redes, stacks |
| 7 | documentos/runbooks/ |
Operação, operador multi-OS, aceite |
| 8 | documentos/PLAN-HOMOLOGACAO-MVP.md |
Plano de tarefas até homologação MVP |
| 9 | documentos/PLAN-PRODUTO-100.md |
Plano até 100% do produto (W0–W5) |
| 9b | documentos/runbooks/W0-EXECUCAO.md |
Execução onda W0 (auto + browser + peer) |
| 10 | documentos/runbooks/HOMOLOGACAO-UAT.md |
Roteiro UAT (revisor, ≤30 min) |
- ADR-003 — PostgreSQL externo (sem SQLite em prod)
- ADR-004 — Fronteira ArchGuard × Mentors Axis
- ADR-005 — Nome do produto
- ADR-007A — SSO Guacamole via oauth2-proxy
- ADR-008 — Cliente operador híbrido (browser + desktop)
- ADR-009 — Control plane no console
- ADR-014 — ArchGuard substitui o Kanidm como IdP
Bastion-first (ADR-008): o notebook não liga VPN de cliente + SSH direto no IP do alvo.
# SSH via Warpgate (exemplo lab)
ssh -p 2222 'usuario:rio-lab-ssh@wg.archgate.com.br'
# Postgres via Warpgate
# host=wg… port=55432 user=usuario:rio-lab-postgres sslmode=requireSnippets: documentos/runbooks/snippets/
Runbook multi-OS: documentos/runbooks/cliente-operador-multi-os.md
Smoke:
WG_HOST=192.168.1.180 bash deploy/validation/smoke-operator-access.sh| Script / doc | Uso |
|---|---|
deploy/validation/smoke-operator-access.sh |
SSH + PG via bastion |
deploy/validation/tenant-isolation-e2e.sh |
Isolamento tenant |
deploy/validation/smoke-operator-access.sh |
Acesso operacional via gateway |
documentos/runbooks/ACEITE-PILOTO-LAB.md |
Checklist pass/fail lab |
documentos/runbooks/sites/smoke-evidence-*.md |
Evidências datadas |
| Componente | Versão pinada (referência) |
|---|---|
| Traefik | v3.4.x |
| ArchGuard | fork Casdoor mantido pela IntegrAllTech |
| Warpgate | 0.26.x |
| Guacamole / guacd | 1.6.x |
| OpenBao | 2.x |
| PostgreSQL (externo) | 16.x |
| Console | Node / TanStack Start (repo ../_archguard/archguard-console) |
| Axis (lab) | Spring Boot :9031 |
Detalhes de arquitetura: openspec/project.md.
| Fase | Foco |
|---|---|
| 1 | Identidade + gateways + console + padrão operador — lab |
| 2 | Credenciais efêmeras (OpenBao) — MVP lab |
| 3 | Malha / connectors site; Oracle proxy (3a) |
| 4 | UnifiedUI + orquestração completa Axis |
| 5 | HA, acesso agêntico, OpenSRE adjacente |
Itens fora do aceite lab: peer VPN de cliente real em produção, UnifiedUI, HA OpenBao, SIEM, NetBird full.
Contribuições são bem-vindas! Antes de abrir um PR, leia o guia de contribuição: ele cobre os invariantes do CONSTITUTION.md, o fluxo spec-driven (OpenSpec), como rodar o CI localmente, o padrão de commits e a assinatura DCO (git commit -s).
Resumo:
- Ler
CONSTITUTION.mde o change OpenSpec da fase. - Implementar uma tarefa de
tasks.mdpor vez; marcar[x]só após validar o cenário. - Commits: referenciar change e tarefa quando aplicável (
add-identity-axis #2.5). - Documentação e specs em pt-BR; código/identificadores em inglês.
- Nunca commitar
bootstrap.env, tokens, gravações de sessão ou dados de clientes.
Relacionados:
../_archguard/archguard-console— ArchGate Manager + BFF/api/unified/v1/*+ integração ArchGuard../archgate-devops— compose de staging, scripts de deploy e ops- Mentors Axis — plano de controle de tenants (API Spring no lab)
Distribuído sob a Apache License 2.0. O ArchGuard preserva a licença Apache-2.0 da base Casdoor; engines de terceiros mantêm suas respectivas licenças.