Claves Virtuales
Las claves virtuales son las claves de API que utilizan los agentes y las aplicaciones para llamar al Gateway. Cada clave virtual está vinculada a un equipo (hereda su presupuesto, límites de velocidad, lista de modelos permitidos y los controles de Seguridad/Observabilidad), puede tener su propio subpresupuesto y puede expirar en una fecha configurada.
La vista de lista muestra el nombre de cada clave, el equipo asociado, el gasto actual, el presupuesto, el estado y la fecha de creación. Filtre por estado o equipo en la parte superior; el ícono de encendido en cada fila activa o desactiva una clave de forma instantánea.
Generar una Clave
Haga clic en + Generate Key en la parte superior derecha para abrir el modal de generación de clave virtual.
- Key Name — Identificador legible por personas que aparece en listas, informes de gasto y registros de auditoría (p. ej.,
production-key,mobile-app-prod). No es visible para el consumidor. - Team (opcional) — Seleccione un equipo. La clave hereda el presupuesto, los límites de velocidad, la lista de modelos permitidos y los controles de Seguridad/Observabilidad del equipo. Déjelo en blanco para una clave independiente vinculada únicamente a los límites a nivel de clave.
- Max Budget ($) — Límite de gasto opcional para esta clave específica. Cuando tanto el presupuesto del equipo como el de la clave están configurados, se aplica el menor de los dos.
- Expires — Fecha ISO opcional. Después de esa fecha, la clave se desactiva automáticamente. Déjelo en blanco para una clave sin vencimiento.
Haga clic en Generate para crear la clave. El valor de la clave se muestra una sola vez — cópielo inmediatamente en un almacén de secretos.
Nota: El valor de la clave nunca se vuelve a mostrar tras su creación. Si se pierde, genere una nueva clave y rótela.
Usar una Clave Virtual
Las claves virtuales se pasan como el encabezado Authorization: Bearer <key> en las solicitudes al Gateway. El Gateway identifica la clave, resuelve el equipo, aplica el enrutamiento, la seguridad y la observabilidad, y reenvía la solicitud al proveedor subyacente.
Cada consumidor — runtimes de agentes, aplicaciones, pipelines de CI — debería tener su propia clave. Compartir una clave entre entornos colapsa los registros de auditoría y hace que la rotación sea arriesgada.
Buenas Prácticas
- Vincule cada clave a un equipo. Las claves independientes omiten la lista de modelos permitidos y el límite de presupuesto del equipo, lo cual casi nunca es lo que se desea en producción.
- Establezca una fecha en Expires para las claves de corta duración (ejecuciones de CI, integraciones temporales) para que se revoquen automáticamente si el responsable lo olvida.
- Rote las claves de producción de forma periódica (p. ej., trimestralmente). Genere la nueva clave, deséplieguela y luego desactive la antigua con el ícono de encendido — la clave antigua puede reactivarse brevemente si algún consumidor aún la utiliza, y luego eliminarse de forma definitiva.
- Trate los nombres de clave como información pública. Aparecen en los informes de gasto junto con el costo y el volumen; utilice un nombre que sea seguro mostrar al área de finanzas.