Aikido Safe Chain

✅ Blocca il malware sui laptop degli sviluppatori e su CI/CD
✅ Supporta npm e PyPI, altri gestori di pacchetti in arrivo
✅ Blocca i pacchetti più recenti di 48 ore senza interrompere la build
✅ Senza token, gratuito, nessun dato di build condiviso

Hai bisogno di protezione oltre npm e PyPI?

Aikido Device Protection si basa su Safe Chain, estendendo la sicurezza di pacchetti ed estensioni a più ecosistemi: npm, PyPI, VS Code, Open VSX - (Cursor, Windsurf, Kiro, Vs Codium, ...), Maven, NuGet, estensioni Chrome, Go, Skills.sh AI skills, Ruby, Rust e altro ancora.

Ottieni gestione centralizzata delle policy, flussi di lavoro di richiesta e approvazione e visibilità su ogni workstation di sviluppo nella tua organizzazione. Alimentato dallo stesso feed Intel di Aikido. Distribuiscilo manualmente o gestiscilo tramite il tuo strumento MDM (Jamf, Fleet o Iru).

Aikido Safe Chain supporta i seguenti gestori di pacchetti:

📦 npm
📦 npx
📦 yarn
📦 pnpm
📦 pnpx
📦 rush
📦 rushx
📦 bun
📦 bunx
📦 pip
📦 pip3
📦 uv
📦 poetry
📦 uvx
📦 pipx
📦 pdm

Utilizzo

Aikido Safe Chain demo

Installazione

Installare Aikido Safe Chain è semplice con lo script di installazione.

Unix/Linux/macOS```shell

curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh
&& echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839 /tmp/install-safe-chain.sh" | sha256sum -c -
&& sh /tmp/install-safe-chain.sh
&& rm /tmp/install-safe-chain.sh

### Windows (PowerShell)```powershell
$installer = Join-Path $env:TEMP "install-safe-chain.ps1"
Invoke-WebRequest "https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.ps1" -OutFile $installer -UseBasicParsing
$expectedHash = "6F46B5CFA42DDF9545616E169A567E764CE179E6321E6555D2C3A81768E2635D"
if ((Get-FileHash $installer -Algorithm SHA256).Hash -ne $expectedHash) {
    Remove-Item $installer -ErrorAction SilentlyContinue
    throw "Checksum verification failed for install-safe-chain.ps1"
}
& $installer
Remove-Item $installer

I comandi di installazione sopra fanno sempre riferimento a una release specifica. Per installare una versione diversa, sostituisci la versione con il numero della versione desiderata. Tutte le versioni disponibili sono nella pagina delle release.

Integrità del download

Gli script di installazione vengono serviti da un URL di release versionato (releases/download/1.5.16/...). Le release di GitHub sono immutabili — una volta che un artefatto viene pubblicato a un URL versionato non può essere modificato o sostituito, quindi il file che scarichi è garantito essere esattamente quello che è stato rilasciato.

Verifica l'installazione

❗Riavvia il terminale per iniziare a usare Aikido Safe Chain.
- Questo passaggio è cruciale poiché garantisce che gli alias di shell per npm, npx, yarn, pnpm, pnpx, rush, rushx, bun, bunx, pip, pip3, poetry, uv, uvx, pipx e pdm vengano caricati correttamente. Se non riavvii il terminale, gli alias non saranno disponibili.
Verifica l'installazione eseguendo il comando di verifica: ```shell npm safe-chain-verify pnpm safe-chain-verify pip safe-chain-verify uv safe-chain-verify

Any other supported package manager: {packagemanager} safe-chain-verify

L'output dovrebbe mostrare "OK: Safe-chain works!" a conferma che Aikido Safe Chain è installato e funzionante correttamente.

(Opzionale) Testa il blocco dei malware tentando di installare un pacchetto di test:

Per JavaScript/Node.js: ```shell npm install safe-chain-test

Per Python: ```shell pip3 install safe-chain-pi-test

- L'output dovrebbe mostrare che Aikido Safe Chain sta bloccando l'installazione di questi pacchetti di test poiché vengono segnalati come malware.

