Autenticação e perfis

Indicado para uso interativo, quando você navega entre organizações:

zenifra auth login
zenifra orgs
zenifra org set
zenifra whoami

zenifra whoami mostra o perfil ativo, a API e a organização selecionada, sem exibir credenciais.

Abre o Console para você entrar, concluir a verificação de segurança e aprovar o acesso da CLI:

zenifra auth login --oauth
zenifra auth login --oauth --read-only
zenifra auth login --oauth --no-browser

--read-only solicita somente leitura; as permissões da sua organização continuam valendo.
--no-browser mostra o endereço para abrir manualmente no navegador da mesma máquina.
--read-only e --no-browser exigem --oauth.
O login aguarda até três minutos; use Ctrl+C para cancelar. Os tokens ficam no perfil local privado e são renovados automaticamente.

Sem --oauth, auth login usa e-mail, senha e verificação.

API key para automação

Use uma API key da organização em scripts, runners e pipelines:

export ZENIFRA_API_KEY=znf_sua_chave
zenifra projects --type http --page 1 --limit 15
zenifra deploy --project <project-id> --branch main

Ou salve a chave no perfil ativo:

zenifra auth api-key --key znf_sua_chave

API keys já carregam a organização vinculada, então projects, deploy, builds e deployments não exigem org set. Comandos pessoais como orgs e org set exigem zenifra auth login.

Sair e revogar

zenifra auth logout            # remove só a autenticação local
zenifra auth logout --revoke   # também revoga a conexão do perfil

--revoke exige um perfil autenticado por login e não revoga API keys.

Perfis e ambientes

Perfis locais separam credenciais, descrição e API base:

zenifra profile list
zenifra profile add --name prod --description Producao --api-base https://api.zenifra.com/v1 --mode api-key --key znf_sua_chave
zenifra profile use prod
zenifra profile show
zenifra profile edit prod --description "Producao principal"
zenifra profile remove prod

auth login --profile <nome> e auth api-key --profile <nome> criam ou atualizam outro perfil e o tornam ativo. Não reutilize um token em outra API: crie outro perfil.

Variáveis de ambiente sobrescrevem o perfil apenas durante a execução:

ZENIFRA_API_URL=https://api.zenifra.com/v1 zenifra projects --type http
ZENIFRA_CONFIG_DIR=/tmp/zenifra-cli zenifra profile list

ZENIFRA_API_KEY tem prioridade sobre a credencial do perfil. Use ZENIFRA_CONFIG_DIR em testes para não alterar a sessão real.

Organizações

zenifra orgs
zenifra org set
zenifra org set --org <organization-id>

Segurança

Armazene ZENIFRA_API_KEY em secrets do provedor de CI.
Prefira variável de ambiente em runners efêmeros, sem gravar sessão local.
Configure IP allowlist quando a automação tiver origem fixa.
Conceda apenas as permissões necessárias para o job.
Rotacione e revogue chaves antigas.
Evite imprimir valores completos de variáveis sensíveis em logs de CI.

Autenticação e perfisCopy Anchor Link