Was macht Infisical CLI Secrets?
Verwende die Infisical CLI als maßgebliche Grenze für Geheimnisse (Secrets): Authentifiziere dich sicher, injiziere Secrets in Prozesse mit infisical run und vermeide das Kopieren von Werten in Chats, Logs oder versionierte Dateien. Bevorzuge die Injektion zur Laufzeit sowie projektnative Secret-Oberflächen gegenüber manuell geschriebenen .env-Dateien.
Variablen
- INFISICAL_DOMAIN: Domain der selbst gehosteten oder Cloud-Instanz, z. B.
https://infisical.example.internal. - INFISICAL_PROJECT_ID: UUID des Infisical-Projekts.
- INFISICAL_ENV: Umgebungs-Slug, normalerweise
dev,stagingoderprod. - INFISICAL_MACHINE_ENV_FILE: optionale lokale Umgebungsdatei mit
INFISICAL_CLIENT_ID,INFISICAL_CLIENT_SECRET,INFISICAL_DOMAINundINFISICAL_PROJECT_ID. - PAWRRTAL_REPO: optionaler Pawrrtal-Checkout-Pfad bei Anwendung des Pawrrtal-Cookbooks.
Funktionsweise
Klassifiziere zuerst die Secret-Oberfläche: lokaler Entwicklungsprozess, Dienstprozess, CI oder anwendungseigene Arbeitsbereichs-/Benutzersecrets. Authentifiziere dich dann über Benutzer-Login oder Maschinenidentität, führe den kleinstmöglichen sicheren Test durch und injiziere Secrets an der Prozessgrenze mit infisical run, es sei denn, die Zielanwendung verfügt über einen eigenen verschlüsselten Secret-Speicher.
Befehle
| Befehl | Zweck |
|---|---|
/infisical-cli-secrets recon | Untersuche ein Repository und entscheide, wie Secrets fließen sollen. |
/infisical-cli-secrets auth | Sichere Authentifizierung per Benutzer-Login oder Maschinenidentität. |
/infisical-cli-secrets run | Umhülle einen Befehl mit Infisical-Secret-Injektion. |
/infisical-cli-secrets sync | Füge Secret-Keys hinzu, aktualisiere oder überprüfe sie, ohne Werte preiszugeben. |
/infisical-cli-secrets pawrrtal | Wende das saubere Muster auf Pawrrtal-Gateway- und Arbeitsbereichs-Secrets an. |
Cookbook
Jeder Befehl enthält eine detaillierte Schritt-für-Schritt-Anleitung. Lies die entsprechende Cookbook-Datei, bevor du einen Befehl ausführst.
| Befehl | Cookbook | Verwende, wenn … |
|---|---|---|
| recon | cookbook/recon.md | Du die Umgebungsdateien, Konfiguration und Secret-Ebenen eines Repos verstehen musst. |
| auth | cookbook/auth.md | Du eine sichere CLI-Sitzung oder ein Maschinentoken benötigst. |
| run | cookbook/run.md | Du einen Befehl mit injizierten Secrets starten musst. |
| sync | cookbook/sync.md | Du Secret-Keys setzen, importieren, vergleichen oder überprüfen musst. |
| pawrrtal | cookbook/pawrrtal.md | Das Repository Pawrrtal ist oder dessen paw-/workspace-env-Konventionen verwendet. |
Wenn ein Benutzer /infisical-cli-secrets aufruft, lies zuerst die passende Cookbook-Datei und führe dann die Schritte aus.
Sicherheitsregeln
- Gib niemals Secret-Werte aus. Vermeide
infisical secrets --plain,infisical exportoderprintenv, es sei denn, die Ausgabe wird in eine geschützte Datei umgeleitet und der Benutzer hat dies ausdrücklich verlangt. - Bevorzuge
infisical run -- <befehl>gegenüber dem Schreiben einer.env-Datei. Verwende eine Datei nur, wenn das Zielwerkzeug keine Prozessumgebung akzeptiert, und setze die Berechtigungen auf0600. - Übergib bei selbst gehosteten Instanzen
--domainbei jedem Befehl oder exportiereINFISICAL_API_URL/INFISICAL_DOMAIN. - Speichere bei Maschinenidentitäten das Token in
INFISICAL_TOKEN; gib Token nicht direkt in Befehlsstrings weiter und lege sie nicht in versionierten Dateien ab. - Behandle Löschungen als risikoreich. Bestätige die Absicht, überprüfe den Key-Namen und die Umgebung, und bevorzuge die Löschung über UI/API, falls der installierte CLI-Löschpfad als fehlerhaft bekannt ist.
Verwandte Fähigkeiten
Arbeitet zusammen mit: /tailscale, /dev-box, /deploy-checklist