Quando si eseguono i comandi `npm`, `npx`, `yarn`, `pnpm`, `pnpx`, `rush`, `rushx`, `bun`, `bunx`, `pip`, `pip3`, `uv`, `uvx`, `poetry`, `pipx` e `pdm`, Aikido Safe Chain verificherà automaticamente la presenza di malware nei pacchetti che stai tentando di installare. Intercetta anche le invocazioni dei moduli Python per pip quando disponibili (ad es., `python -m pip install ...`, `python3 -m pip download ...`). Se viene rilevato un qualsiasi malware, ti verrà richiesto di uscire dal comando.

Puoi controllare la versione installata eseguendo:```shell
safe-chain --version

Come funziona

Blocco del malware

La Aikido Safe Chain funziona eseguendo un server proxy leggero che intercetta i download dei pacchetti dal registro npm e da PyPI. Quando esegui i comandi npm, npx, yarn, pnpm, pnpx, rush, rushx, bun, bunx, pip, pip3, uv, uvx, poetry, pipx o pdm, tutti i download dei pacchetti vengono instradati attraverso questo proxy locale, che verifica i pacchetti in tempo reale contro Aikido Intel - Open Sources Threat Intelligence. Se viene rilevato malware in qualsiasi pacchetto (incluse le dipendenze profonde), il proxy blocca il download prima che il codice dannoso raggiunga la tua macchina.

Età minima del pacchetto

Safe Chain applica controlli sull'età minima dei pacchetti per gli ecosistemi supportati.

L'applicazione attuale varia in base all'ecosistema:

Gestori di pacchetti basati su npm:
- durante la normale risoluzione dei pacchetti, Safe Chain sopprime le versioni più recenti rispetto all'età minima configurata dai metadati del pacchetto restituiti dal registro
- per le richieste di download diretto dei pacchetti che bypassano quel flusso di metadati, Safe Chain può bloccare la richiesta stessa utilizzando un elenco memorizzato nella cache dei pacchetti appena rilasciati
Gestori di pacchetti Python:
- durante la risoluzione dei pacchetti, Safe Chain sopprime file e release troppo recenti dalle risposte dei metadati di PyPI
- per le richieste di download diretto dei pacchetti che bypassano quel flusso di metadati, Safe Chain può bloccare la richiesta stessa utilizzando un elenco memorizzato nella cache dei pacchetti appena rilasciati

Per impostazione predefinita, l'età minima del pacchetto è di 48 ore. Questo fornisce un ulteriore livello di sicurezza durante il periodo critico in cui i pacchetti appena pubblicati sono più vulnerabili a contenere minacce non rilevate. Puoi configurare questa soglia o bypassare completamente questa protezione — consulta la sezione Configurazione dell'età minima del pacchetto qui sotto.

Integrazione con la shell

La Aikido Safe Chain si integra con la tua shell per fornire un'esperienza fluida quando utilizzi npm, npx, yarn, pnpm, pnpx, rush, rushx, bun, bunx e i gestori di pacchetti Python (pip, uv, uvx, poetry, pipx, pdm). Configura alias per questi comandi in modo che vengano avvolti dai comandi della Aikido Safe Chain, che gestiscono il server proxy prima di eseguire i comandi originali. Attualmente supportiamo:

✅ Bash
✅ Zsh
✅ Fish
✅ PowerShell
✅ PowerShell Core

Maggiori informazioni sull'integrazione con la shell sono disponibili nella documentazione sull'integrazione con la shell.

Disinstallazione

Per disinstallare la Aikido Safe Chain, utilizza il nostro disinstallatore a riga singola:

Unix/Linux/macOS```shell

curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/uninstall-safe-chain.sh | sh

### Windows (PowerShell)```powershell
iex (iwr "https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/uninstall-safe-chain.ps1" -UseBasicParsing)

❗Riavvia il terminale dopo la disinstallazione per assicurarti che tutti gli alias vengano rimossi.

Configurazione

Registrazione (Logging)

