CI Tokens

Crie tokens de autenticação para pipelines de CI/CD. Tokens podem ser limitados a escopos e ambientes específicos. O token em texto claro é exibido apenas uma vez na criação.

Info

O valor do token só é retornado no momento da criação. Guarde-o em um local seguro — como um secret manager do seu provedor de CI. Se perder, será necessário criar um novo.

post Criar token

Cria um novo token de CI/CD. O campo token (texto claro) é retornado apenas nesta resposta.

Parâmetro	Tipo	Descrição
`name`obrigatório	`string`	Nome descritivo do token
`scopes`obrigatório	`string[]`	Escopos: secrets.read, secrets.write, secrets.list
`environment`	`string`	Limitar a um ambiente específico (ex: production). Se omitido, acesso a todos.

bash

curl -X POST https://api.criptenv.dev/api/v1/projects/{pid}/ci-tokens \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GitHub Actions - Prod",
    "scopes": ["secrets.read"],
    "environment": "production"
  }'

get Listar tokens

Retorna todos os tokens de CI do projeto. O valor do token nunca é retornado após a criação.

bash

curl https://api.criptenv.dev/api/v1/projects/{pid}/ci-tokens \
  -H "Authorization: Bearer {token}"

post Revogar token

Revoga um token, impedindo seu uso imediatamente.

bash

curl -X POST https://api.criptenv.dev/api/v1/projects/{pid}/ci-tokens/cit_abc123/revoke \
  -H "Authorization: Bearer {token}"

delete Remover token

Remove permanentemente um token de CI do projeto.

bash

curl -X DELETE https://api.criptenv.dev/api/v1/projects/{pid}/ci-tokens/cit_abc123 \
  -H "Authorization: Bearer {token}"