AuthTokens
Op deze pagina 8 secties
- Wat een AuthToken is
- Een token aanmaken
- Open Mijn tokens
- Geef het apparaat een naam
- Kopieer het token naar de app
- Kies het apparaat in Mijn tunnels
- De tokenlijst
- IP-geschiedenis
- Tokeninstellingen
- Een token verwijderen
- Een Android-apparaat verbinden met een QR-code of pincode
- Open Apparaat verbinden
- Scan de code of voer de pincode in
- Tokengroepen
- Een groep aanmaken
- Kies de tokens
- Waar tokens worden gebruikt
- Probleemoplossing
- Gerelateerde pagina's
Een AuthToken koppelt de Localtonet-app op één apparaat aan je account. Maak onder Mijn tokens voor elk apparaat een token aan, log het apparaat ermee in en kies dat token wanneer je een tunnel aanmaakt.
Wat een AuthToken is #
De Localtonet-app logt in met een AuthToken in plaats van met je e-mailadres en wachtwoord. In het dashboard staat het token voor het apparaat dat het gebruikt: een tunnel wordt voor een token aangemaakt en werkt zolang de app die dit token gebruikt, verbonden is.
- Geef elk apparaat een eigen token. Een nieuwe verbinding met hetzelfde token vervangt de vorige.
- De naam van een token is alleen een label. Het token zelf wordt door Localtonet gegenereerd.
- Een AuthToken logt een apparaat in. Het beschermt een tunnel niet tegen bezoekers. Zie daarvoor Toegangsbeheer.
Houd je tokens privé. Iedereen met het token kan ermee inloggen in de app. Hetzelfde geldt voor de QR-code en de pincode van een token.
Een token aanmaken #
-
Open Mijn tokens #
Open Mijn tokens en klap Token aanmaken uit.
-
Geef het apparaat een naam #
Voer een herkenbare naam in bij Tokennaam, bijvoorbeeld
Office-PC, en kies Token aanmaken.Regel Details Verplicht Een lege naam toont Naam is verplicht! Lengte Maximaal 30 tekens. Spaties Niet toegestaan. Het veld accepteert geen spaties, en spaties in een geplakte naam worden verwijderd. Uniek Twee van je tokens kunnen niet dezelfde naam hebben. -
Kopieer het token naar de app #
Het nieuwe token verschijnt onder Jouw tokens. Kies het om het volledige token te kopiëren en start daarmee de Localtonet-app:
Terminallocaltonet --authtoken <YOUR_TOKEN>Gebruik op Android in plaats daarvan de QR-code of de pincode. Zie Een Android-apparaat verbinden hieronder.
-
Kies het apparaat in Mijn tunnels #
Kies bij het aanmaken van een tunnel dit token in Apparaattoken. De Snelstart toont de hele stroom.
De tokenlijst #
Jouw tokens toont elk token van het account waarin je werkt. Gebruik Tokens zoeken om op naam of token te filteren en Vernieuwen om de lijst opnieuw te laden. Op een smal scherm verhuizen sommige kolommen naar de knop Details van elke rij.
| Kolom | Wat het toont | Wat je kunt doen |
|---|---|---|
| Naam | De naam die je het token hebt gegeven. | Kies de naam om het token te hernoemen. De regels voor een nieuwe naam gelden. |
| Status | Online betekent dat de Localtonet-app is verbonden. Offline betekent dat het apparaat is losgekoppeld, ook als de tunnels ervan nog zijn geconfigureerd. | |
| Token | Het token, met het middelste deel verborgen. | Kies het om het volledige token te kopiëren. De QR-knop opent Apparaat verbinden. |
| Tunnels | Actieve tunnels / totaal aantal tunnels dat aan dit token is gekoppeld. Een online apparaat heeft niet per se een actieve tunnel. | |
| Client | De laatst gemelde appversie en de updatestatus. | Een badge Update nodig verwijst naar de downloadpagina, zodat je de nieuwste Localtonet-app kunt installeren. Verbind het apparaat om deze informatie te vernieuwen. |
| Apparaat | Threadgebruik, batterijniveau en batterijtemperatuur, zoals het apparaat die het laatst heeft gemeld. | Voor Android-apparaten: Android-apparaatinstellingen, Sms-instellingen indien ondersteund, en Actielogboeken van het apparaat. Proxybeheer biedt dezelfde bediening voor een hele vloot. |
| Acties | IP-geschiedenis, Tokeninstellingen, Token verwijderen. |
IP-geschiedenis #
IP-geschiedenis opent de lijst met openbare IP-adressen die voor het token zijn vastgelegd, elk met de datum. Boven de lijst zie je vier tellers: Totaal herhaald, Totaal herhaalde IP's, Herhaalde IP's laatste uur en Totaal IP's laatste uur. Kies Vernieuwen om ze bij te werken. Dit is vooral nuttig voor een apparaat waarvan het IP verandert, zoals een telefoon die zijn mobiele IP roteert.
Tokeninstellingen #
Tokeninstellingen opent een paneel met het volledige token, een knop Token kopiëren, de knop QR / PIN en twee instellingen:
| Instelling | Wat het doet | Waarden |
|---|---|---|
| USB-apparaatmodus | Gebruik deze modus wanneer het token een USB-apparaat verbindt. Je beheert de apparaten ervan via Mijn USB-apparaten. | Ja of Nee. De wijziging vraagt om bevestiging. |
| Clientargumenten | Slaat clientopties op bij het token. Kies Beheren, schakel Actief in en vul Argumenten in. De Localtonet-client past de hier opgeslagen argumenten niet toe; hij past de Argumenten toe die op een tunnel zijn ingesteld. Om een netwerkinterface of een lokaal IP-adres te kiezen, stel je die in op elke tunnel. | Als Actief aan staat, mag het veld niet leeg zijn. Zie Netwerkselectie. |
Een token verwijderen #
Kies Token verwijderen en bevestig. Het dashboard waarschuwt je eerst:
Tunnels met dit token worden gestopt en verwijderd. Een apparaat dat het token nog gebruikt, kan er niet meer mee verbinden. Maak een nieuw token voor dat apparaat als je het opnieuw nodig hebt.
Een Android-apparaat verbinden met een QR-code of pincode #
Op een telefoon hoef je geen token te typen. Elk token heeft een QR-code en een korte pincode.
-
Open Apparaat verbinden #
Kies op Mijn tokens de QR-knop naast het token. Het dialoogvenster Apparaat verbinden wordt geopend.
-
Scan de code of voer de pincode in #
Open Localtonet voor Android. Scan de code onder QR-code scannen, of typ de zescijferige pincode die onder Of voer een pincode in staat in het inlogveld van de app en kies Connect.
- De pincode is één minuut geldig. Het dialoogvenster telt af en toont daarna Pincode verlopen. Genereer een nieuwe pincode om verder te gaan.
- Een pincode werkt één keer. Kies Nieuwe pincode genereren voor een ander apparaat of een nieuwe poging.
- De QR-code verloopt niet. Hij bevat het token zelf, dus behandel een foto ervan als het token.
- Je kunt het token ook in de app plakken. Het dialoogvenster toont het met een kopieerknop.
Tokengroepen #
Een tokengroep bevat apparaattokens. Groepen organiseren apparaten in pools: een Roterende proxy gebruikt de apparaten van de groepen die je selecteert, en een tokenwebhook wordt voor een groep aangemaakt.
-
Een groep aanmaken #
Klap op Mijn tokens Tokengroepen uit, voer een Groepsnaam in en kies Groep aanmaken. De naam mag maximaal 30 tekens bevatten, heeft geen spaties en moet uniek zijn onder je groepen.
-
Kies de tokens #
Het dialoogvenster Tokengroep beheren wordt geopend met een lijst van al je tokens. Vink de apparaattokens aan die bij de groep horen en kies Wijzigingen opslaan.
Om een groep later te wijzigen, kies je Beheren in de rij ervan. Het dialoogvenster is gebouwd voor lange lijsten:
- Zoek op naam. Scheid meerdere namen met komma's.
- Filter op apparaatstatus: Elke status, Online of Offline.
- Schakel tussen Alle, In groep en Niet in groep.
- Gebruik Alles selecteren om elk getoond token aan te vinken en haal daarna de vinkjes weg bij de tokens die je wilt uitsluiten. Shift+klik selecteert een bereik.
- De voettekst toont wat er gaat veranderen, bijvoorbeeld +3 toe te voegen. Herstellen verwerpt je wijzigingen.
Wanneer je tokens uit een groep verwijdert, vraagt het dialoogvenster om bevestiging, omdat roterende proxy's die de groep gebruiken op die apparaten stoppen. Eén keer opslaan kan maximaal 5000 tokens wijzigen.
Groep verwijderen verwijdert de groep en de lidmaatschappen. De tokens zelf blijven bestaan.
Waar tokens worden gebruikt #
| Plaats | Hoe het token wordt gebruikt |
|---|---|
| Formulieren voor het aanmaken van tunnels | Apparaattoken selecteert het apparaat dat de tunnel bedient. Om een bestaande tunnel naar een ander apparaat te verplaatsen, gebruik je AuthToken wijzigen bij de tunnel: een draaiende tunnel stopt, wacht 2 seconden en start dan opnieuw met het geselecteerde token. |
| Roterende proxy | Gebruikt tokengroepen in plaats van één token. Elk verbonden apparaat in een geselecteerde groep wordt een uitgang van het gedeelde endpoint. |
| Webhooks | Een tokenwebhook wordt ingesteld voor een AuthToken-groep. |
| VPN-beheer | Wanneer je een apparaat aan een netwerk toevoegt, selecteer je het token waarmee op dat apparaat bij Localtonet wordt ingelogd. Elk apparaat heeft een eigen token nodig. |
| Apparaatterminal | Het token koppelt een computer aan je account onder Mijn apparaten. |
| USB-apparaten | Een token in USB-apparaatmodus verbindt de computer waarop USB-modems of telefoons zijn aangesloten. |
| Proxybeheer | Elke Android-telefoon logt in met een eigen token. |
Je kunt tokens en tokengroepen ook weergeven, maken en verwijderen met de API en de MCP-server.
Zolang er in het dashboard een team is geselecteerd, toont en maakt Mijn tokens de tokens van dat team. Zie Teambeheer.
Probleemoplossing #
Je hebt al een token met de naam …
Tokennamen zijn uniek. Kies een andere naam, of hernoem eerst het bestaande token.
De naam mag niet langer zijn dan 30 tekens
Kort de tokennaam of de groepsnaam in tot maximaal 30 tekens.
Het token toont Offline
Het apparaat is losgekoppeld. Open de Localtonet-app op het apparaat om te verbinden. Als een ander apparaat met hetzelfde token is gestart, heeft het deze verbinding vervangen: maak voor elk apparaat een apart token aan.
De client meldt Wrong Token!
De waarde is geen volledig token. Kopieer het volledige token opnieuw uit Mijn tokens: de lijst verbergt het middelste deel, dus gebruik de kopieerknop in plaats van de zichtbare tekst te selecteren.
Pincode verlopen
De pincode is één minuut geldig en werkt één keer. Kies Nieuwe pincode genereren, of scan in plaats daarvan de QR-code.
De QR-code en pincode kunnen niet worden geladen
Kies Opnieuw proberen in het dialoogvenster. Als het blijft mislukken, kopieer dan het token en plak het in de app.