Ir al contenido

Ajustes de API Keys

La página API Keys es donde gestionas tus API keys personales: los tokens secretos que los scripts, integraciones y herramientas externas utilizan para llamar a la API pública de Board en tu nombre. Cada clave hereda tus permisos, por lo que cualquier cosa que puedas hacer en el Panel de administración, cualquier cosa que llame con una de tus claves también puede hacerlo.

Abre la página desde Ajustes → API Keys (o /settings/api-keys).

Ajustes — API Keys

Las API Keys aquí son por usuario, no por cuenta. Viven bajo tu perfil, junto a tu contraseña y configuración 2FA, y se revocan automáticamente cuando se elimina tu cuenta de usuario. Para claves de todo el taller gestionadas centralmente, consulta Usuarios → pestaña API Keys (la contraparte de administrador en la página Usuarios).


  1. Para qué sirve esta página
  2. Anatomía de la página
  3. Crear una API key
  4. El modal de revelación única
  5. Ver una clave existente
  6. Eliminar una clave
  7. Usar una clave en una llamada API
  8. Qué puede hacer una clave
  9. Modelo de seguridad
  10. Consejos y mejores prácticas

Usa esta página para:

  • Emitir claves para integraciones que configuras tú mismo: un flujo de Zapier, un script personalizado, una sincronización de e-commerce, un panel de informes.
  • Rastrear el uso — ver cuándo se usó cada clave por última vez y podar las que no se usan.
  • Rotar — eliminar una clave antigua y emitir una nueva cuando sospeches una filtración o estés transfiriendo la integración.
  • Auditar — ver de un vistazo qué herramientas tienen acceso para actuar como tú.

Si tu equipo usa mayormente un conjunto de integraciones, una o dos claves por usuario son suficientes. La página está diseñada para revisarse raramente, no para vivir en ella.


Una sola pantalla con:

  • Un encabezado y descripción corta en la parte superior.
  • Un botón Crear API Key a la derecha.
  • Una lista de API Keys Existentes como tarjetas debajo (o un bloque de estado vacío si no tienes ninguna).

Cada tarjeta muestra:

ElementoQué es
NombreLa etiqueta amigable que diste a la clave al crearla.
Clave enmascaradaLos primeros 8 y últimos 4 caracteres de la clave, con ... en medio. Te permite identificar visualmente una clave sin exponerla en pantalla.
CreadaCuándo emitiste la clave.
Último usoCuándo fue la última vez que la API aceptó la clave. Nunca si nunca se ha usado.
Icono de ojoAbre la clave en un modal para que puedas ver y copiar el valor completo.
Icono de papeleraElimina la clave (con confirmación).

Si aún no tienes claves, la página muestra un icono de clave y un estado vacío “Sin API Keys” en lugar de tarjetas.


  1. Haz clic en Crear API Key en la parte superior derecha.
  2. Un pequeño diálogo se abre pidiendo un Nombre. Elige algo que identifique qué usa esta clave: p. ej., “Zapier”, “Servidor de producción”, “Script de sincronización de inventario”, “Dev local”. El nombre es para tu beneficio al escanear la lista más tarde.
  3. Haz clic en Crear.

Una nueva clave se genera en el servidor y se te muestra en un modal de seguimiento. Consulta el modal de revelación única abajo.

La clave se almacena en el servidor en texto plano (a diferencia de una contraseña, que sería hasheada) para que pueda mostrarse de nuevo más tarde a través del botón Ojo. Esto es intencional: consulta Modelo de seguridad para ver por qué.


Después de que Crear tenga éxito, se abre un segundo modal con:

  • La clave completa en un bloque de código copiable.
  • Un botón Copiar junto a ella (el icono cambia brevemente a una marca verde cuando la copia tiene éxito).
  • Una advertencia ámbar: “Asegúrate de copiar tu API key ahora.”

Haz clic en Copiar, pega la clave en cualquier herramienta que la necesite y cierra el modal. La nueva clave aparece en la lista después.

Aunque la clave es recuperable más tarde a través del botón Ojo (ver abajo), llevarla a la integración inmediatamente y confirmar que funciona es la jugada correcta: sabrás en segundos si la has copiado correctamente.


¿Perdiste la clave de tu lado y necesitas volver a obtenerla? Haz clic en el Icono de ojo en su tarjeta. Un modal se abre mostrando el mismo valor completo de clave con un botón Copiar.

Esta es una elección de diseño deliberada: las claves son recuperables para facilitar la vida diaria (reconfigurar una integración, compartir con un colega que toma el relevo). El compromiso de seguridad es intencional: cualquiera con tu inicio de sesión del Panel de administración ya podría leer tus claves, así que hacerlas visibles para ti no expande la superficie de ataque.

