◈ ProjView
← todos os projetos

sha-sentinel

Python Defensiva GitHub ↗

Monitor de integridade de arquivos por SHA-256 (baseline vs atual).

3 testes · 3 passou · 0 falhou · 0 skip

Entrypoints (CLI)

Módulos e funções principais

src/sha_sentinel/__init__.py
src/sha_sentinel/cli.py
  • main()
src/sha_sentinel/core.py
  • digest()
  • baseline()
  • diff()
  • main()

Estrutura de arquivos

README

# sha-sentinel Monitor de integridade de arquivos por SHA-256 (baseline vs atual). ## O que faz Esta ferramenta de **defensiva** contra alvos que voce possui ou tem autorizacao. Monitor de integridade de arquivos por SHA-256 (baseline vs atual). O codigo e testavel localmente (sem dependencias de rede para os testes unitarios). > **Aviso etico:** uso exclusivo para fins educacionais e testes em ambientes > que voce **possui** ou tem **autorizacao expressa** para auditar. Nunca a > utilize contra sistemas de terceiros. O autor nao se responsabiliza por uso > indevido. ## Instalacao ```bash git clone https://github.com/Diogo-Damasceno/sha-sentinel.git cd sha-sentinel python3 -m venv .venv && . .venv/bin/activate pip install -e . ``` ## Uso Gere um baseline e detecte alterações em arquivos críticos. ## Exemplos reais ```bash $ integrity-guard /etc/passwd /etc/shadow # {'/etc/passwd': 'a1b2...'} ``` ## Como funciona (resumo) O modulo principal implementa a logica em funcoes puras e testaveis; a CLI e apenas a casca de argumentos. Os testes em `tests/` (Python) ou `CoreTest.java` (Java) cobrem os casos principais e rodam offline. ## O que NAO faz - Nao executa ataques contra terceiros. - Nao exfiltra dados. - Nao substitui uma solucao comercial de seguranca. ## Licenca MIT — ver `LICENSE`.
sha-sentinel SIM NÃO Comando: baseline ou check Calcular SHA-256 dos arquivos Modo baseline? Salvar baseline Comparar com baseline Baseline / relatorio de integridade

Como rodar na prática (entrada → saída):

$ sha-sentinel baseline /etc
baseline.json criado (1284 arquivos, SHA-256)
$ sha-sentinel check /etc
ALTERADO /etc/passwd\nINTEGRO 1282/1284 arquivos