API keys
API keys é onde você gera os Bearer tokens que agentes,
integrações e dashboards customizados usam para chamar api.saiku.bi.
Você virá aqui uma vez para cada integração que quiser configurar e
periodicamente depois para rotação.
A página lista todas as chaves do seu tenant com rótulo, ID parcial da chave, criador, data de criação e um timestamp de último uso que atualiza quase em tempo real. Útil para identificar chaves que não estão sendo usadas (revogue-as) e chaves que estão sendo muito usadas (as candidatas certas para uma revisão de rotação).
Gerar uma chave
-
Clique em Criar chave e dê um rótulo. Use um nome que descreva para que ela serve:
production-billing-agent,staging-bot,client-acme-integration. Os rótulos aparecem no audit log, então torne-os reconhecíveis. -
Clique em Criar.
-
Copie o segredo imediatamente. Ele aparece uma única vez. O dashboard mantém o ID e o rótulo da chave depois desse ponto, mas o segredo em si não é mais recuperável — não o guardamos em forma reversível.
-
Cole no armazenamento de segredos da sua integração. Teste de ponta a ponta.
Usar a chave
Envie o segredo no header Authorization:
curl https://api.saiku.bi/me/tenant \ -H "Authorization: Bearer sk_…"A referência completa fica em Autenticação — URL base, limites de taxa, formato de erro, tudo.
Rotação
Uma rotação limpa tem zero indisponibilidade porque ambas as chaves são válidas durante a transição.
- Crie uma nova chave com o mesmo rótulo da antiga (acrescente
-v2,-v3para diferenciá-las). - Implante a nova chave na sua integração.
- Confirme que a nova chave está sendo usada — a coluna Last used na página atualiza em um ou dois minutos.
- Revogue a chave antiga assim que estiver confiante.
Revogar
Ícone de lixeira na linha, confirme. A chave é invalidada imediatamente
— a próxima requisição usando-a recebe 401 Unauthorized. Não há
período de carência nem desfazer, então revogue deliberadamente.
Uma chave por integração
O hábito que compensa: uma chave por coisa que te chama. Se um agente for comprometido, você revoga a chave dele e nada mais muda. Quando você quiser saber qual integração fez uma requisição específica, a coluna de chave do log de auditoria responde sem trabalho de detetive. E quando o escopo de um parceiro precisar estreitar, você edita uma allowlist em vez de auditar uma credencial compartilhada.
Emitir chaves é de graça, então o único custo real é uma tabela um pouco mais longa.
Relacionado
- Autenticação — usando chaves nas requisições.
- Audit log — a chave de cada requisição é registrada.
- Usage — volume de requisições por chave.