Quickstart

Comece a usar o CriptEnv em menos de 5 minutos. Este guia rápido vai levá-lo da instalação até a leitura do primeiro segredo.

Info

Pré-requisitos: Python 3.10+ instalado no seu sistema. Para macOS, você também pode usar o Homebrew.
1

Instale o CLI

Escolha o método de instalação preferido para o seu sistema operacional:

bash
brew install criptenv/tap/criptenv
2

Inicialize o CriptEnv

Execute o comando de inicialização para configurar o diretório local do CriptEnv:

bash
criptenv init

Isso criará a pasta .criptenv no diretório atual, onde ficarão suas configurações e vault local.

3

Crie um projeto

Crie um novo projeto para organizar seus segredos:

bash
criptenv project create meu-projeto
criptenv project use meu-projeto

Info

Você pode criar múltiplos projetos e alternar entre eles a qualquer momento com criptenv project use.
4

Defina seus segredos

Agora adicione variáveis de ambiente secretas ao projeto:

bash
criptenv set DATABASE_URL="postgres://user:pass@host/db"
criptenv set API_KEY="sk-1234567890abcdef"
criptenv set STRIPE_SECRET="sk_live_abc123"

Todos os segredos são criptografados localmente com AES-256-GCM antes de serem armazenados. O CriptEnv nunca envia dados em texto claro para a nuvem.

5

Liste seus segredos

Veja todos os segredos configurados no projeto atual:

bash
criptenv list
# Saída:
# DATABASE_URL
# API_KEY
# STRIPE_SECRET

Info

O comando list mostra apenas os nomes das variáveis, nunca os valores. Assim é seguro usar em logs e CI.
6

Leia um segredo

Recupere o valor de um segredo específico:

bash
criptenv get DATABASE_URL
# Saída: postgres://user:pass@host/db

Você também pode injetar os segredos diretamente em um comando:

bash
criptenv run -- node server.js

Próximos passos