Skip to content
edsonmartinsPublic

About

Plataforma open-source de acesso privilegiado: operadores acessam servidores e bancos de clientes sem receber a credencial — identidade central (OIDC), credenciais efêmeras (OpenBao) e sessões gravadas

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ArchGate

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.


Por quê

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)

Arquitetura (visão)

Arquitetura do ArchGate

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).


Estado do lab (piloto)

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

Hostnames públicos (lab)

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)

Estrutura do repositório

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

Deploy (resumo)

# 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).


Documentação — mapa de leitura

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)

ADRs relevantes

  • 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

Acesso do operador (padrão)

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=require

Snippets: 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

Validação e aceite

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

Stack e versões (lab)

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.


Roadmap (alto nível)

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ção

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:

  1. Ler CONSTITUTION.md e o change OpenSpec da fase.
  2. Implementar uma tarefa de tasks.md por vez; marcar [x] só após validar o cenário.
  3. Commits: referenciar change e tarefa quando aplicável (add-identity-axis #2.5).
  4. Documentação e specs em pt-BR; código/identificadores em inglês.
  5. 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)

Licença

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.

About

Plataforma open-source de acesso privilegiado: operadores acessam servidores e bancos de clientes sem receber a credencial — identidade central (OIDC), credenciais efêmeras (OpenBao) e sessões gravadas

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages