Claves API

Genera, copia, identifica y revoca una clave API personal de Runner de forma segura.

Las capturas y grabaciones muestran la interfaz en inglés.

Las claves API son secretos personales para acceso programático a Runner. Crea una solo para una aplicación en la que confíes, almacénala de forma segura y revócala cuando ya no sea necesaria.

Qué cubre esta guía

Sabrás cómo crear y guardar el secreto de una sola vez, identificar claves existentes sin exponerlas y revocar una clave con confirmación.

Disponibilidad y requisitos previos

Claves API es condicional y aparece solo cuando está habilitada para tu cuenta.
La página indica Cada clave actúa como tú. Las claves pertenecen a tu cuenta personal, no a una tienda.
No confundas estas claves con las Claves API de Analíticas de solo lectura en General del Espacio de Trabajo.
Nunca pongas una clave completa en chat, Memoria de Agente, una Habilidad, una captura de pantalla, control de versiones o documentación del producto.

Ruta de acceso

Selecciona Configuración → tu nombre de cuenta → Claves API. Si la entrada está ausente, la función no está disponible para la cuenta actual.

Controles

Entrada o botón	Por qué es útil	Qué sucede después
Generar nueva clave	Crea una nueva credencial.	Se abre un diálogo con un campo Nombre opcional.
Nombre	Identifica la aplicación más tarde sin exponer el secreto.	El nombre aparece en la tabla de claves; en blanco crea una clave sin título.
Crear clave	Genera la credencial.	Runner abre Clave API generada y muestra el secreto completo una sola vez.
Icono de ojo	Verifica el valor recién generado completo antes de almacenarlo.	El valor de una sola vez se muestra u oculta en el diálogo de éxito.
Icono de copiar	Copia la nueva clave con precisión.	Runner la copia al portapapeles y muestra confirmación.
La he guardado	Cierra la vista del secreto de una sola vez.	El valor completo se borra del diálogo y no se puede mostrar de nuevo allí.
Tabla de clave existente	Identifica claves de forma segura.	Runner muestra Nombre, Prefijo, Creado y Último uso, no el secreto completo.
Icono de eliminar	Revoca una clave existente.	Una confirmación explica que la revocación no se puede deshacer.
Revocar	Deshabilita la clave seleccionada.	Después del éxito, la clave se elimina de la lista y ya no puede autenticar.

Anotaciones en inglés: Claves API personales sin claves aún y Generar nueva clave

Las anotaciones en inglés señalan los controles. Selecciona la imagen para ampliarla.

La lista vacía es el estado inicial. No se generó ni mostró ningún secreto en este ejemplo.

Inspecciona el diálogo antes de crear una credencial

Selecciona Generar nueva clave.
Encuentra el campo Nombre opcional; una etiqueta como Reporting integration ayuda a identificar la aplicación más tarde.
Selecciona Cancelar si solo estás explorando. No se crea ninguna clave hasta que selecciones Crear clave.

El flujo de trabajo a continuación se aplica cuando Claves API está disponible y estás listo para almacenar un nuevo secreto.

Generar y almacenar una clave

Abre tu nombre de cuenta → Claves API.
Selecciona Generar nueva clave.
Ingresa un Nombre descriptivo, como la aplicación o entorno. No pongas un secreto en el nombre.
Selecciona Crear clave.
En Clave API generada, revela la clave solo si es necesario y selecciona Copiar.
Almacénala en un gestor de secretos de confianza.
Confirma el valor almacenado antes de seleccionar La he guardado.
Usa el Prefijo de la tabla para identificar la clave más tarde sin exponer el valor completo.

Runner advierte que la clave completa no se mostrará de nuevo. Si cierras el diálogo sin guardarla, revoca esa clave y crea un reemplazo en lugar de intentar recuperar el secreto.

Revocar una clave

Coincide la clave prevista por Nombre y Prefijo.
Selecciona su icono de eliminar.
Revisa la confirmación de Revocar.
Selecciona Revocar solo cuando la aplicación dependiente esté lista para dejar de usarla.
Confirma Clave API revocada y elimina el secreto antiguo de la aplicación.

La revocación es destructiva y no se puede deshacer. Crea una nueva clave si se necesita acceso de nuevo.

Estados y límites

Sin claves API aún es el estado vacío normal.
El valor completo de una clave nueva aparece solo en su diálogo de éxito.
Las filas existentes muestran un prefijo y fechas de uso, no una clave recuperable.
nunca bajo Último uso significa que Runner no ha registrado una solicitud para esa clave.
Los botones Crear y Revocar muestran progreso y no deben enviarse repetidamente.

Solución de problemas

Si falta Claves API, no uses un enlace directo copiado; la función está deshabilitada para esta cuenta.
Si la copia del portapapeles falla, revela el nuevo valor y cópialo manualmente en un gestor de secretos seguro, luego ocúltalo de nuevo.
Si perdiste una clave completa, revoca su fila y genera un reemplazo.
Si una aplicación deja de funcionar después de la revocación, actualízala con una clave recién creada; la clave antigua no se puede restaurar.
Si se seleccionó la clave incorrecta, Cancela la confirmación y compara Nombre y Prefijo de nuevo.