Crear y proteger claves de API
Crea credenciales de producción o de pruebas con permisos mínimos, limita las IP cuando convenga y rota o revoca las claves de forma segura.
- Elige el contextoSelecciona el espacio personal o de organización.
- Configura permisosAsigna un nombre a la clave y elige solo los permisos necesarios.
- Limita los orígenesOpcionalmente, introduce las IP o redes válidas de los clientes.
- Guárdala una sola vezAlmacena el secreto que se muestra en un gestor protegido.
- Mantén el accesoRota la clave para sustituirla y revoca las credenciales retiradas.
Permisos y roles
API Keys muestra las descripciones de los permisos disponibles: lectura de cuenta, inferencia y entrenamiento de IA, trabajos de alojamiento de IA, trabajos de transformación de modelos, servicios de blockchain y permisos de lectura, escritura o gestión de tickets de soporte. En una organización, los propietarios y administradores gestionan las claves; los miembros pueden verlas, pero no gestionarlas. Elige el contexto al que debe pertenecer la credencial, ya que su visibilidad y autorización dependen de ese contexto.
- Selecciona la organización prevista antes de abrir API Keys.
- Lee las descripciones y selecciona solo las operaciones necesarias.
- Si no puedes gestionarlas, pide ayuda a un propietario o administrador.
Crear una clave de producción
Una clave estándar requiere un nombre de 2 a 120 caracteres, al menos un permiso de la lista y una lista de IP opcional. Introduce direcciones IP o redes CIDR válidas, una por línea, sin superar el límite indicado. Una lista vacía permite cualquier IP de origen. La clave completa en texto claro se muestra una sola vez al crearla; solo se almacena un hash, por lo que no se puede recuperar después.
- Usa un nombre que identifique la aplicación o el entorno.
- Elige los permisos mínimos y las direcciones de origen estables que necesites.
- Guarda el valor mostrado directamente en el almacenamiento aprobado de secretos.
Clave de inferencia de pruebas
El dashboard puede crear una clave de pruebas limitada a la inferencia de IA y al número de solicitudes mensuales que se indique. Solo se permite una clave de pruebas activa por contexto de cuenta u organización. Si ya existe una, úsala o revócala antes de crear otra. Mantén las credenciales de pruebas separadas de las de producción y no interpretes el límite de pruebas como una garantía de servicio de producción.
- Comprueba si ya hay una clave de pruebas activa en este contexto.
- Crea una para probar la inferencia y guárdala separada de las demás.
- Vigila su límite y revócala cuando ya no la necesites.
Proteger el secreto
Copia la clave completa solo cuando se muestre al crearla o rotarla. Guárdala en un gestor de secretos cifrado y limita el acceso al servicio que la utiliza. Nunca la incluyas en código fuente o del navegador, registros, capturas, tickets ni mensajes. Si no guardaste el valor la primera vez o ya no lo encuentras, rota la clave; soporte no puede recuperar el texto claro.
- Transfiere el valor mostrado directamente al almacenamiento protegido.
- Configura el servicio consumidor mediante sus ajustes documentados.
- Rota la clave enseguida si sospechas que se perdió o quedó expuesta.
Rotar o revocar
La rotación revoca la credencial anterior y crea otra con el mismo nombre, nivel, permisos y lista de IP. El valor nuevo se muestra una sola vez; actualiza pronto los servicios dependientes porque la clave anterior deja de funcionar. La revocación desactiva la clave seleccionada, pero no la reemplaza. Antes de enviar cualquiera de las acciones, confirma la clave y el contexto correctos.
- Antes de una rotación rutinaria, identifica todos los servicios que usan la clave.
- Guarda el valor nuevo y actualiza los servicios dependientes.
- Revoca las claves retiradas y verifica su estado en el dashboard.
Diagnosticar solicitudes rechazadas
Una solicitud puede rechazarse si la clave está mal formada o revocada, el usuario está inactivo, la IP de origen queda fuera de la lista permitida o falta el permiso necesario. Las solicitudes de pruebas también pueden superar su límite mensual. Comprueba el contexto, la versión del secreto desplegada, la IP de salida y el permiso requerido. Nunca compartas el secreto al pedir ayuda.
- Confirma que la clave está activa e incluye el permiso de la operación.
- Compara la IP de origen real con la lista y comprueba el límite de pruebas.
- Si es incorrecta o está expuesta, rótala y comparte solo referencias redactadas.
Preguntas frecuentes
¿Puedo recuperar una clave más adelante?
No. Rótala para generar un valor de sustitución.
¿Qué permisos debo conceder?
Solo los permisos publicados que necesite la integración.
¿Pueden los miembros crear claves de organización?
No. Las gestionan los propietarios y administradores.
¿La clave anterior sigue activa después de rotarla?
No. La rotación la revoca y crea otra.
¿Qué hago si cambia la IP del cliente?
Pide a un administrador de claves que actualice la lista.
¿Puedo tener dos claves de pruebas?
Solo se permite una clave de pruebas activa por contexto.