Si crees que una clave realmente ha sido comprometida (filtrada, publicada públicamente, usada desde una IP desconocida), no intentes volver a verla: elimina y crea una nueva. La clave antigua deja de funcionar inmediatamente al eliminar.


Haz clic en el icono de la papelera en la tarjeta de una clave. Un diálogo de confirmación del navegador te pide confirmar.

Al confirmar:

  • La clave se revoca inmediatamente: cualquier solicitud API que la use desde este momento devuelve 401 Unauthorized.
  • Cualquier integración en curso que use la clave comenzará a fallar en su siguiente llamada.
  • La clave desaparece de tu lista.

No hay forma de deshacer. Si la necesitas de vuelta, crea una nueva y actualiza cualquier integración que dependiera de la clave eliminada.


La API de Board acepta una clave de cualquiera de dos formas:

  • Un encabezado HTTP: X-API-Key: <tu-clave>
  • Un parámetro de cadena de consulta: ?api_key=<tu-clave>

La forma de encabezado es preferible: no termina en los logs del servidor y URLs tan obviamente, y funciona para todos los verbos HTTP.

Una llamada curl típica:

curl -H "X-API-Key: pb_abc123..." https://your-board.example.com/api/jobs

La marca de tiempo last_used_at en la tarjeta de la clave se actualiza después de que la solicitud tenga éxito: útil para confirmar que una nueva integración realmente está usando la clave correcta.


Una clave hereda los permisos del usuario que la creó:

  • La clave de un usuario admin puede hacer cualquier cosa en la API.
  • La clave de un usuario regular está restringida por el Grupo de usuarios: los módulos que no pueden ver, la clave no puede tocar.
  • Una clave con rol de empleado con estaciones de trabajo limitadas solo puede actuar dentro de esos alcances de estación de trabajo para acciones de taller.

No hay forma de emitir una clave “acotada” o “solo lectura”: el sistema actualmente no admite sub-permisos de usuario. Si necesitas una credencial más bloqueada, crea un usuario dedicado de bajos privilegios (con un Grupo de usuarios estricto) y crea claves bajo ese usuario.

Cuando tú (el usuario) eres eliminado, cada clave que hayas creado se revoca automáticamente.


Algunas cosas a tener en cuenta:

  • Las claves son credenciales completas. Cualquiera que conozca una clave puede llamar a la API como tú. No publiques una públicamente, no la comprometas en un repositorio público de git, no la compartas por correo o chat.
  • Almacenamiento en texto plano en el servidor. Las claves se almacenan tal cual para que funcione el botón Ojo. Esta es una elección deliberada que favorece la recuperabilidad sobre la dureza criptográfica “ni siquiera un admin puede leerlas”. El almacenamiento del lado del servidor sigue siendo acotado por tenant e inaccesible sin acceso a la base de datos.
  • Rota en cambio de personal. Cuando un colega toma el relevo de una integración, la jugada más limpia es: crean una nueva clave bajo su cuenta, la intercambian, tú eliminas la tuya. Evita cualquier confusión “espera, ¿quién creó esto?”.
  • Rota ante sospecha. Más barato que investigar. Eliminar + recrear toma 30 segundos.
  • No compartas una clave entre múltiples integraciones. Cuando necesites retirar una de ellas, no puedes revocar selectivamente. Una clave por integración = revocación quirúrgica más tarde.

  • Nombra las claves según la herramienta que las usa. “Zapier-Producción” le gana a “Clave 1”: cuando escanees tu lista 6 meses después, te lo agradecerás.
  • Una clave por integración. No compartas una sola clave entre tres herramientas diferentes. Cuando una de ellas necesite irse, querrás revocar solo esa.
  • Verifica Último Uso periódicamente. Una clave que no se ha usado en meses pertenece a una integración muerta (elimínala) o a una que se rompió silenciosamente (investiga).
  • Usa la forma de encabezado, no la cadena de consulta. X-API-Key no termina en logs de acceso del servidor e historiales del navegador.
  • Elimina las claves no utilizadas. Cuantas menos claves existan, menor será tu exposición si algo se filtra alguna vez.
  • Rota antes del riesgo, no después. Planifica una rotación trimestral para integraciones de alto valor. Marca los calendarios; hazlo durante ventanas de bajo tráfico.
  • No emitas claves para integraciones de todo el taller. Para herramientas que deberían sobrevivir a cualquier persona individual (una sincronización de e-commerce de larga duración, una conexión ERP), la contraparte de administrador Usuarios → pestaña API Keys es más apropiada: las claves pueden adjuntarse a un usuario de cuenta de servicio dedicada que no desaparece cuando el personal cambia.
  • Combina con 2FA en tu cuenta. Incluso si una clave se filtra, tu inicio de sesión sigue estando protegido: limitando cómo podría escalar un atacante.