Claves de API de administración
Las claves de API de administración son credenciales a nivel de cuenta con permisos amplios. Úsalas para autenticar las solicitudes a la API de administración y, opcionalmente, a la API de aplicación desde entornos de servidor de confianza. Cada cuenta puede crear un máximo de 3 claves de API de administración desde la página de integración del panel de Trophy. Trophy registra y muestra cuándo se creó cada clave de API de administración de tu cuenta y cuándo se usó por última vez, para que puedas hacer un seguimiento sencillo del uso.
Anatomía de una clave de API de administración
Cada clave de API de administración consta de 2 partes separadas por un punto:- El prefijo son los primeros 8 caracteres. Es legible y siempre permanece igual, por lo que es fácil de reconocer.
- El cuerpo es la parte secreta y solo se muestra una vez, cuando creas la clave.
Al usar la API, ambas partes de tu clave de API de administración deben enviarse en el
encabezado
X-API-KEY.Autenticación de solicitudes
Al realizar solicitudes a la API de administración, incluye ambas partes de tu clave de API de administrador en el encabezadoX-API-KEY, o pásala al inicializar un cliente del SDK:
401.
Gestión de las claves de API de administrador
Hay varias operaciones que puedes realizar con las claves de API de administrador desde tu panel de Trophy para gestionar tu integración.
Rotación de claves
Las claves de API de administrador se pueden rotar si quieres cambiarlas por cualquier motivo. En el momento de la rotación, la clave de API original dejará de funcionar y las solicitudes que sigan usándola empezarán a recibir respuestas401 de inmediato.
Ten en cuenta que, al rotar las claves, cambian tanto el prefijo como el cuerpo.
Revocación de claves
Las claves de API de administrador también se pueden revocar por completo, y en ese caso pasan a estar inactivas. En el momento de la revocación, la clave de API dejará de funcionar y las solicitudes que sigan usándola empezarán a recibir respuestas401 de inmediato.
Una vez revocada, puedes volver a activar la clave de API en cualquier momento.
Ni el prefijo ni el cuerpo de la clave cambian al revocarla o volver a activarla.
Eliminación de claves de API
Si estás 100 % seguro de que ya no necesitas una clave de API de administrador, puedes eliminarla.Una vez eliminadas las claves de API, no se pueden recuperar.