Tokens de API

Um token de API permite que um script ou outro sistema trabalhe com o Flowtly em seu nome, sem que ninguém inicie sessão no ecrã de início de sessão. Cria e revoga os seus próprios tokens em "Profile" → "Security", na secção "API tokens".

Um token age como si

Leia isto antes de entregar um token a alguém ou a alguma coisa.

Um token transporta a sua identidade e as suas permissões. Tudo o que pode ver e alterar no Flowtly, qualquer coisa que tenha o seu token também pode ver e alterar, e tudo o que for feito com ele é feito como si.

• Não é uma chave da organização. Pertence à pessoa que o criou e chega onde essa pessoa chega.
• Não pode ser limitado. Não existe um token só de leitura nem um token para um único módulo: cada token tem todo o seu acesso.

Entregar um token a uma integração é, portanto, entregar-lhe o seu próprio acesso. Dê-o apenas a um sistema a quem confiaria a sua conta, e crie-o como a pessoa cujo acesso a integração precisa realmente.

Ligar um assistente de IA como o Claude ou o ChatGPT não exige nenhum token: consulte Ligar Ferramentas de IA (Claude, ChatGPT).

Criar um token

1. Abra "Profile" → "Security" e vá à secção "API tokens".
2. Dê ao token um nome que indique onde vai ser usado, por exemplo o nome da integração. Pode ter até 32 caracteres. Sem nome, o token recebe um nome predefinido.
3. Escolha "Generate token".

O Flowtly mostra então o token, uma única vez. Copie-o e guarde-o num local seguro, como um gestor de palavras-passe ou o cofre de segredos da própria integração, antes de fechar a janela. O Flowtly não guarda nenhuma cópia que lhe possa mostrar de novo: depois de fechada a janela, o token não pode ser recuperado, nem por si nem por mais ninguém. Se o perder, revogue-o e crie um novo.

Quanto tempo dura um token

Um token criado aqui é válido durante 365 dias a partir do momento em que o cria. É a duração predefinida, e 730 dias é a duração mais longa para a qual o Flowtly emite um token, pelo que nenhum token fica válido indefinidamente. Um token não pode ser prolongado: antes de expirar, crie um novo, entregue-o à integração e depois revogue o antigo.

A lista mostra cada um dos seus tokens pelo nome, com a data em que expira (ou expirou) e quando foi usado pela última vez. Um token expirado fica na lista até o revogar. Um token que não é usado há meses é um bom candidato a ser revogado.

Revogar um token

Escolha o ícone do caixote do lixo ao lado de um token para o revogar. Não é pedida confirmação.

A revogação tem efeito imediato: logo o pedido seguinte feito com esse token é recusado, em vez de o token continuar a funcionar até à data de expiração. Um token revogado não pode ser restaurado; se ainda for necessário, crie um novo.

Há situações que param os seus tokens sem que os revogue:

• Uma reposição da palavra-passe. Concluída uma reposição da palavra-passe, deixam de funcionar todos os tokens que criou antes dela, juntamente com as suas outras sessões. Continuam na lista como se ainda fossem válidos, por isso revogue-os também e crie novos tokens para as suas integrações.
• Uma conta desativada. Se a sua conta Flowtly for desativada, todos os tokens que criou deixam de funcionar enquanto a conta continuar desativada. Revogue-os se não devem voltar a funcionar.

Mais ninguém os pode listar ou revogar a partir do seu próprio "Profile" → "Security".

Exemplos de utilização

• Uma chefe de equipa liga ao Flowtly um script de registo de horas com um token com o nome do script, guardado nas definições secretas do script.
• Um consultor que colou um token no sítio errado revoga-o de imediato, sabendo que deixa de funcionar na utilização seguinte.
• Um administrador define um lembrete onze meses depois de criar o token de uma integração e substitui-o antes de passarem os 365 dias.
• Antes de dar um token a uma ferramenta externa, uma gestora verifica a que é que a sua própria conta chega, porque a ferramenta vai chegar exatamente ao mesmo.