AuthTokens
Nesta página 8 seções
- O que é um AuthToken
- Criar um token
- Abra Meus tokens
- Dê um nome ao dispositivo
- Copie o token para o aplicativo
- Escolha o dispositivo em Meus túneis
- A lista de tokens
- Histórico de IP
- Configurações do token
- Excluir um token
- Conectar um dispositivo Android com QR code ou PIN
- Abra Conectar dispositivo
- Escaneie o código ou digite o PIN
- Grupos de tokens
- Criar um grupo
- Escolher os tokens dele
- Onde os tokens são usados
- Solução de problemas
- Páginas relacionadas
Um AuthToken conecta o aplicativo Localtonet de um dispositivo à sua conta. Crie um token para cada dispositivo em Meus tokens, faça login no dispositivo com ele e depois escolha esse token ao criar um túnel.
O que é um AuthToken #
O aplicativo Localtonet entra com um AuthToken em vez do seu e-mail e senha. No painel, o token representa o dispositivo que o usa: um túnel é criado para um token e funciona enquanto o aplicativo que usa esse token estiver conectado.
- Dê a cada dispositivo o seu próprio token. Uma nova conexão que usa o mesmo token substitui a anterior.
- O nome de um token é apenas um rótulo. O próprio token é gerado pelo Localtonet.
- Um AuthToken faz o login de um dispositivo. Ele não protege um túnel contra visitantes. Para isso, veja Controle de acesso.
Mantenha seus tokens em sigilo. Qualquer pessoa com o token pode usá-lo para entrar no aplicativo. O mesmo vale para o QR code e o PIN de um token.
Criar um token #
-
Abra Meus tokens #
Abra Meus tokens e expanda Criar token.
-
Dê um nome ao dispositivo #
Digite um nome reconhecível em Nome do token, por exemplo
Office-PC, e selecione Criar token.Regra Detalhe Obrigatório Um nome vazio mostra O nome é obrigatório! Tamanho No máximo 30 caracteres. Espaços Não são permitidos. O campo não aceita espaços, e os espaços de um nome colado são removidos. Único Dois dos seus tokens não podem ter o mesmo nome. -
Copie o token para o aplicativo #
O novo token aparece em Seus tokens. Selecione-o para copiar o token completo e depois inicie o aplicativo Localtonet com ele:
Terminallocaltonet --authtoken <YOUR_TOKEN>No Android, use o QR code ou o PIN. Veja Conectar um dispositivo Android abaixo.
-
Escolha o dispositivo em Meus túneis #
Ao criar um túnel, selecione este token em Token do dispositivo. O Início rápido mostra o fluxo completo.
A lista de tokens #
Seus tokens lista todos os tokens da conta em que você está trabalhando. Use Buscar tokens para filtrar por nome ou token e Atualizar para recarregar a lista. Em telas estreitas, algumas colunas ficam atrás do botão Detalhes de cada linha.
| Coluna | O que mostra | O que você pode fazer |
|---|---|---|
| Nome | O nome que você deu ao token. | Selecione o nome para renomear o token. As regras de um novo nome se aplicam. |
| Status | Online significa que o aplicativo Localtonet está conectado. Offline significa que o dispositivo está desconectado, mesmo que seus túneis continuem configurados. | |
| Token | O token, com a parte do meio oculta. | Selecione-o para copiar o token completo. O botão de QR abre Conectar dispositivo. |
| Túneis | Túneis ativos / total de túneis vinculados a este token. Um dispositivo online não tem necessariamente um túnel ativo. | |
| Cliente | A última versão do aplicativo informada e seu status de atualização. | Um selo Requer atualização leva à página de download, para que você instale o aplicativo Localtonet mais recente. Conecte o dispositivo para atualizar essa informação. |
| Dispositivo | Uso de threads, nível e temperatura da bateria, conforme o último relatório do dispositivo. | Para dispositivos Android: Configurações do dispositivo Android, Configurações de SMS quando houver suporte e Logs de ações do dispositivo. O Gerenciador de proxies oferece os mesmos controles para uma frota inteira. |
| Ações | Histórico de IP, Configurações do token, Excluir token. |
Histórico de IP #
Histórico de IP abre a lista de endereços IP públicos registrados para o token, cada um com a sua data. Acima da lista você vê quatro contadores: Total de repetições, Total de IPs repetidos, IPs repetidos na última 1 hora e Total de IPs na última 1 hora. Selecione Atualizar para atualizá-los. Isso é mais útil para um dispositivo cujo IP muda, como um celular que alterna o IP móvel.
Configurações do token #
Configurações do token abre um painel com o token completo, um botão Copiar token, o botão QR / PIN e duas configurações:
| Configuração | O que faz | Valores |
|---|---|---|
| Modo de dispositivo USB | Use este modo quando o token conecta um dispositivo USB. Você gerencia os dispositivos dele em Meus dispositivos USB. | Sim ou Não. A alteração pede confirmação. |
| Argumentos do cliente | Salva opções do cliente junto com o token. Selecione Gerenciar, ative Ativo e preencha Argumentos. O cliente Localtonet não aplica os argumentos salvos aqui; ele aplica os Argumentos definidos em um túnel. Para escolher uma interface de rede ou um endereço IP local, defina-os em cada túnel. | Com Ativo ligado, o campo não pode ficar vazio. Veja Seleção de rede. |
Excluir um token #
Selecione Excluir token e confirme. O painel avisa antes:
Os túneis com este token serão interrompidos e excluídos. Um dispositivo que ainda usa o token não consegue mais se conectar com ele. Crie um novo token para esse dispositivo se precisar dele de novo.
Conectar um dispositivo Android com QR code ou PIN #
Você não precisa digitar um token no celular. Todo token tem um QR code e um PIN curto.
-
Abra Conectar dispositivo #
Em Meus tokens, selecione o botão de QR ao lado do token. A caixa de diálogo Conectar dispositivo abre.
-
Escaneie o código ou digite o PIN #
Abra o Localtonet para Android. Escaneie o código em Escanear QR code ou digite o PIN de seis dígitos mostrado em Ou informe um PIN no campo de login do aplicativo e selecione Connect.
- O PIN é válido por um minuto. A caixa de diálogo faz a contagem regressiva e depois mostra O PIN expirou. Gere um novo PIN para continuar.
- Um PIN funciona uma vez. Selecione Gerar novo PIN para outro dispositivo ou outra tentativa.
- O QR code não expira. Ele contém o próprio token, então trate uma foto dele como se fosse o token.
- Você também pode colar o token no aplicativo. A caixa de diálogo o mostra com um botão de copiar.
Grupos de tokens #
Um grupo de tokens contém tokens de dispositivos. Os grupos organizam os dispositivos em conjuntos: um Proxy rotativo usa os dispositivos dos grupos que você seleciona, e um webhook de token é criado para um grupo.
-
Criar um grupo #
Em Meus tokens, expanda Grupos de tokens, digite um Nome do grupo e selecione Criar grupo. O nome pode ter no máximo 30 caracteres, não tem espaços e deve ser único entre os seus grupos.
-
Escolher os tokens dele #
A caixa de diálogo Gerenciar grupo de tokens abre com uma lista de todos os seus tokens. Marque os tokens de dispositivo que pertencem ao grupo e selecione Salvar alterações.
Para alterar um grupo depois, selecione Gerenciar na linha dele. A caixa de diálogo foi pensada para listas longas:
- Busque por nome. Separe vários nomes com vírgulas.
- Filtre pelo status do dispositivo: Qualquer status, Online ou Offline.
- Alterne entre Todos, No grupo e Fora do grupo.
- Use Selecionar todos para marcar todos os tokens exibidos e depois desmarque os que quer deixar de fora. Shift+clique seleciona um intervalo.
- O rodapé mostra o que vai mudar, por exemplo +3 para adicionar. Redefinir descarta suas alterações.
Quando você remove tokens de um grupo, a caixa de diálogo pede confirmação, porque os proxies rotativos que usam o grupo param nesses dispositivos. Um único salvamento pode alterar até 5000 tokens.
Excluir grupo remove o grupo e suas associações. Os tokens em si permanecem.
Onde os tokens são usados #
| Local | Como o token é usado |
|---|---|
| Formulários de criação de túnel | Token do dispositivo seleciona o dispositivo que atende o túnel. Para mover um túnel existente para outro dispositivo, use Trocar AuthToken no túnel: um túnel em execução para, espera 2 segundos e reinicia com o token selecionado. |
| Proxy rotativo | Usa grupos de tokens em vez de um único token. Cada dispositivo conectado de um grupo selecionado se torna uma saída do endpoint compartilhado. |
| Webhooks | Um webhook de token é configurado para um Grupo de tokens de autenticação. |
| Gerenciador de VPN | Ao adicionar um dispositivo a uma rede, você seleciona o token usado para entrar no Localtonet nesse dispositivo. Cada dispositivo precisa do seu próprio token. |
| Terminal de dispositivo | O token vincula um computador à sua conta em Meus dispositivos. |
| Dispositivos USB | Um token em Modo de dispositivo USB conecta o computador em que os modems ou celulares USB estão ligados. |
| Gerenciador de proxies | Cada celular Android entra com o seu próprio token. |
Você também pode listar, criar e excluir tokens e grupos de tokens com a API e o servidor MCP.
Enquanto uma equipe está selecionada no painel, Meus tokens mostra e cria os tokens dessa equipe. Veja Gerenciamento de equipe.
Solução de problemas #
Já existe um token chamado …
Os nomes de token são únicos. Escolha outro nome ou renomeie primeiro o token existente.
O nome não pode ter mais de 30 caracteres
Reduza o nome do token ou do grupo para 30 caracteres ou menos.
O token aparece como Offline
O dispositivo está desconectado. Abra o aplicativo Localtonet no dispositivo para conectar. Se outro dispositivo foi iniciado com o mesmo token, ele substituiu esta conexão: crie um token separado para cada dispositivo.
O cliente diz Wrong Token!
O valor não é um token completo. Copie o token completo de novo em Meus tokens: a lista oculta a parte do meio, então use o botão de copiar em vez de selecionar o texto visível.
PIN expirado
O PIN é válido por um minuto e funciona uma vez. Selecione Gerar novo PIN ou escaneie o QR code.
Não foi possível carregar o QR code e o PIN
Selecione Tentar de novo na caixa de diálogo. Se continuar falhando, copie o token e cole-o no aplicativo.