Communitygithub.com

Infisical CLI Secrets

Utilisez proprement l'interface CLI Infisical pour l'injection de secrets, l'authentification d'identité machine et les workflows de secrets Pawrrtal.

Qu'est-ce que Infisical CLI Secrets ?

Cette compétence fournit une interface structurée pour interagir avec l'outil CLI Infisical afin de gérer les secrets de manière sécurisée, sans jamais exposer les valeurs dans les logs, le chat ou les fichiers suivis. Elle prend en charge l'authentification par connexion utilisateur ou par identité machine, l'injection de secrets à la volée via `infisical run` pour les processus locaux, de service ou CI, et la synchronisation des clés de secrets sans fuite de valeurs. La compétence inclut également un support pour le modèle Pawrrtal, permettant d'appliquer des conventions propres aux secrets de passerelle et d'espace de travail. Chaque commande est accompagnée d'un livre de cuisine détaillé qui doit être lu avant exécution, garantissant que les développeurs suivent les meilleures pratiques pour chaque opération.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add OctavianTocan/infisical-cli-secrets

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Secrets CLI Infisical

Utilisez l'interface CLI Infisical comme frontière de vérité pour les secrets : authentifiez-vous en toute sécurité, injectez des secrets dans les processus avec infisical run, et évitez de copier des valeurs dans le chat, les logs ou les fichiers suivis. Privilégiez l'injection au moment du processus et les surfaces de secrets natives du projet plutôt que des fichiers .env écrits manuellement.

Variables

  • INFISICAL_DOMAIN : domaine auto-hébergé ou cloud, par exemple https://infisical.example.internal.
  • INFISICAL_PROJECT_ID : UUID du projet Infisical.
  • INFISICAL_ENV : slug d'environnement, généralement dev, staging ou prod.
  • INFISICAL_MACHINE_ENV_FILE : fichier d'environnement local optionnel contenant INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET, INFISICAL_DOMAIN et INFISICAL_PROJECT_ID.
  • PAWRRTAL_REPO : chemin de checkout Pawrrtal optionnel lors de l'application du livre de cuisine Pawrrtal.

Fonctionnement

Classez d'abord la surface de secret : processus de développement local, processus de service, CI, ou secrets d'espace de travail/utilisateur applicatifs. Ensuite, authentifiez-vous avec une connexion utilisateur ou une identité machine, exécutez le test de fumée le plus petit et le plus sûr, et injectez les secrets à la frontière du processus avec infisical run sauf si l'application cible possède son propre coffre de secrets chiffré.

Commandes

CommandeObjectif
/infisical-cli-secrets reconInspecter un dépôt et décider comment les secrets doivent circuler.
/infisical-cli-secrets authS'authentifier en toute sécurité avec une connexion utilisateur ou une identité machine.
/infisical-cli-secrets runEncapsuler une commande avec injection de secrets Infisical.
/infisical-cli-secrets syncAjouter, mettre à jour ou auditer des clés de secrets sans divulguer les valeurs.
/infisical-cli-secrets pawrrtalAppliquer le modèle propre aux secrets de passerelle et d'espace de travail Pawrrtal.

Livre de cuisine

Chaque commande dispose d'un guide détaillé étape par étape. Lisez le fichier de livre de cuisine correspondant avant d'exécuter une commande.

CommandeLivre de cuisineQuand l'utiliser
reconcookbook/recon.mdVous devez comprendre les fichiers d'environnement, la configuration et les plans de secrets d'un dépôt.
authcookbook/auth.mdVous avez besoin d'une session CLI sécurisée ou d'un jeton machine.
runcookbook/run.mdVous devez démarrer une commande avec des secrets injectés.
synccookbook/sync.mdVous devez définir, importer, comparer ou vérifier des clés de secrets.
pawrrtalcookbook/pawrrtal.mdLe dépôt est Pawrrtal ou utilise ses conventions paw/workspace-env.

Lorsqu'un utilisateur invoque /infisical-cli-secrets, lisez d'abord le fichier de livre de cuisine correspondant, puis exécutez les étapes.

Règles de sécurité

  1. N'imprimez jamais les valeurs des secrets. Évitez infisical secrets --plain, infisical export, ou printenv sauf si la sortie est redirigée vers un fichier protégé et que l'utilisateur l'a explicitement demandé.
  2. Privilégiez infisical run -- <commande> plutôt que d'écrire un .env. N'utilisez un fichier que lorsque l'outil cible ne peut pas accepter les variables d'environnement de processus, et définissez les permissions 0600.
  3. Pour les instances auto-hébergées, passez --domain à chaque commande ou exportez INFISICAL_API_URL/INFISICAL_DOMAIN.
  4. Pour les identités machine, capturez le jeton dans INFISICAL_TOKEN ; ne passez pas les jetons directement dans les chaînes de commande et ne les stockez pas dans des fichiers suivis.
  5. Traitez les suppressions comme à haut risque. Confirmez l'intention, vérifiez le nom de la clé et l'environnement, et privilégiez la suppression via l'interface utilisateur/l'API si le chemin de suppression en CLI installé est connu comme défectueux.

Compétences associées

Fonctionne avec : /tailscale, /dev-box, /deploy-checklist

Skills associés