Puoi controllare l'output di Aikido Safe Chain utilizzando il flag --safe-chain-logging o la variabile d'ambiente SAFE_CHAIN_LOGGING.

Opzioni di Configurazione

Puoi impostare il livello di registrazione tramite più fonti (in ordine di priorità):

Argomento CLI (priorità più alta):
- --safe-chain-logging=silent - Sopprime tutto l'output di Aikido Safe Chain tranne quando il malware viene bloccato. L'output del gestore pacchetti viene scritto su stdout come di consueto, e Safe Chain scrive solo un breve messaggio se ha bloccato malware e causa l'uscita dal processo.
```
npm install express --safe-chain-logging=silent
```
- --safe-chain-logging=verbose - Abilita l'output diagnostico dettagliato da Aikido Safe Chain. Utile per risolvere problemi o per capire cosa Safe Chain sta facendo dietro le quinte.
```
npm install express --safe-chain-logging=verbose
```
Variabile d'Ambiente: ```shell export SAFE_CHAIN_LOGGING=verbose npm install express

Valori validi: silent, normal, verbose

Questo è utile per impostare un livello di logging predefinito per tutti i comandi del package manager nella tua sessione terminale o nell'ambiente CI/CD.

File Logging

Puoi rispecchiare l'output di Aikido Safe Chain su un file di log utilizzando il flag --safe-chain-log-file o la variabile d'ambiente SAFE_CHAIN_LOG_FILE. Il logging su file è disabilitato per impostazione predefinita e viene abilitato quando viene impostato un percorso. Il formato del file (--safe-chain-log-file-format) e la verbosità (--safe-chain-log-file-verbosity) sono controllati indipendentemente dall'output del terminale.

Opzioni di Configurazione

Impostabili tramite uno qualsiasi di questi (in ordine di priorità):

Argomento CLI (priorità più alta): ```shell npm install express
--safe-chain-log-file=~/safe-chain.log
--safe-chain-log-file-format=plain
--safe-chain-log-file-verbosity=normal
Variabile d'ambiente: ```shell export SAFE_CHAIN_LOG_FILE=~/safe-chain.log export SAFE_CHAIN_LOG_FILE_FORMAT=plain export SAFE_CHAIN_LOG_FILE_VERBOSITY=normal
File di configurazione (~/.safe-chain/config.json): ```json { "logFile": "~/safe-chain.log", "logFileFormat": "plain", "logFileVerbosity": "normal" }

logFileFormat — json (predefinito) o plain.

logFileVerbosity — silent, normal o verbose (predefinito). Indipendente da --safe-chain-logging.

Età Minima del Pacchetto

Puoi configurare per quanto tempo i pacchetti devono esistere prima che Safe Chain ne consenta l'installazione. Per impostazione predefinita, i pacchetti devono avere almeno 48 ore prima di poter essere installati.

Per i gestori di pacchetti basati su npm, questo controllo attualmente ha due modalità di applicazione:

Safe Chain sopprime le versioni troppo recenti dai metadati dei pacchetti durante la normale risoluzione delle dipendenze.
Safe Chain blocca le richieste dirette di download dei pacchetti quando vengono confrontate con l'elenco memorizzato nella cache dei pacchetti appena rilasciati.

Per i gestori di pacchetti Python, questo controllo attualmente ha due modalità di applicazione:

Safe Chain sopprime i file e le release troppo recenti dai metadati PyPI durante la risoluzione delle dipendenze.
Safe Chain blocca le richieste dirette di download dei pacchetti quando vengono confrontate con l'elenco memorizzato nella cache dei pacchetti appena rilasciati.

Opzioni di Configurazione

Puoi impostare l'età minima del pacchetto tramite più fonti (in ordine di priorità):

Argomento CLI (priorità più alta): ```shell npm install express --safe-chain-minimum-package-age-hours=48
Variabile d'ambiente: ```shell export SAFE_CHAIN_MINIMUM_PACKAGE_AGE_HOURS=48 npm install express
File di configurazione (~/.safe-chain/config.json): ```json { "minimumPackageAgeHours": 48 }

Esclusione dei pacchetti

Escludi i pacchetti attendibili dal filtro dell'età minima tramite variabile d'ambiente o file di configurazione (entrambi vengono uniti). Usa @scope/* per considerare attendibili tutti i pacchetti di un'organizzazione:```shell export SAFE_CHAIN_MINIMUM_PACKAGE_AGE_EXCLUSIONS="@aikidosec/*"

