Infisical CLI Secrets

O que Infisical CLI Secrets faz?

Use a Infisical CLI como a fronteira da verdade para segredos: autentique com segurança, injete segredos em processos com infisical run e evite copiar valores para chat, logs ou arquivos rastreados. Prefira a injeção em tempo de processo e superfícies de segredos nativas do projeto em vez de arquivos .env escritos manualmente.

Variáveis

• INFISICAL_DOMAIN: domínio auto-hospedado ou em nuvem, por exemplo https://infisical.example.internal.
• INFISICAL_PROJECT_ID: UUID do projeto Infisical.
• INFISICAL_ENV: slug do ambiente, geralmente dev, staging ou prod.
• INFISICAL_MACHINE_ENV_FILE: arquivo de ambiente local opcional contendo INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET, INFISICAL_DOMAIN e INFISICAL_PROJECT_ID.
• PAWRRTAL_REPO: caminho opcional do checkout Pawrrtal ao aplicar o cookbook Pawrrtal.

Como Funciona

Primeiro, classifique a superfície de segredos: processo de desenvolvimento local, processo de serviço, CI ou segredos de workspace/usuário de propriedade da aplicação. Em seguida, autentique com login de usuário ou identidade de máquina, execute o menor teste seguro e injete segredos na fronteira do processo com infisical run, a menos que a aplicação de destino tenha seu próprio armazenamento de segredos criptografado.

Comandos

Comando	Propósito
/infisical-cli-secrets recon	Inspeciona um repositório e decide como os segredos devem fluir.
/infisical-cli-secrets auth	Autentica com segurança com login de usuário ou identidade de máquina.
/infisical-cli-secrets run	Envolve um comando com injeção de segredos do Infisical.
/infisical-cli-secrets sync	Adiciona, atualiza ou audita chaves de segredos sem vazar valores.
/infisical-cli-secrets pawrrtal	Aplica o padrão limpo ao gateway Pawrrtal e segredos de workspace.

Cookbook

Cada comando tem um guia detalhado passo a passo. Leia o arquivo cookbook relevante antes de executar um comando.

Comando	Cookbook	Use Quando
recon	cookbook/recon.md	Você precisa entender os arquivos env, configuração e planos de segredos de um repositório.
auth	cookbook/auth.md	Você precisa de uma sessão CLI segura ou token de máquina.
run	cookbook/run.md	Você precisa iniciar um comando com segredos injetados.
sync	cookbook/sync.md	Você precisa definir, importar, comparar ou verificar chaves de segredos.
pawrrtal	cookbook/pawrrtal.md	O repositório é Pawrrtal ou usa suas convenções paw/workspace-env.

Quando um usuário invocar /infisical-cli-secrets, leia o arquivo cookbook correspondente primeiro, depois execute os passos.

Regras de Segurança

1. Nunca imprima valores de segredos. Evite infisical secrets --plain, infisical export ou printenv a menos que a saída seja redirecionada para um arquivo protegido e o usuário tenha solicitado explicitamente isso.
2. Prefira infisical run -- <comando> em vez de escrever .env. Use um arquivo apenas quando a ferramenta de destino não puder aceitar env do processo e defina permissões 0600.
3. Para instâncias auto-hospedadas, passe --domain em todos os comandos ou exporte INFISICAL_API_URL/INFISICAL_DOMAIN.
4. Para identidades de máquina, capture o token em INFISICAL_TOKEN; não passe tokens diretamente em strings de comando nem os armazene em arquivos rastreados.
5. Trate exclusões como de alto risco. Confirme a intenção, verifique o nome da chave e o ambiente, e prefira a exclusão via interface ou API se o caminho de exclusão da CLI instalada for conhecido como quebrado.

Skills Relacionadas

Funciona com: /tailscale, /dev-box, /deploy-checklist