Tokens de cuenta

Los tokens de cuenta ofrecen una forma sencilla de autenticar solicitudes de API sin pasar por el flujo completo de OAuth. Son ideales para scripts, pipelines de CI/CD y automatización personal.

Creando un token

1. Inicia sesión en Glossia y navega a tu panel de cuenta.
2. Abre el API sección de la barra lateral.
3. Haz clic Tokens de cuenta, luego Nuevo token.
4. Asigne al token un descriptivo nombre (por ejemplo, "CI deploy" o "CLI access").
5. Seleccione los alcances que el token necesita. Solo conceda los permisos mínimos requeridos.
6. Establezca una fecha de expiración o déjenlo en blanco para un token que nunca caducará.
7. Haga clic Crear token.

Después de la creación, se muestra el valor completo del token. una vez. Cópialo inmediatamente y guárdalo de forma segura. No podrás volver a ver el valor completo.

Usando un token

Incluye el token en el Authorization encabezado de tus solicitudes HTTP:

Authorization: Bearer glsa_abc123def456...

Por ejemplo, usando curl:

curl -H "Authorization: Bearer glsa_abc123def456..." \
  https://glossia.ai/api/projects

Los tokens de cuenta siguen el mismo modelo de autorización como tokens OAuth. Los ámbitos del token definen el conjunto máximo de acciones que puede realizar, y las políticas a nivel de recurso siguen aplicándose basándose en las relaciones de su cuenta.

Formato de token

Todos los tokens de cuenta comienzan con el glsa_ un prefijo seguido de una cadena hexadecimal aleatoria. Este prefijo facilita identificar los tokens de Glossia en los registros y escáneres de secretos.

Ámbitos

Los tokens de cuenta soportan los mismos ámbitos que los tokens OAuth. Consulte la referencia de ámbitos para la lista completa.

Al crear un token, selecciona solo los ámbitos que requiera tu caso de uso. Por ejemplo:

• Una integración de solo lectura necesita project:read y voice:read.
• Un pipeline de CI que crea proyectos necesita project:read y project:write.
• Un script que gestiona los miembros de la organización necesita members:read y members:write.

Gestión de tokens

Visualización de tokens

La Tokens de cuenta página lista todos los tokens activos con su nombre, ámbitos, fecha de último uso y expiración. Los tokens que nunca se han utilizado muestran "Nunca" en la columna de último uso.

Edición de tokens

Haga clic en el nombre de un token para editar su nombre y descripción. Los alcances y la expiración no se pueden cambiar después de la creación. Si necesita diferentes alcances, cree un nuevo token y revoque el anterior.

Revocación de tokens

Para revocar un token, haga clic Revocar en la lista de tokens o abra la página de edición del token y utilice el Revocar token botón en la zona de peligro. Los tokens revocados dejan de funcionar inmediatamente y no se pueden restaurar.

Mejores prácticas de seguridad

• Almacene tokens de forma segura. Utilice variables de entorno o un gestor de secretos. Nunca haga commit de tokens al control de versiones.
• Utilice tokens de corta duración. Establezca una fecha de caducidad siempre que sea posible.
• Minimice los alcances. Conceda solo los permisos que realmente necesita el token.
• Rote regularmente. Cree nuevos tokens y revoque los antiguos periódicamente.
• Supervise el uso. Revise periódicamente la fecha de "último uso". Revoque los tokens que ya no se utilizan.
• Utilice un token por integración. De esta manera, revocar un token no rompe otros flujos de trabajo.

Gestión de API

También puedes gestionar los tokens de la cuenta mediante la REST API y el servidor MCP.

REST API

MCP

El servidor MCP expone list_tokens, create_token, y revoke_token herramientas que reflejan la REST API.