Skip to Content
SecaniDocumentation

Secani CLI

Travaillez avec votre SMSI Secani depuis le terminal, dans des scripts et depuis des agents de code.

La CLI Secani, secani, apporte vos risques, tâches, constats, mesures et incidents dans le terminal. Les personnes l'utilisent pour des consultations et des modifications rapides, les scripts shell lisent sa sortie JSON, et les agents de code comme Claude Code, Codex ou Cursor peuvent travailler avec votre SMSI sans configurer MCP eux-mêmes. Elle communique avec Secani MCP et dispose des mêmes autorisations que votre compte.

Installer

npm install --global secani

Ou lancez-la sans l'installer :

npx secani login

La CLI nécessite Node.js 22.12 ou plus récent et un compte Secani. Elle est open source sous licence Apache-2.0 : github.com/secani/cli.

Se connecter

secani login

La CLI affiche une page de connexion et un code, puis ouvre la page dans votre navigateur. Connectez-vous avec votre compte Secani et confirmez le code dans les cinq minutes. Via SSH ou dans un conteneur, utilisez secani login --no-open et ouvrez la page sur n'importe quel appareil.

La connexion est enregistrée uniquement pour votre utilisateur, dans ~/.config/secani/auth.json (changez le répertoire avec SECANI_CONFIG_DIR), et se renouvelle d'elle-même. secani whoami affiche le compte et l'espace de travail actuel, et secani logout supprime la connexion de cet ordinateur.

La connexion démarre en lecture seule. Pour créer ou modifier des enregistrements, autorisez l'écriture pour Secani CLI dans l'application Secani, sous Paramètres > Intégrations. La même page met fin à la connexion.

Choisir un espace de travail

secani workspaces list
secani workspaces switch acme/isms

Les espaces de travail s'écrivent <organisation>/<espace>. Passez --workspace acme/isms ou définissez SECANI_WORKSPACE pour en choisir un pour une seule commande. S'il n'y en a qu'un, la CLI l'utilise automatiquement.

Commandes

CommandeCe qu'elle fait
secani login, logout, whoamiSe connecter et se déconnecter, afficher le compte et l'espace de travail actuel
secani workspaces list, switchLister les espaces de travail et choisir l'actuel
secani risks list, inspect, create, update, deleteLe registre des risques
secani controls list, inspectMesures (contrôles)
secani findings list, inspectConstats d'audit et d'évaluation
secani tasks list, inspect, create, update, archive, restoreTâches
secani incidents list, create, updateIncidents de sécurité
secani search <requête>Actifs, tâches, exigences et preuves
secani tools list, inspect, callChaque outil de Secani MCP

Chaque commande explique ses options avec --help, et secani help search <mots> trouve la commande pour une tâche. Quelques exemples :

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 de phishing ouvert" --severity high
secani search backup --framework "ISO 27001"

Les commandes qui travaillent dans un framework, comme créer un risque ou rechercher des exigences, acceptent --framework avec le nom ou l'ID du framework, ou utilisent le seul framework de l'espace de travail.

Scripts et agents de code

  • --json affiche exactement un document JSON et ne pose jamais de question. Les listes renvoient les enregistrements et un curseur pagination.next ; les modifications renvoient l'enregistrement, un outcome comme created ou updated et la commande pour le consulter.
  • Les erreurs sont une seule ligne JSON sur stderr avec un reason stable, par exemple login_required ou missing_workspace, et status: "action_required" lorsqu'une saisie ou l'approbation d'une personne permettrait d'exécuter la commande.
  • La sortie redirigée est séparée par des tabulations, avec une ligne d'en-tête et des dates ISO. Une modification redirigée n'affiche que l'ID de l'enregistrement.
  • Les agents de code sont reconnus automatiquement : ils ne reçoivent jamais de question et indiquent toujours l'espace de travail avec --workspace ou SECANI_WORKSPACE.
  • Supprimer un risque, archiver une tâche et les outils MCP destructifs demandent une confirmation. Sans terminal, ils exigent --yes, qu'un agent ne doit ajouter qu'après l'approbation d'une personne.
  • Chaque modification porte une clé d'idempotence. Si la connexion se coupe après l'envoi d'une modification, la CLI affiche la commande pour la répéter avec --request-id ; Secani l'applique au plus une fois.
  • --limit est le nombre total de résultats sur toutes les pages, et --next <curseur> poursuit une liste avec les mêmes filtres.

Codes de sortie : 0 terminé (y compris résultats vides et rien à faire), 1 échec, 2 utilisation incorrecte ou saisie manquante, 130 annulé.

Variables d'environnement

VariableEffet
SECANI_WORKSPACEEspace de travail pour chaque commande ; doit correspondre à --workspace si les deux sont définis
SECANI_TOKENUn jeton d'accès pour Secani MCP à la place de la connexion enregistrée. Les jetons sont de courte durée
SECANI_CONFIG_DIRRépertoire de la connexion et des paramètres
SECANI_ACCESSIBLE=1Des mots au lieu de symboles
SECANI_GUIDANCE_DISABLED=1Pas d'étapes suivantes facultatives
NO_COLOR, FORCE_COLORDésactiver ou forcer la couleur
CIExécuter sans questions

Code source et retours

La CLI est développée ouvertement sur github.com/secani/cli et publiée sur npm sous le nom secani. Signalez bugs et idées dans les issues GitHub, et les problèmes de sécurité de manière confidentielle via l'onglet Security du dépôt.