Implant

Sistema automatizado de implantacao e verificacao de conformidade para servidores Linux, escrito em Rust.

Visao Geral

Atributo Valor
Versao 2.65.1
Linguagem Rust (Edition 2021)
Licenca Apache-2.0
Status Producao
Arquiteturas x86_64, aarch64 (static musl)
Download https://implant.ccs.systems/x86_64/implant

O que e o Implant?

O Implant e um binario unico que analisa, configura e hardena servidores Linux automaticamente. Ele executa uma serie de verificacoes de conformidade e aplica correcoes quando necessario.

O binario e compilado estaticamente (musl), sem dependencia de glibc, e roda em qualquer distribuicao Linux nas arquiteturas x86_64 e aarch64.

Problemas que resolve

  1. Configuracao manual repetitiva - Automatiza setup completo de servidores
  2. Inconsistencia entre servidores - Garante padrao uniforme em toda a frota
  3. Seguranca basica negligenciada - Aplica hardening automaticamente
  4. SSH mal configurado - Porta customizada, rate limiting, penalties, rollback e watchdog
  5. Docker sem limites - Log rotation, networks, configuracao otimizada

Funcionalidades

Verificacao de Conformidade

  • 8 modulos: fundamentals, hardening, docker, network, monitoring, traefik, agent, nodejs
  • check sem --auto-fix so le; mudancas de risco (ex.: porta SSH) ficam em comandos dedicados
  • Modo dry-run para preview sem aplicar mudancas
  • Relatorio detalhado com status de cada verificacao

Correcao Automatica

  • Flag --auto-fix aplica todas as correcoes
  • Rollback automatico em caso de falha
  • Execucao modular (escolher modulos especificos)

SSH Key Management

  • Gerenciamento de chaves no authorized_keys
  • Adicao de chaves publicas via texto ou URL
  • Whitelist automatica de IPs (fail2ban, UFW, SSH)
  • Alias sugerido para conexao rapida

SSH Safety

  • Snapshots automaticos antes de qualquer modificacao SSH
  • Watchdog com reversao automatica em 5 minutos se porta nao confirmada
  • Rollback para qualquer snapshot anterior
  • Emergency reset que reverte TODAS as configs de seguranca

Instalacao de Apps

  • Componentes opcionais via implant install (node, claude-code, sysinfo, backupally, container, deployally, runner)
  • Download arch-aware, verificacao e instalacao automatica
  • Self-update do proprio Implant (implant self-update)

Setup Claude Code

  • Cria usuario dedicado claudecode
  • Configura Docker, sudoers, ACLs, limites
  • Instala guard-rail CLAUDE.md
  • Auto-update via cron

Seguranca de Rede

  • TLS Pinning (SPKI) com pins compilados no binario
  • Verificacao de integridade dos certificados dos servidores de distribuicao
  • Assinatura minisign obrigatoria ao baixar de host sem pin embutido
  • Cliente HTTP seguro integrado

VPN WireGuard (v2.48.0+)

  • wireguard - Instala/adota a VPN do servidor, gerencia devices (peers) e a porta UDP no firewall
  • Chave privada de cada device exibida uma unica vez na criacao

Stack de Seguranca Ativa (v2.19.0+)

  • rate-limit - Rate limiting via iptables hashlimit (SSH + sweep)
  • auto-ban - Daemon que bana IPs ofensivos detectados em 4 sinais
  • geo-block - Bloqueia trafego INPUT por pais via IPDeny + ipset (modes: blocklist | allowlist)
  • feed-block - Blocklist externa de redes hostis (padrao Spamhaus DROP) em ipset, com timer semanal
  • capture - Daemon tcpdump rotativo + extract query expressivo
  • audit - auditd STIG-light + events query + threat-status collector
  • threat-status - 9 collectors com severity ok/warn/crit + transitions JSONL
  • emergency-mode - Desabilita temporariamente as features opt-in com deadman restore
  • ban / unban - Ban manual de IP/CIDR no ipset central (INPUT + DOCKER-USER)
  • traefik-edge - Corta arquivos sensiveis no ingresso do Traefik (403 antes de qualquer servico)
  • traefik-ratelimit - Rate-limit L7 por IP no Traefik (429 antes do servico)
  • firewall audit - Auditoria somente leitura do firewall (policies, ganchos, regras cruas, boot)

