Tokens de API
Un token de API permite que un script u otro sistema trabaje con Flowtly en su nombre, sin que nadie inicie sesión en la pantalla de inicio de sesión. Usted crea y revoca sus propios tokens en Perfil → Seguridad, en la sección Tokens de API.
Un token actúa como usted
Lea esto antes de entregar un token a alguien o a algo.
Un token lleva su identidad y sus permisos. Todo lo que usted puede ver y cambiar en Flowtly, también puede verlo y cambiarlo cualquier cosa que tenga su token, y todo lo que se haga con él se hace como usted.
- No es una clave de la organización. Pertenece a la persona que lo creó y llega a lo mismo que esa persona.
- No se puede limitar. No existe un token de solo lectura ni uno para un único módulo: cada token tiene todo su acceso.
Por eso, entregar un token a una integración es entregarle su propio acceso. Déselo solo a un sistema al que confiaría su cuenta, y créelo como la persona cuyo acceso necesita realmente la integración.
Conectar un asistente de IA como Claude o ChatGPT no requiere ningún token: consulte Conectar herramientas de IA (Claude, ChatGPT).
Crear un token
- Abra Perfil → Seguridad y vaya a Tokens de API.
- Escriba un Nombre del token que indique dónde se usará, por ejemplo el nombre de la integración. Puede tener hasta 32 caracteres. Si no lo escribe, el token se llama «Token de API».
- Elija Generar token.
Flowtly muestra entonces el token una sola vez. Elija el icono de copiar y guárdelo en un lugar seguro, como un gestor de contraseñas o el almacén de secretos de la propia integración, antes de elegir Hecho. Flowtly no conserva ninguna copia que pueda volver a mostrarle: una vez cerrada esa ventana, ni usted ni nadie puede recuperar el token. Si se pierde, revóquelo y cree uno nuevo.
Cuánto dura un token
Un token creado aquí es válido durante 365 días desde el momento en que lo crea. Esa es la duración predeterminada, y 730 días es la máxima para la que Flowtly emite un token, así que ningún token sigue siendo válido indefinidamente. Un token no se puede prorrogar: antes de que caduque, cree uno nuevo, entrégueselo a la integración y después revoque el anterior.
La lista Tokens de API muestra cada uno de sus tokens por su nombre, con la fecha en que caduca (o caducó) y cuándo se usó por última vez. Un token caducado sigue en la lista hasta que usted lo revoque. Un token que lleva meses sin usarse es un buen candidato para revocarlo.
Revocar un token
Elija el icono de la papelera junto a un token para revocarlo. No se pide confirmación.
La revocación surte efecto de inmediato: la siguiente solicitud que se haga con ese token se rechaza, en lugar de que el token siga funcionando hasta su fecha de caducidad. Un token revocado no se puede restaurar; si todavía hace falta, cree uno nuevo.
Algunas cosas detienen sus tokens sin que usted los revoque:
- Un restablecimiento de contraseña. Al completar un restablecimiento de contraseña, dejan de funcionar todos los tokens que creó antes, junto con sus demás sesiones. Siguen en la lista como si aún fueran válidos, así que revóquelos también y cree tokens nuevos para sus integraciones.
- Una cuenta desactivada. Si su cuenta de Flowtly se desactiva, todos los tokens que creó dejan de funcionar mientras la cuenta siga desactivada. Revóquelos si no deben volver a funcionar.
Nadie más puede listarlos ni revocarlos desde su propio Perfil → Seguridad.
Casos de uso de ejemplo
- Una jefa de equipo conecta a Flowtly un script de registro de horas con un token que lleva el nombre del script y se guarda en la configuración secreta del script.
- Un consultor que pegó un token en el sitio equivocado lo revoca al momento, sabiendo que dejará de funcionar en su siguiente uso.
- Un administrador se pone un recordatorio once meses después de crear el token de una integración y lo sustituye antes de que se cumplan los 365 días.
- Antes de dar un token a una herramienta externa, una responsable comprueba a qué llega su propia cuenta, porque la herramienta llegará exactamente a lo mismo.