Claves de API¶
Las claves de API permiten que una integración llame a DMS en nombre de un usuario. Las claves se gestionan a través de la API; no hay interfaz web para ellas.
Crear una clave¶
Llama a /api/v1/api-keys como el usuario que debe ser dueño de la clave. Puedes
definir un nombre, alcances y una fecha de expiración.
El token se muestra una sola vez. Guárdalo de forma segura; DMS solo conserva un hash.
Usar una clave¶
Envía el token en cualquiera de estas cabeceras:
Authorization: Bearer ldk_...
o:
X-API-Key: ldk_...
Los permisos efectivos son la intersección de los alcances de la clave y los permisos actuales del usuario. Si el usuario pierde un permiso, la clave también lo pierde.
Revocar o deshabilitar una clave¶
Usa los endpoints de claves de API para revocar o alternar una clave. La revocación surte efecto de inmediato.
Reglas¶
- Usa una clave separada por integración.
- Otorga solo los alcances que la integración necesita.
- Establece una expiración cuando sea posible.
- Rota las claves después de cambios de personal o ante una posible filtración.
- Nunca pongas una clave en el código del frontend ni en un repositorio público.