API Keys

As API Keys do Vectora são usadas para autenticação programática e integração com ferramentas de terceiros que não suportam fluxos interativos de SSO.

Visão Geral

Diferente do JWT, que é destinado a sessões de curta duração, as API Keys são persistentes e permitem o acesso controlado a namespaces específicos do Vectora.

Segurança

O Vectora utiliza hashing unidirecional (SHA-256) para armazenar suas chaves. Isso significa que, mesmo se o banco de dados for comprometido, suas chaves originais não podem ser recuperadas.

Como Usar

Para autenticar uma requisição REST usando uma API Key, envie o cabeçalho X-API-Key:

curl -X POST https://api.vectora.app/v1/search \
  -H "X-API-Key: vca_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query": "como funciona o auth?"}'

Gestão de Chaves

Você pode gerenciar suas chaves através da CLI do Vectora:

# Criar uma nova chave
vectora auth keys create --name "GitHub Actions" --namespace "prod"

# Listar chaves ativas
vectora auth keys list

# Revogar uma chave
vectora auth keys revoke <key_id>

External Linking

Referência de Segurança e Gestão