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,stagingouprod. - INFISICAL_MACHINE_ENV_FILE : fichier d'environnement local optionnel contenant
INFISICAL_CLIENT_ID,INFISICAL_CLIENT_SECRET,INFISICAL_DOMAINetINFISICAL_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
| Commande | Objectif |
|---|---|
/infisical-cli-secrets recon | Inspecter un dépôt et décider comment les secrets doivent circuler. |
/infisical-cli-secrets auth | S'authentifier en toute sécurité avec une connexion utilisateur ou une identité machine. |
/infisical-cli-secrets run | Encapsuler une commande avec injection de secrets Infisical. |
/infisical-cli-secrets sync | Ajouter, mettre à jour ou auditer des clés de secrets sans divulguer les valeurs. |
/infisical-cli-secrets pawrrtal | Appliquer 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.
| Commande | Livre de cuisine | Quand l'utiliser |
|---|---|---|
| recon | cookbook/recon.md | Vous devez comprendre les fichiers d'environnement, la configuration et les plans de secrets d'un dépôt. |
| auth | cookbook/auth.md | Vous avez besoin d'une session CLI sécurisée ou d'un jeton machine. |
| run | cookbook/run.md | Vous devez démarrer une commande avec des secrets injectés. |
| sync | cookbook/sync.md | Vous devez définir, importer, comparer ou vérifier des clés de secrets. |
| pawrrtal | cookbook/pawrrtal.md | Le 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é
- N'imprimez jamais les valeurs des secrets. Évitez
infisical secrets --plain,infisical export, ouprintenvsauf si la sortie est redirigée vers un fichier protégé et que l'utilisateur l'a explicitement demandé. - 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 permissions0600. - Pour les instances auto-hébergées, passez
--domainà chaque commande ou exportezINFISICAL_API_URL/INFISICAL_DOMAIN. - 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. - 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