Skip to Content
SecaniDocumentazione

Secani CLI

Lavora con il tuo SGSI Secani dal terminale, negli script e dagli agenti di programmazione.

La CLI di Secani, secani, porta nel terminale rischi, compiti, rilievi, misure e incidenti. Le persone la usano per consultazioni e modifiche rapide, gli script di shell leggono il suo output JSON e gli agenti di programmazione come Claude Code, Codex o Cursor possono lavorare con il tuo SGSI senza configurare MCP per conto proprio. Comunica con Secani MCP e ha gli stessi permessi del tuo account.

Installazione

npm install --global secani

Oppure eseguila senza installarla:

npx secani login

La CLI richiede Node.js 22.12 o successivo e un account Secani. È open source con licenza Apache-2.0: github.com/secani/cli.

Accedere

secani login

La CLI mostra una pagina di accesso e un codice e apre la pagina nel browser. Accedi con il tuo account Secani e conferma il codice entro cinque minuti. Via SSH o in un container, usa secani login --no-open e apri la pagina su qualsiasi dispositivo.

L'accesso viene salvato solo per il tuo utente, in ~/.config/secani/auth.json (cambia la cartella con SECANI_CONFIG_DIR), e si rinnova da solo. secani whoami mostra l'account e lo spazio di lavoro attuale, e secani logout rimuove l'accesso da questo computer.

La connessione parte in sola lettura. Per creare o modificare record, consenti la scrittura per Secani CLI nell'app Secani, in Impostazioni > Integrazioni. Dalla stessa pagina puoi chiudere la connessione.

Scegliere uno spazio di lavoro

secani workspaces list
secani workspaces switch acme/isms

Gli spazi di lavoro si chiamano <organizzazione>/<spazio>. Usa --workspace acme/isms o imposta SECANI_WORKSPACE per sceglierne uno per un singolo comando. Se ne hai solo uno, la CLI lo usa automaticamente.

Comandi

ComandoCosa fa
secani login, logout, whoamiAccedere e uscire, mostrare l'account e lo spazio di lavoro attuale
secani workspaces list, switchElencare gli spazi di lavoro e scegliere quello attuale
secani risks list, inspect, create, update, deleteIl registro dei rischi
secani controls list, inspectMisure (controlli)
secani findings list, inspectRilievi di audit e valutazioni
secani tasks list, inspect, create, update, archive, restoreCompiti
secani incidents list, create, updateIncidenti di sicurezza
secani search <ricerca>Asset, compiti, requisiti ed evidenze
secani tools list, inspect, callOgni strumento di Secani MCP

Ogni comando spiega le sue opzioni con --help, e secani help search <parole> trova il comando per un compito. Alcuni esempi:

secani tasks list --assignee me --open
secani risks list --min-level high
secani tasks update TASK-12 --status done
secani incidents create --title "E-mail di phishing aperta" --severity high
secani search backup --framework "ISO 27001"

I comandi che lavorano in un framework, come creare un rischio o cercare requisiti, accettano --framework con il nome o l'ID del framework, oppure usano l'unico framework dello spazio di lavoro.

Script e agenti di programmazione

  • --json stampa esattamente un documento JSON e non fa mai domande. Gli elenchi restituiscono i record e un cursore pagination.next; le modifiche restituiscono il record, un outcome come created o updated e il comando per consultarlo.
  • Gli errori sono una singola riga JSON su stderr con un reason stabile, per esempio login_required o missing_workspace, e status: "action_required" quando un dato o l'approvazione di una persona permetterebbe di eseguire il comando.
  • L'output reindirizzato è separato da tabulazioni, con una riga di intestazione e date ISO. Una modifica reindirizzata stampa solo l'ID del record.
  • Gli agenti di programmazione vengono riconosciuti automaticamente: non ricevono mai domande e indicano sempre lo spazio di lavoro con --workspace o SECANI_WORKSPACE.
  • Eliminare un rischio, archiviare un compito e gli strumenti MCP distruttivi chiedono conferma. Senza terminale richiedono --yes, che un agente dovrebbe aggiungere solo dopo l'approvazione di una persona.
  • Ogni modifica porta una chiave di idempotenza. Se la connessione cade dopo l'invio di una modifica, la CLI mostra il comando per ripeterla con --request-id; Secani la applica al massimo una volta.
  • --limit è il numero totale di risultati su tutte le pagine, e --next <cursore> continua un elenco con gli stessi filtri.

Codici di uscita: 0 completato (anche risultati vuoti e nulla da fare), 1 non riuscito, 2 uso errato o dato mancante, 130 annullato.

Variabili d'ambiente

VariabileEffetto
SECANI_WORKSPACESpazio di lavoro per ogni comando; deve corrispondere a --workspace se sono impostati entrambi
SECANI_TOKENUn token di accesso per Secani MCP al posto dell'accesso salvato. I token durano poco
SECANI_CONFIG_DIRCartella per l'accesso e le impostazioni
SECANI_ACCESSIBLE=1Parole al posto dei simboli
SECANI_GUIDANCE_DISABLED=1Nessun passo successivo facoltativo
NO_COLOR, FORCE_COLORDisattivare o forzare il colore
CIEseguire senza domande

Codice sorgente e feedback

La CLI è sviluppata apertamente su github.com/secani/cli e pubblicata su npm come secani. Segnala bug e idee come issue di GitHub, e i problemi di sicurezza in modo riservato tramite la scheda Security del repository.