Tokens de conta

Tokens de conta fornecem uma maneira simples de autenticar solicitações de API sem passar pelo fluxo completo de OAuth. Eles são ideais para scripts, pipelines CI/CD e automação pessoal.

Criando um token

1. Faça login no Glossia e navegue até o painel da sua conta.
2. Abra a API seção na barra lateral.
3. Clique Tokens de conta, depois Novo token.
4. Dê ao token um descritivo nome (por exemplo, "CI deploy" ou "CLI access").
5. Escolha os escopos que o token precisa. Conceda apenas as permissões mínimas necessárias.
6. Defina uma data de expiração ou deixe-a em branco para um token que nunca expira.
7. Clique Criar token.

Após a criação, o valor completo do token é exibido **uma vez.**Copie-o imediatamente e armazene-o com segurança. Você não verá o valor completo novamente.

Usando um token

Inclua o token no Authorization cabeçalho de suas solicitações HTTP:

Authorization: Bearer glsa_abc123def456...

Por exemplo, usando curl:

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

Os tokens de conta seguem o mesmo modelo de autorização como tokens OAuth. Os escopos do token definem o conjunto máximo de ações que ele pode executar, e as políticas de nível de recurso ainda se aplicam com base nos relacionamentos da sua conta.

Formato do token

Todos os tokens de conta começam com o glsa_ prefixo seguido por uma string hexadecimal aleatória. Esse prefixo facilita a identificação dos tokens do Glossia em logs e varredores de segredos.

Escopos

Tokens de conta suportam os mesmos escopos que os tokens OAuth. Consulte o referência de escopos para a lista completa.

Ao criar um token, selecione apenas os escopos que seu caso de uso requer. Por exemplo:

• Uma integração somente leitura requer project:read e voice:read.
• Uma pipeline de CI que cria projetos requer project:read e project:write.
• Um script que gerencia membros da organização precisa members:read e members:write.

Gerenciamento de tokens

Visualização de tokens

A Tokens da conta página lista todos os tokens ativos com nome, escopos, data de última utilização e validade. Tokens que nunca foram usados mostram "Nunca" na coluna de última utilização.

Editando tokens

Clique no nome do token para editar o nome e descrição. Os escopos e a expiração não podem ser alterados após a criação. Se precisar de diferentes escopos, crie um novo token e revogue o antigo.

Revogando tokens

Para revogar um token, clique Revogar na lista de tokens ou abra a página de edição do token e use o Revogar token botão na zona de perigo. Tokens revogados param de funcionar imediatamente e não podem ser restaurados.

Melhores práticas de segurança

• Armazene os tokens com segurança. Use variáveis de ambiente ou um gerenciador de segredos. Nunca faça commit de tokens no controle de versão.
• Use tokens de curta duração. Defina uma data de expiração sempre que possível.
• Minimize os escopos. Conceda apenas as permissões que o token realmente precisa.
• Renove periodicamente. Crie novos tokens e revogue os antigos em um cronograma.
• Monitore o uso. Verifique a data "último uso" periodicamente. Revogue os tokens que não estão mais em uso.
• Use um token por integração. Dessa forma, revogar um token não quebra outros fluxos de trabalho.

Gerenciamento de API

Você também pode gerenciar tokens de conta através da REST API e do servidor MCP.

REST API

MCP

O servidor MCP expõe list_tokens, create_tokene revoke_token ferramentas que espelham a API REST.