Ir para o conteúdo
Localtonet Localtonet Painel

AuthTokens

Ajuda com esta página
Nesta página 8 seções
  1. O que é um AuthToken
  2. Criar um token
  3. Abra Meus tokens
  4. Dê um nome ao dispositivo
  5. Copie o token para o aplicativo
  6. Escolha o dispositivo em Meus túneis
  7. A lista de tokens
  8. Histórico de IP
  9. Configurações do token
  10. Excluir um token
  11. Conectar um dispositivo Android com QR code ou PIN
  12. Abra Conectar dispositivo
  13. Escaneie o código ou digite o PIN
  14. Grupos de tokens
  15. Criar um grupo
  16. Escolher os tokens dele
  17. Onde os tokens são usados
  18. Solução de problemas
  19. 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 #

  1. Abra Meus tokens #

    Abra Meus tokens e expanda Criar token.

  2. Dê um nome ao dispositivo #

    Digite um nome reconhecível em Nome do token, por exemplo Office-PC, e selecione Criar token.

    RegraDetalhe
    ObrigatórioUm nome vazio mostra O nome é obrigatório!
    TamanhoNo máximo 30 caracteres.
    EspaçosNão são permitidos. O campo não aceita espaços, e os espaços de um nome colado são removidos.
    ÚnicoDois dos seus tokens não podem ter o mesmo nome.
  3. 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:

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    No Android, use o QR code ou o PIN. Veja Conectar um dispositivo Android abaixo.

  4. 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.

ColunaO que mostraO que você pode fazer
NomeO nome que você deu ao token.Selecione o nome para renomear o token. As regras de um novo nome se aplicam.
StatusOnline significa que o aplicativo Localtonet está conectado. Offline significa que o dispositivo está desconectado, mesmo que seus túneis continuem configurados.
TokenO token, com a parte do meio oculta.Selecione-o para copiar o token completo. O botão de QR abre Conectar dispositivo.
TúneisTúneis ativos / total de túneis vinculados a este token. Um dispositivo online não tem necessariamente um túnel ativo.
ClienteA ú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.
DispositivoUso 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çõesHistó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çãoO que fazValores
Modo de dispositivo USBUse 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 clienteSalva 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.

  1. Abra Conectar dispositivo #

    Em Meus tokens, selecione o botão de QR ao lado do token. A caixa de diálogo Conectar dispositivo abre.

  2. 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.

  1. 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.

  2. 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 #

LocalComo o token é usado
Formulários de criação de túnelToken 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 rotativoUsa grupos de tokens em vez de um único token. Cada dispositivo conectado de um grupo selecionado se torna uma saída do endpoint compartilhado.
WebhooksUm webhook de token é configurado para um Grupo de tokens de autenticação.
Gerenciador de VPNAo 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 dispositivoO token vincula um computador à sua conta em Meus dispositivos.
Dispositivos USBUm token em Modo de dispositivo USB conecta o computador em que os modems ou celulares USB estão ligados.
Gerenciador de proxiesCada 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.

Suporte