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#
| Tipo | Dónde se crea | Cuántas | Úsala para |
|---|---|---|---|
| Clave personal | Configuración › Perfil › Acceso por API | Una por persona. Generarla de nuevo reemplaza la anterior. | Scripts, sistemas e integraciones que tú mantienes. |
| Clave de terminal | La crea doublex login, una por computadora | Una por inicio de sesión | La 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#
- Inicia sesión en la app y abre Configuración › Perfil.
- En la sección Acceso por API, haz clic en Generar clave de API.
- 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ón | Cómo | Efecto |
|---|---|---|
| Cambiar la clave personal | Perfil › Acceso por API › ⋯ › Generar nueva clave | La clave anterior deja de funcionar en ese momento. Actualiza todo lo que la usa. |
| Revocar la clave personal | Perfil › Acceso por API › ⋯ › Revocar clave | Todo lo que usa la clave deja de funcionar. |
| Desconectar una terminal | Perfil › Terminal (CLI) › Terminales conectadas › Desconectar | La CLI de esa computadora necesita un nuevo doublex login. |
| Cerrar sesión desde la terminal | doublex logout | Revoca 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#
- Visión general de la API: formato de las solicitudes, errores y streaming.
- Autenticación en la CLI: inicio de sesión en el navegador, servidores sin navegador y CI.