Comandos

Conformidade e provisionamento

Comando Descricao
`check` Verificar conformidade do servidor (--auto-fix, --modules)
`fix` Aplicar correcoes (--auto, --interactive)
`reset` Reverter configuracoes (--swap, --fail2ban, --ssh-port, --kernel-hardening...)
`report` Gerar relatorio (--format text/json/markdown)
`install` Instalar apps: node, claude-code, sysinfo, backupally, container, deployally, runner
`reconfigure` Reconfigurar docker/k3s
`validate` Validar configuracao
`info` Informacoes do sistema
`status` Status geral do implant
`self-update` Atualizar o implant (--url para origem alternativa)
`update-guardrail` Atualizar guardrail Claude Code
`agent` Instalar agent de controle remoto

Seguranca (stack v2.19.0+)

Comando Descricao
`harden-network` Hardening de rede (sysctl)
`rate-limit` Rate limiting SSH + hashlimit
`auto-ban` Daemon que bana IPs ofensivos (v2.22.0+)
`geo-block` Block por pais (--mode blocklist|allowlist, v2.23.0+)
`feed-block` Blocklist externa de redes hostis, padrao Spamhaus DROP (v2.60.0+)
`capture` tcpdump rotativo + extract query (v2.24.0+)
`audit` auditd STIG-light + events (v2.24.0+)
`threat-status` Snapshot de severity por secao + transitions
`emergency-reset` Reset de emergencia (--force, --dry-run)
`emergency-mode` Desliga temporariamente as features opt-in (com restore automatico)
`ban` / `unban` Ban/unban manual de IP ou CIDR
`firewall-restore` Unit de boot que restaura os ipsets e, sem netfilter-persistent, reaplica as regras do implant (v2.61.0+)
`traefik-edge` Arquivos sensiveis cortados no edge do Traefik
`traefik-ratelimit` Rate-limit L7 por IP no Traefik, middleware do file-provider (v2.60.0+)
`firewall` Comandos firewall (allow/deny)
`firewall audit` Auditoria somente leitura do firewall, --strict para automacao (v2.60.0+)
`iptables` Wrapper iptables
`fail2ban` Wrapper fail2ban
`lockdown` Lockdown temporario com deadman
`mitigations` Limite de taxa por IP com prazo, no firewall (L4) e no Traefik (L7) (v2.63.0+)

Alertas

Comando Descricao
`alerts` Alertas de eventos graves por Telegram ou webhook HTTPS, credenciais so no servidor (v2.61.0+)

VPN

Comando Descricao
`wireguard` VPN WireGuard: init/adopt, devices, porta UDP, status

Sistema

Comando Descricao
`sysctl` Hardening de kernel via sysctl
`swap` Gerenciar swap
`limits` Limites do sistema (limits.conf + systemd)
`logrotate` Configuracao de logrotate
`docker-limits` Limites de log do Docker (daemon.json)

SSH

Comando Descricao
`ssh-key` Gerenciar chaves SSH
`ssh-port` Alterar porta SSH (com watchdog)
`ssh-rollback` Rollback SSH para snapshot anterior
`ssh-service` Service control SSH

Outros

Comando Descricao
`setup-claude-code` Configurar Claude Code
`traefik-accesslog` Access log Traefik

Distros Suportadas

Distro Versao Minima
Ubuntu 20.04+
Debian 10+
CentOS 7+
Rocky Linux 8+

Proximos Passos

  1. Instalacao - Instale o Implant
  2. Modulos - Entenda cada modulo
  3. Referencia CLI - Todos os comandos
  4. Troubleshooting - Solucao de problemas