AuthToken
In questa pagina 8 sezioni
- Cos'è un AuthToken
- Crea un token
- Apri I miei token
- Dai un nome al dispositivo
- Copia il token nell'app
- Scegli il dispositivo in I miei tunnel
- L'elenco dei token
- Cronologia IP
- Impostazioni del token
- Elimina un token
- Connetti un dispositivo Android con un codice QR o un PIN
- Apri Connetti dispositivo
- Scansiona il codice o inserisci il PIN
- Gruppi di token
- Crea un gruppo
- Scegli i suoi token
- Dove si usano i token
- Risoluzione dei problemi
- Pagine correlate
Un AuthToken collega l'app Localtonet di un dispositivo al tuo account. Crea un token per ogni dispositivo in I miei token, fai accedere il dispositivo con quel token, poi scegli quel token quando crei un tunnel.
Cos'è un AuthToken #
L'app Localtonet accede con un AuthToken invece che con email e password. Nella dashboard il token rappresenta il dispositivo che lo usa: un tunnel viene creato per un token e funziona finché l'app che usa quel token è connessa.
- Dai a ogni dispositivo il suo token. Una nuova connessione che usa lo stesso token sostituisce la precedente.
- Il nome di un token è solo un'etichetta. Il token vero e proprio lo genera Localtonet.
- Un AuthToken fa accedere un dispositivo. Non protegge un tunnel dai visitatori. Per questo, vedi Controllo degli accessi.
Tieni privati i tuoi token. Chiunque abbia il token può usarlo per accedere all'app. Lo stesso vale per il codice QR e il PIN di un token.
Crea un token #
-
Apri I miei token #
Apri I miei token ed espandi Crea token.
-
Dai un nome al dispositivo #
Inserisci un nome riconoscibile in Nome del token, ad esempio
Office-PC, e seleziona Crea token.Regola Dettaglio Obbligatorio Un nome vuoto mostra Il nome personalizzato è obbligatorio! Lunghezza Al massimo 30 caratteri. Spazi Non consentiti. Il campo non accetta spazi e quelli di un nome incollato vengono rimossi. Univoco Due dei tuoi token non possono avere lo stesso nome. -
Copia il token nell'app #
Il nuovo token compare in I tuoi token. Selezionalo per copiare il token completo, poi avvia l'app Localtonet con esso:
Terminalelocaltonet --authtoken <YOUR_TOKEN>Su Android usa invece il codice QR o il PIN. Vedi Connetti un dispositivo Android più sotto.
-
Scegli il dispositivo in I miei tunnel #
Quando crei un tunnel, seleziona questo token in Token del dispositivo. La Guida rapida mostra l'intero procedimento.
L'elenco dei token #
I tuoi token elenca tutti i token dell'account in cui stai lavorando. Usa Cerca token per filtrare per nome o token e Aggiorna per ricaricare l'elenco. Su uno schermo stretto alcune colonne passano dietro il pulsante Dettagli di ogni riga.
| Colonna | Cosa mostra | Cosa puoi fare |
|---|---|---|
| Nome | Il nome che hai dato al token. | Seleziona il nome per rinominare il token. Valgono le regole per un nuovo nome. |
| Stato | Online significa che l'app Localtonet è connessa. Offline significa che il dispositivo è disconnesso, anche se i suoi tunnel sono ancora configurati. | |
| Token | Il token, con la parte centrale nascosta. | Selezionalo per copiare il token completo. Il pulsante QR apre Connetti dispositivo. |
| Tunnel | Tunnel attivi / tunnel totali collegati a questo token. Un dispositivo online non ha necessariamente un tunnel attivo. | |
| Client | L'ultima versione dell'app segnalata e il suo stato di aggiornamento. | Un badge Aggiornamento necessario rimanda alla pagina di download, così puoi installare l'ultima app Localtonet. Connetti il dispositivo per aggiornare questa informazione. |
| Dispositivo | Uso dei thread, livello della batteria e temperatura della batteria, come ultimo segnalato dal dispositivo. | Per i dispositivi Android: Impostazioni del dispositivo Android, Impostazioni SMS quando supportate e Log delle azioni del dispositivo. Il Gestore proxy offre gli stessi controlli per un'intera flotta. |
| Azioni | Cronologia IP, Impostazioni del token, Elimina token. |
Cronologia IP #
Cronologia IP apre l'elenco degli indirizzi IP pubblici registrati per il token, ciascuno con la sua data. Sopra l'elenco vedi quattro contatori: Totale ripetuti, Totale IP ripetuti, IP ripetuti nell'ultima ora e Totale IP nell'ultima ora. Seleziona Aggiorna per aggiornarli. È utile soprattutto per un dispositivo il cui IP cambia, come un telefono che ruota il proprio IP mobile.
Impostazioni del token #
Impostazioni del token apre un pannello con il token completo, un pulsante Copia token, il pulsante QR / PIN e due impostazioni:
| Impostazione | Cosa fa | Valori |
|---|---|---|
| Modalità dispositivo USB | Usa questa modalità quando il token collega un dispositivo USB. Gestisci i suoi dispositivi da I miei dispositivi USB. | Sì o No. La modifica chiede una conferma. |
| Argomenti del client | Salva le opzioni del client insieme al token. Seleziona Gestisci, attiva Attivo e compila Argomenti. Il client Localtonet non applica gli argomenti salvati qui; applica gli Argomenti impostati su un tunnel. Per scegliere un'interfaccia di rete o un indirizzo IP locale, impostali su ogni tunnel. | Con Attivo acceso, il campo non può essere vuoto. Vedi Selezione della rete. |
Elimina un token #
Seleziona Elimina token e conferma. La dashboard ti avvisa prima:
I tunnel con questo token verranno fermati ed eliminati. Un dispositivo che usa ancora il token non può più connettersi con esso. Crea un nuovo token per quel dispositivo se ti serve di nuovo.
Connetti un dispositivo Android con un codice QR o un PIN #
Non devi digitare un token su un telefono. Ogni token ha un codice QR e un PIN breve.
-
Apri Connetti dispositivo #
In I miei token, seleziona il pulsante QR accanto al token. Si apre la finestra Connetti dispositivo.
-
Scansiona il codice o inserisci il PIN #
Apri Localtonet per Android. Scansiona il codice sotto Scansiona il codice QR, oppure digita il PIN di sei cifre mostrato sotto Oppure inserisci un PIN nel campo di accesso dell'app e seleziona Connect.
- Il PIN è valido per un minuto. La finestra conta alla rovescia e poi mostra PIN scaduto. Genera un nuovo PIN per continuare.
- Un PIN funziona una sola volta. Seleziona Genera nuovo PIN per un altro dispositivo o un altro tentativo.
- Il codice QR non scade. Contiene il token stesso, quindi tratta una sua foto come il token.
- Puoi anche incollare il token nell'app. La finestra lo mostra con un pulsante di copia.
Gruppi di token #
Un gruppo di token contiene token di dispositivi. I gruppi organizzano i dispositivi in pool: un Proxy a rotazione usa i dispositivi dei gruppi che selezioni e un webhook di token viene creato per un gruppo.
-
Crea un gruppo #
In I miei token, espandi Gruppi di token, inserisci un Nome del gruppo e seleziona Crea gruppo. Il nome può avere al massimo 30 caratteri, non contiene spazi e deve essere univoco tra i tuoi gruppi.
-
Scegli i suoi token #
Si apre la finestra Gestisci gruppo di token con l'elenco di tutti i tuoi token. Spunta i token dei dispositivi che appartengono al gruppo e seleziona Salva modifiche.
Per modificare un gruppo in seguito, seleziona Gestisci nella sua riga. La finestra è pensata per elenchi lunghi:
- Cerca per nome. Separa più nomi con virgole.
- Filtra per stato del dispositivo: Qualsiasi stato, Online oppure Offline.
- Passa tra Tutti, Nel gruppo e Non nel gruppo.
- Usa Seleziona tutti per spuntare ogni token mostrato, poi deseleziona quelli da escludere. Maiusc+clic seleziona un intervallo.
- Il piè di pagina mostra cosa cambierà, ad esempio +3 da aggiungere. Reimposta annulla le tue modifiche.
Quando rimuovi token da un gruppo, la finestra ti chiede di confermare, perché i proxy a rotazione che usano il gruppo si fermano su quei dispositivi. Un solo salvataggio può modificare fino a 5000 token.
Elimina gruppo rimuove il gruppo e le sue appartenenze. I token restano.
Dove si usano i token #
| Posizione | Come si usa il token |
|---|---|
| Moduli di creazione dei tunnel | Token del dispositivo seleziona il dispositivo che serve il tunnel. Per spostare un tunnel esistente su un altro dispositivo, usa Cambia AuthToken sul tunnel: un tunnel in esecuzione si ferma, attende 2 secondi e poi riparte con il token selezionato. |
| Proxy a rotazione | Usa gruppi di token invece di un singolo token. Ogni dispositivo connesso di un gruppo selezionato diventa un'uscita dell'endpoint condiviso. |
| Webhook | Un webhook di token si configura per un Gruppo di Auth Token. |
| Gestore VPN | Quando aggiungi un dispositivo a una rete, selezioni il token usato per accedere a Localtonet su quel dispositivo. Ogni dispositivo ha bisogno del suo token. |
| Terminale dispositivo | Il token collega un computer al tuo account in I miei dispositivi. |
| Dispositivi USB | Un token in Modalità dispositivo USB collega il computer a cui sono collegati modem USB o telefoni. |
| Gestore proxy | Ogni telefono Android accede con il suo token. |
Puoi anche elencare, creare ed eliminare token e gruppi di token con l'API e il server MCP.
Quando nella dashboard è selezionato un team, I miei token mostra e crea i token di quel team. Vedi Gestione team.
Risoluzione dei problemi #
Esiste già un token chiamato …
I nomi dei token sono univoci. Scegli un altro nome, oppure rinomina prima il token esistente.
Il nome non può superare 30 caratteri
Accorcia il nome del token o del gruppo a 30 caratteri o meno.
Il token mostra Offline
Il dispositivo è disconnesso. Apri l'app Localtonet sul dispositivo per connetterlo. Se un altro dispositivo è stato avviato con lo stesso token, ha sostituito questa connessione: crea un token separato per ogni dispositivo.
Il client dice Wrong Token!
Il valore non è un token completo. Copia di nuovo il token completo da I miei token: l'elenco nasconde la parte centrale, quindi usa il pulsante di copia invece di selezionare il testo visibile.
PIN scaduto
Il PIN è valido per un minuto e funziona una sola volta. Seleziona Genera nuovo PIN, oppure scansiona il codice QR.
Impossibile caricare il codice QR e il PIN
Seleziona Riprova nella finestra. Se continua a fallire, copia il token e incollalo nell'app.