API keys
API keys es donde genera los tokens Bearer que los agentes,
integraciones y dashboards personalizados usan para llamar a
api.saiku.bi. Vendrá aquí una vez por cada integración que quiera
configurar, y periódicamente después para rotación.
La página lista cada clave de su tenant con una etiqueta, ID parcial de la clave, creador, fecha de creación y un timestamp de último uso que se actualiza casi en tiempo real. Útil para detectar claves que ya no se usan (revóquelas) y claves que se usan mucho (las candidatas adecuadas para una revisión de rotación).
Generar una clave
-
Haga clic en Crear clave y póngale una etiqueta. Use un nombre que describa para qué es:
production-billing-agent,staging-bot,client-acme-integration. Las etiquetas aparecen en el audit log así que hágalas reconocibles. -
Haga clic en Crear.
-
Copie el secreto inmediatamente. Solo se muestra una vez. El dashboard conserva el ID de la clave y la etiqueta tras este punto, pero el secreto real ya no es recuperable — no lo almacenamos en forma reversible.
-
Péguelo en el almacén de secretos de su integración. Pruebe de principio a fin.
Usar la clave
Envíe el secreto en el encabezado Authorization:
curl https://api.saiku.bi/me/tenant \ -H "Authorization: Bearer sk_…"La referencia completa vive en Autenticación — URL base, límites de velocidad, forma del error, todo.
Rotación
Una rotación limpia tiene cero tiempo de inactividad porque ambas claves son válidas durante el cambio.
- Cree una clave nueva con la misma etiqueta que la antigua
(añada
-v2,-v3para distinguirlas). - Despliegue la nueva clave en su integración.
- Confirme que la nueva clave se está usando — la columna Último uso en la página se actualiza en un par de minutos.
- Revoque la antigua una vez que tenga confianza.
Revocar
Icono de papelera en la fila, confirmar. La clave se invalida
inmediatamente — la siguiente petición que la use recibe 401 Unauthorized. No hay período de gracia ni deshacer, así que revoque
deliberadamente.
Una clave por integración
El hábito que sale a cuenta: una clave por cada cosa que le llama. Si un agente queda comprometido, revoca su clave y no cambia nada más. Cuando quiera saber qué integración hizo una petición concreta, la columna de clave del registro de auditoría lo responde sin trabajo de detective. Y cuando haya que estrechar el alcance de un socio, edita una lista de permitidos en vez de auditar una credencial compartida.
Generar claves es gratis, así que el único coste real es una tabla algo más larga.
Relacionado
- Autenticación — usar claves en peticiones.
- Audit log — la clave de cada petición queda registrada.
- Uso — volumen de peticiones por clave.