DoubleX AgentesDocs

Guías › Integración

Claves de API

Genera, usa, cambia y revoca las claves que dan acceso a la API y a la CLI.

Toda llamada a la API, excepto los webhooks de disparador, necesita una clave. Las claves empiezan con dbx_ y actúan como la persona dueña de ellas: ven y cambian solo lo que esa persona ve y cambia en la pantalla.

Tipos de clave#

TipoDónde se creaCuántasÚsala para
Clave personalConfiguración › Perfil › Acceso por APIUna por persona. Generarla de nuevo reemplaza la anterior.Scripts, sistemas e integraciones que tú mantienes.
Clave de terminalLa crea doublex login, una por computadoraUna por inicio de sesiónLa CLI de esa computadora. Queda en el llavero del sistema y nunca necesitas verla.

Las dos funcionan igual en la API. La diferencia está en cómo se crean y cómo se revocan.

Generar la clave personal#

  1. Inicia sesión en la app y abre Configuración › Perfil.
  2. En la sección Acceso por API, haz clic en Generar clave de API.
  3. Copia la clave en ese momento. Por seguridad, aparece una sola vez.

Después, la pantalla muestra solo el final de la clave (dbx_••••••••••••a1b2), la fecha de creación y el último uso.

Usar la clave#

Envía la clave en el encabezado Authorization con el esquema Bearer:

curl https://doublex.ai/api/me \
  -H "Authorization: Bearer $DOUBLEX_API_KEY"

Sin la clave, o con una clave no válida o revocada, la API responde 401.

Cambiar y revocar#

AcciónCómoEfecto
Cambiar la clave personalPerfil › Acceso por API › ⋯ › Generar nueva claveLa clave anterior deja de funcionar en ese momento. Actualiza todo lo que la usa.
Revocar la clave personalPerfil › Acceso por API › ⋯ › Revocar claveTodo lo que usa la clave deja de funcionar.
Desconectar una terminalPerfil › Terminal (CLI) › Terminales conectadas › DesconectarLa CLI de esa computadora necesita un nuevo doublex login.
Cerrar sesión desde la terminaldoublex logoutRevoca la clave de esa terminal en el servidor y la borra del llavero. Si iniciaste sesión con la clave personal (--api-key), solo sale del llavero y sigue siendo válida.

Cuando una persona sale de la organización, sus claves dejan de funcionar.

Cambiar o restablecer la contraseña revoca todas tus claves (la personal y las de las terminales): genera de nuevo la personal y ejecuta doublex login en las terminales. La clave de una terminal sin uso durante 90 días también deja de valer.

Qué puede hacer la clave#

La clave tiene los mismos permisos que la persona:

  • ve los agentes, skills, documentos del Brain y conectores de su alcance (Personal, de sus equipos y de la Organización);
  • edita solo lo que la persona puede editar en la pantalla;
  • usa los créditos de la organización, igual que el uso desde la app.

Algunas acciones solo funcionan en el navegador, incluso con una clave válida:

  • generar, cambiar o revocar la clave personal;
  • autorizar el inicio de sesión de una terminal;
  • agregar créditos a la organización.

Buenas prácticas#

  • Guarda la clave como una contraseña: en un gestor de secretos o en una variable de entorno, nunca en el código ni en Git.
  • Usa la clave de terminal (doublex login) en tu computadora y la clave personal solo en servidores y automatizaciones.
  • Si una clave se filtra, revócala en el Perfil. Nada de lo que hizo antes se deshace, pero deja de funcionar en ese momento.
  • El prefijo dbx_ existe para que los escáneres de secretos (como el de GitHub) reconozcan una clave publicada por error.

Próximos pasos#