🛡️ Caratteristiche di Sicurezza

Crittografia End-to-End: Tutti i dati sono crittografati prima di lasciare il dispositivo.
Autenticazione a Due Fattori (2FA): Supporto per TOTP e chiavi hardware.
Controllo degli Accessi Basato sui Ruoli (RBAC): Permessi granulari per ogni utente.
Registrazione di Controllo: Traccia completa di tutte le azioni amministrative.
Conformità GDPR: Conforme al Regolamento Generale sulla Protezione dei Dati.

🚀 Guida Rapida

Installazione

git clone https://github.com/example/security-tool.git
cd security-tool
pip install -r requirements.txt

Configurazione

Copia il file di configurazione di esempio:
```
cp config.example.yml config.yml
```
Modifica config.yml con le tue impostazioni.
Avvia lo strumento:
```
python main.py --config config.yml
```

Utilizzo di Base

from security_tool import Scanner

scanner = Scanner()
results = scanner.scan("target.example.com")
print(results)

📚 Documentazione

Per una documentazione completa, consulta la Wiki.

🤝 Contributi

I contributi sono benvenuti! Per favore, leggi il file CONTRIBUTING.md per i dettagli sul nostro codice di condotta e il processo per inviare pull request.

📄 Licenza

Questo progetto è concesso in licenza sotto la Licenza MIT - vedi il file LICENSE per i dettagli.

📬 Contatti

Sito Web: https://security-tool.example.com
Email: [email protected]
Twitter: @SecurityTool

