Las claves de proveedor te permiten utilizar tus propias cuentas de proveedores de modelos en lugar de los modelos enrutados por Coroid. El uso se factura directamente a ti por ese proveedor, según las tarifas que hayas negociado.
Gestionarlas en Configuración → Claves de proveedor.
Cuándo usar tus propias claves
BYOK merece la pena si ya tienes acuerdos con proveedores, gastos comprometidos o un requisito de adquisiciones para que el vendedor del modelo sea un proveedor directo.
Si ninguno de estos casos se aplica, los modelos enrutados por Coroid con créditos prepagos son más sencillos, y Coroid incluye sin marcado a las tarifas de tokens del proveedor en cualquier caso. La elección depende de los contratos, no del precio.
Cómo se gestionan las claves
- Se cifran con la clave propia de tu organización. Las claves de proveedor de cada organización se cifran con su propia clave de datos. Un servicio de gestión de claves (OVHcloud KMS) cifra a su vez esa clave de datos.
- Se descifran en un único lugar. Solo el broker de credenciales de Coroid puede descifrar una clave de proveedor. El broker realiza las llamadas al modelo él mismo, por lo que la clave nunca se entrega a los agentes ni a otros servicios de Coroid.
- Nunca se devuelve. Una vez guardada, no se puede leer la clave a través de la interfaz ni de API. Puedes reemplazarla, pero no recuperarla.
- Nunca se exporta. Los paquetes de exportación de Configuración contienen un marcador de posición, no el secreto. Consulta Exportar e importar configuraciones.
- Se registra cada uso. Coroid registra cada llamada que realiza con tu clave. La fila de la clave muestra cuándo la usó Coroid por última vez y qué tarea realizó la llamada. Si sospechas de una fuga, el soporte de Coroid puede indicarte qué tareas usaron la clave y cuándo.
La propiedad de solo escritura es intencionada. Una credencial que se pueda leer es una credencial que cualquier persona con acceso de lectura puede exfiltrar.
Rotación
Reemplaza la clave por el nuevo valor. El trabajo en curso continúa en la conexión iniciada; el nuevo trabajo usa la nueva clave. Solo los propietarios y administradores de la organización pueden agregar, reemplazar o eliminar una clave, y cada cambio se registra en el registro de auditoría de la organización.
Rotar según el calendario de tu proveedor y siempre que alguien con acceso de administrador abandone la organización. No hay forma de saber desde Coroid si una clave se ha usado en otro lugar; para eso está el registro de auditoría de tu proveedor.
Ámbito
Si tu proveedor admite claves con ámbito o restringidas, úsalas. Una clave limitada a los modelos y al límite de gasto que destines a Coroid supone un problema mucho menor si llegara a divulgarse.
Establece un límite de gasto en el proveedor. Es el único techo estricto existente: los límites propios de Coroid regulan la capacidad, no la factura de tu proveedor.
Fallback
Si una clave es inválida, ha caducado o ha superado su límite de proveedor, las llamadas al modelo que la usen fallarán. El trabajo no continuará silenciosamente en otro proveedor; eso sería algo sorprendente de hacer con el dinero de otra persona.
Corrige la clave y el trabajo en cola se reanudará.