{
  "npm": {
    "minimumPackageAgeExclusions": ["@aikidosec/*"]
  },
  "pip": {
    "minimumPackageAgeExclusions": ["requests"]
  }
}
```
## Registri Personalizzati

Configura Safe Chain per analizzare i pacchetti provenienti da registri personalizzati o privati.

Ecosistemi supportati:

- Node.js
- Python

### Opzioni di Configurazione

Puoi impostare registri personalizzati tramite variabile d'ambiente o file di configurazione. Entrambe le fonti vengono unite insieme.

1. **Variabile d'Ambiente** (separata da virgole):   ```shell
   export SAFE_CHAIN_NPM_CUSTOM_REGISTRIES="npm.company.com,registry.internal.net"
   export SAFE_CHAIN_PIP_CUSTOM_REGISTRIES="pip.company.com,registry.internal.net"
   ```
2. **File di configurazione** (`~/.safe-chain/config.json`):   ```json
   {
     "npm": {
       "customRegistries": ["npm.company.com", "registry.internal.net"]
     },
     "pip": {
       "customRegistries": ["pip.company.com", "registry.internal.net"]
     }
   }
   ```
## File di configurazione PYPI

Se fai affidamento su un file `pip.conf` per la configurazione di pip, devi indicarlo esplicitamente a pip tramite la variabile d'ambiente `PIP_CONFIG_FILE` affinché Safe Chain possa unirlo.

Safe Chain esegue pip dietro il suo proxy MITM e scrive un file di configurazione pip temporaneo per iniettare il suo certificato e le impostazioni del proxy. Quando `PIP_CONFIG_FILE` è impostato, Safe Chain unisce le sue impostazioni in una copia del tuo file (il tuo file originale non viene mai modificato), così la tua `index-url`, le credenziali e le altre opzioni vengono preservate. Quando `PIP_CONFIG_FILE` non è impostato, la configurazione a livello utente di pip (ad es. `~/.config/pip/pip.conf`) potrebbe essere sovrascritta dal file temporaneo di Safe Chain e le tue impostazioni non verranno rilevate.

## URL di base dell'elenco malware

Configura Safe Chain per recuperare i database malware e gli elenchi di nuovi pacchetti da un URL mirror personalizzato. Questo ti consente di ospitare una tua copia del database malware di Aikido.

### Opzioni di configurazione

Puoi impostare l'URL di base dell'elenco malware tramite più fonti (in ordine di priorità):

1. **Argomento CLI** (priorità più alta):   ```shell
   npm install express --safe-chain-malware-list-base-url=https://your-mirror.com
   ```
2. **Variabile d'ambiente**:   ```shell
   export SAFE_CHAIN_MALWARE_LIST_BASE_URL=https://your-mirror.com
   npm install express
   ```
3. **File di configurazione** (`~/.safe-chain/config.json`):   ```json
   {
     "malwareListBaseUrl": "https://your-mirror.com"
   }
   ```
L'URL di base deve puntare a un server che rispecchi la struttura di `https://malware-list.aikido.dev/`, incluse le seguenti path:
- `/malware_predictions.json` (database di malware per l'ecosistema JavaScript)
- `/malware_pypi.json` (database di malware per l'ecosistema Python)
- `/releases/npm.json` (elenco dei nuovi pacchetti JavaScript)
- `/releases/pypi.json` (elenco dei nuovi pacchetti Python)

## File di configurazione del progetto

Oltre al file di configurazione nella home directory (`~/.safe-chain/config.json`), Safe Chain supporta un file di configurazione del progetto, così che le impostazioni possano essere salvate in un repository e condivise tra un team, invece di essere configurate per ogni macchina.

Aggiungi una sezione `safe-chain:` al file `.aikido` nella root del tuo repository (lo stesso file usato da altri strumenti Aikido; Safe Chain legge solo la propria sezione `safe-chain:` e ignora il resto). Quando viene trovato, le sue impostazioni vengono unite sopra al file di configurazione della home directory: i valori impostati nella configurazione del progetto hanno priorità, e gli array (come `customRegistries`) vengono combinati da entrambi i file anziché essere sostituiti da uno solo.

Solo le seguenti impostazioni possono essere definite da un file di configurazione del progetto:```yaml
safe-chain:
  minimumPackageAgeHours: 48
  npm:
    customRegistries:
      - npm.company.com
    minimumPackageAgeExclusions:
      - "@aikidosec/*"
  pip:
    customRegistries:
      - pip.company.com
    minimumPackageAgeExclusions:
      - requests
```
Le impostazioni come `scanTimeout`, `malwareListBaseUrl` e le opzioni `logFile*` non possono essere impostate da un file di configurazione del progetto - possono provenire solo dalla configurazione nella tua directory home, dagli argomenti della CLI o dalle variabili d'ambiente.

## Directory di Installazione Personalizzata

Per impostazione predefinita, Safe Chain si installa in `~/.safe-chain`. Puoi modificare questo comportamento passando una directory di installazione esplicita al programma di installazione. Questo è utile per installazioni a livello di sistema (ad es. all'interno di un'immagine Docker) o quando devi evitare conflitti con altri strumenti.

Quando viene impostata, tutti i dati di Safe Chain (binario, shim, script, configurazione) vengono collocati nella directory personalizzata invece che in `~/.safe-chain`.

### Unix/Linux/macOS```shell
curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh \
  && echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839  /tmp/install-safe-chain.sh" | sha256sum -c - \
  && sh /tmp/install-safe-chain.sh --install-dir /usr/local/.safe-chain \
  && rm /tmp/install-safe-chain.sh
```
### Windows```powershell
$installer = Join-Path $env:TEMP "install-safe-chain.ps1"
Invoke-WebRequest "https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.ps1" -OutFile $installer -UseBasicParsing
$expectedHash = "6F46B5CFA42DDF9545616E169A567E764CE179E6321E6555D2C3A81768E2635D"
if ((Get-FileHash $installer -Algorithm SHA256).Hash -ne $expectedHash) {
    Remove-Item $installer -ErrorAction SilentlyContinue
    throw "Checksum verification failed for install-safe-chain.ps1"
}
& $installer -InstallDir 'C:\ProgramData\safe-chain'
Remove-Item $installer
```
# Utilizzo in CI/CD

Puoi proteggere le tue pipeline CI/CD da pacchetti dannosi integrando Aikido Safe Chain nel tuo processo di build. Questo garantisce che qualsiasi pacchetto installato durante le build automatizzate venga controllato per malware prima dell'installazione.

## Installazione per CI/CD

Usa il flag `--ci` per configurare automaticamente Aikido Safe Chain per ambienti CI/CD. Questo configura shim eseguibili nel PATH invece di alias di shell.

### Unix/Linux/macOS (GitHub Actions, Azure Pipelines, ecc.)```shell
curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh \
  && echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839  /tmp/install-safe-chain.sh" | sha256sum -c - \
  && sh /tmp/install-safe-chain.sh --ci \
  && rm /tmp/install-safe-chain.sh
```
### Windows (Azure Pipelines, ecc.)```powershell
$installer = Join-Path $env:TEMP "install-safe-chain.ps1"
Invoke-WebRequest "https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.ps1" -OutFile $installer -UseBasicParsing
$expectedHash = "6F46B5CFA42DDF9545616E169A567E764CE179E6321E6555D2C3A81768E2635D"
if ((Get-FileHash $installer -Algorithm SHA256).Hash -ne $expectedHash) {
    Remove-Item $installer -ErrorAction SilentlyContinue
    throw "Checksum verification failed for install-safe-chain.ps1"
}
& $installer -ci
Remove-Item $installer
```
## Piattaforme Supportate

- ✅ **GitHub Actions**
- ✅ **Azure Pipelines**
- ✅ **CircleCI**
- ✅ **Jenkins**
- ✅ **Bitbucket Pipelines**
- ✅ **GitLab Pipelines**

## Esempio GitHub Actions```yaml
- name: Setup Node.js
  uses: actions/setup-node@v4
  with:
    node-version: "22"
    cache: "npm"

- name: Install safe-chain
  run: |
    curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh
    echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839  /tmp/install-safe-chain.sh" | sha256sum -c -
    sh /tmp/install-safe-chain.sh --ci
    rm /tmp/install-safe-chain.sh

- name: Install dependencies
  run: npm ci
```
## Esempio di Azure DevOps```yaml
- task: NodeTool@0
  inputs:
    versionSpec: "22.x"
  displayName: "Install Node.js"

- script: |
    curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh
    echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839  /tmp/install-safe-chain.sh" | sha256sum -c -
    sh /tmp/install-safe-chain.sh --ci
    rm /tmp/install-safe-chain.sh
  displayName: "Install safe-chain"

- script: npm ci
  displayName: "Install dependencies"
```
## Esempio CircleCI```yaml
version: 2.1
jobs:
  build:
    docker:
      - image: cimg/node:lts
    steps:
      - checkout
      - run: |
          curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh
          echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839  /tmp/install-safe-chain.sh" | sha256sum -c -
          sh /tmp/install-safe-chain.sh --ci
          rm /tmp/install-safe-chain.sh
      - run: npm ci
workflows:
  build_and_test:
    jobs:
      - build
```
## Esempio Jenkins

Nota: si presuppone che Node.js e npm siano installati sull'agente Jenkins.```groovy
pipeline {
  agent any

  environment {
    // Jenkins does not automatically persist PATH updates from setup-ci,
    // so add the shims + binary directory explicitly for all stages.
    // If you installed into a custom directory, replace ~/.safe-chain with that path here.
    PATH = "${env.HOME}/.safe-chain/shims:${env.HOME}/.safe-chain/bin:${env.PATH}"
  }

  stages {
    stage('Install safe-chain') {
      steps {
        sh '''
          set -euo pipefail

          # Install Safe Chain for CI
          curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh
          echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839  /tmp/install-safe-chain.sh" | sha256sum -c -
          sh /tmp/install-safe-chain.sh --ci
          rm /tmp/install-safe-chain.sh
        '''
      }
    }

    stage('Install project dependencies etc...') {
      steps {
        sh '''
          set -euo pipefail
          npm ci
        '''
      }
    }
  }
}
```
## Esempio di Bitbucket Pipelines```yaml
image: node:22

steps:
  - step:
      name: Install
      script:
        - |
          curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh
          echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839  /tmp/install-safe-chain.sh" | sha256sum -c -
          sh /tmp/install-safe-chain.sh --ci
          rm /tmp/install-safe-chain.sh
        - export PATH=~/.safe-chain/shims:~/.safe-chain/bin:$PATH
        - npm ci
```
Dopo la configurazione, tutti i successivi comandi del package manager nella tua pipeline CI saranno automaticamente protetti dal rilevamento malware di Aikido Safe Chain.

## Esempio di pipeline GitLab

Per aggiungere safe-chain nelle pipeline GitLab, devi installarlo nell'immagine che esegue la pipeline. Questo può essere fatto:

1. Definendo un dockerfile per eseguire la tua build   ```dockerfile
   FROM node:lts

   # Install safe-chain
   RUN curl -fsSL https://github.com/AikidoSec/safe-chain/releases/download/1.5.16/install-safe-chain.sh -o /tmp/install-safe-chain.sh \
     && echo "7a7b6e54c2e0adbcb53bc1bf7d258cc974f8f31e77ed048b88e4d2e4ac758839  /tmp/install-safe-chain.sh" | sha256sum -c - \
     && sh /tmp/install-safe-chain.sh --ci \
     && rm /tmp/install-safe-chain.sh

   # Add safe-chain to PATH (update paths if you used a custom install dir)
   ENV PATH="/root/.safe-chain/shims:/root/.safe-chain/bin:${PATH}"
   ```
2. Crea l'immagine Docker nella tua pipeline CI   ```yaml
   build-image:
     stage: build-image
     image: docker:latest
     services:
       - docker:dind
     script:
       - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
       - docker build -t $CI_REGISTRY_IMAGE:latest .
       - docker push $CI_REGISTRY_IMAGE:latest
   ```
3. Usa l'immagine nella tua pipeline:   ```yaml
   npm-ci:
     stage: install
     image: $CI_REGISTRY_IMAGE:latest
     script:
       - npm ci
   ```
La pipeline completa per questo esempio si presenta così:```yaml
stages:
  - build-image
  - install

build-image:
  stage: build-image
  image: docker:latest
  services:
    - docker:dind
  script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker build -t $CI_REGISTRY_IMAGE:latest .
    - docker push $CI_REGISTRY_IMAGE:latest

npm-ci:
  stage: install
  image: $CI_REGISTRY_IMAGE:latest
  script:
    - npm ci
```
# Risoluzione dei problemi

Hai problemi? Consulta la [Guida alla risoluzione dei problemi](https://github.com/aikidosec/safe-chain/blob/main/docs/troubleshooting.md) per assistenza con i problemi più comuni.

# Segnala problemi

Se incontri problemi:

1. Visita [GitHub Issues](https://github.com/AikidoSec/safe-chain/issues)
2. Includi:
   * Sistema operativo e versione
   * Tipo di shell e versione
   * Output di `safe-chain --version`
   * Output dei comandi di verifica
   * Log dettagliati del comando che fallisce (aggiungi l'argomento `--safe-chain-logging=verbose`)

safe-chain v1.5.16

Categorie

safe-chain v1.5.16

Aikido Safe Chain

Hai bisogno di protezione oltre npm e PyPI?

Utilizzo

Installazione

Unix/Linux/macOS```shell

Integrità del download

Verifica l'installazione

Any other supported package manager: {packagemanager} safe-chain-verify

Come funziona

Blocco del malware

Età minima del pacchetto

Integrazione con la shell

Disinstallazione

Unix/Linux/macOS```shell

Configurazione

Registrazione (Logging)

Opzioni di Configurazione

File Logging

Opzioni di Configurazione

Età Minima del Pacchetto

Opzioni di Configurazione

Esclusione dei pacchetti

🛡️ Caratteristiche di Sicurezza

🚀 Guida Rapida

Installazione

Configurazione

Utilizzo di Base

📚 Documentazione

🤝 Contributi

📄 Licenza

📬 Contatti

Categorie