AuthTokens
Auf dieser Seite 8 Abschnitte
- Was ein AuthToken ist
- Token erstellen
- Meine Tokens öffnen
- Das Gerät benennen
- Das Token in die App kopieren
- Das Gerät unter Meine Tunnel auswählen
- Die Token-Liste
- IP-Verlauf
- Token-Einstellungen
- Ein Token löschen
- Ein Android-Gerät mit QR-Code oder PIN verbinden
- Gerät verbinden öffnen
- Code scannen oder PIN eingeben
- Token-Gruppen
- Eine Gruppe erstellen
- Ihre Tokens auswählen
- Wo Tokens verwendet werden
- Fehlerbehebung
- Verwandte Seiten
Ein AuthToken verbindet die Localtonet-App auf einem Gerät mit Ihrem Konto. Erstellen Sie unter Meine Tokens für jedes Gerät ein Token, melden Sie das Gerät damit an und wählen Sie dieses Token dann beim Erstellen eines Tunnels.
Was ein AuthToken ist #
Die Localtonet-App meldet sich mit einem AuthToken statt mit E-Mail und Passwort an. Im Dashboard steht das Token für das Gerät, das es verwendet: Ein Tunnel wird für ein Token erstellt und funktioniert, solange die App, die dieses Token verwendet, verbunden ist.
- Geben Sie jedem Gerät ein eigenes Token. Eine neue Verbindung mit demselben Token ersetzt die vorherige.
- Der Name eines Tokens ist nur eine Bezeichnung. Das Token selbst erzeugt Localtonet.
- Ein AuthToken meldet ein Gerät an. Es schützt keinen Tunnel vor Besuchern. Dafür siehe Zugriffskontrolle.
Halten Sie Ihre Tokens geheim. Jeder, der das Token besitzt, kann sich damit in der App anmelden. Dasselbe gilt für den QR-Code und die PIN eines Tokens.
Token erstellen #
-
Meine Tokens öffnen #
Öffnen Sie Meine Tokens und klappen Sie Token erstellen auf.
-
Das Gerät benennen #
Geben Sie unter Token-Name einen erkennbaren Namen ein, zum Beispiel
Office-PC, und wählen Sie Token erstellen.Regel Detail Erforderlich Ein leerer Name zeigt Ein Name ist erforderlich! Länge Höchstens 30 Zeichen. Leerzeichen Nicht erlaubt. Das Feld akzeptiert keine Leerzeichen, und Leerzeichen in einem eingefügten Namen werden entfernt. Eindeutig Zwei Ihrer Tokens dürfen nicht denselben Namen haben. -
Das Token in die App kopieren #
Das neue Token erscheint unter Ihre Tokens. Wählen Sie es aus, um das vollständige Token zu kopieren, und starten Sie die Localtonet-App damit:
Terminallocaltonet --authtoken <YOUR_TOKEN>Verwenden Sie unter Android stattdessen den QR-Code oder die PIN. Siehe Android-Gerät verbinden weiter unten.
-
Das Gerät unter Meine Tunnel auswählen #
Wählen Sie beim Erstellen eines Tunnels dieses Token unter Geräte-Token. Der Schnellstart zeigt den gesamten Ablauf.
Die Token-Liste #
Ihre Tokens listet jedes Token des Kontos auf, in dem Sie gerade arbeiten. Mit Tokens suchen filtern Sie nach Name oder Token, mit Aktualisieren laden Sie die Liste neu. Auf einem schmalen Bildschirm wandern einige Spalten hinter die Schaltfläche Details der jeweiligen Zeile.
| Spalte | Was sie zeigt | Was Sie tun können |
|---|---|---|
| Name | Der Name, den Sie dem Token gegeben haben. | Wählen Sie den Namen, um das Token umzubenennen. Es gelten die Regeln für einen neuen Namen. |
| Status | Online bedeutet, dass die Localtonet-App verbunden ist. Offline bedeutet, dass das Gerät getrennt ist, auch wenn seine Tunnel noch konfiguriert sind. | |
| Token | Das Token, wobei der mittlere Teil ausgeblendet ist. | Wählen Sie es, um das vollständige Token zu kopieren. Die QR-Schaltfläche öffnet Gerät verbinden. |
| Tunnel | Aktive Tunnel / Tunnel insgesamt, die mit diesem Token verknüpft sind. Ein Gerät, das online ist, hat nicht zwangsläufig einen aktiven Tunnel. | |
| Client | Die zuletzt gemeldete App-Version und ihr Update-Status. | Ein Badge Update nötig verweist auf die Download-Seite, damit Sie die neueste Localtonet-App installieren können. Verbinden Sie das Gerät, um diese Angaben zu aktualisieren. |
| Gerät | Thread-Auslastung, Akkustand und Akkutemperatur, wie sie das Gerät zuletzt gemeldet hat. | Für Android-Geräte: Android-Geräteeinstellungen, SMS-Einstellungen, sofern unterstützt, und Aktionsprotokolle des Geräts. Der Proxy-Manager bietet dieselben Steuerelemente für eine ganze Flotte. |
| Aktionen | IP-Verlauf, Token-Einstellungen, Token löschen. |
IP-Verlauf #
IP-Verlauf öffnet die Liste der öffentlichen IP-Adressen, die für das Token erfasst wurden, jeweils mit Datum. Über der Liste sehen Sie vier Zähler: Wiederholungen gesamt, Wiederholte IPs gesamt, Wiederholte IPs in der letzten Stunde und IPs gesamt in der letzten Stunde. Wählen Sie Aktualisieren, um sie zu aktualisieren. Das ist besonders nützlich bei einem Gerät, dessen IP sich ändert, etwa einem Telefon, das seine Mobilfunk-IP rotiert.
Token-Einstellungen #
Token-Einstellungen öffnet ein Panel mit dem vollständigen Token, einer Schaltfläche Token kopieren, der Schaltfläche QR / PIN und zwei Einstellungen:
| Einstellung | Funktion | Werte |
|---|---|---|
| USB-Gerätemodus | Verwenden Sie diesen Modus, wenn das Token ein USB-Gerät verbindet. Dessen Geräte verwalten Sie unter Meine USB-Geräte. | Ja oder Nein. Die Änderung verlangt eine Bestätigung. |
| Client-Argumente | Speichert Client-Optionen beim Token. Wählen Sie Verwalten, schalten Sie Aktiv ein und füllen Sie Argumente aus. Der Localtonet-Client wendet die hier gespeicherten Argumente nicht an; er wendet die Argumente an, die bei einem Tunnel festgelegt sind. Um eine Netzwerkschnittstelle oder eine lokale IP-Adresse zu wählen, legen Sie sie bei jedem Tunnel fest. | Ist Aktiv eingeschaltet, darf das Feld nicht leer sein. Siehe Netzwerkauswahl. |
Ein Token löschen #
Wählen Sie Token löschen und bestätigen Sie. Das Dashboard warnt Sie zuvor:
Tunnel mit diesem Token werden gestoppt und gelöscht. Ein Gerät, das das Token noch verwendet, kann sich damit nicht mehr verbinden. Erstellen Sie für dieses Gerät ein neues Token, wenn Sie es wieder benötigen.
Ein Android-Gerät mit QR-Code oder PIN verbinden #
Auf einem Telefon müssen Sie kein Token eintippen. Jedes Token hat einen QR-Code und eine kurze PIN.
-
Gerät verbinden öffnen #
Wählen Sie unter Meine Tokens die QR-Schaltfläche neben dem Token. Der Dialog Gerät verbinden öffnet sich.
-
Code scannen oder PIN eingeben #
Öffnen Sie Localtonet für Android. Scannen Sie entweder den Code unter QR-Code scannen oder geben Sie die sechsstellige PIN, die unter Stattdessen eine PIN eingeben angezeigt wird, in das Anmeldefeld der App ein und wählen Sie Connect.
- Die PIN ist eine Minute gültig. Der Dialog zählt herunter und zeigt dann PIN abgelaufen. Erzeugen Sie eine neue PIN, um fortzufahren.
- Eine PIN funktioniert einmal. Wählen Sie Neue PIN erzeugen für ein anderes Gerät oder einen weiteren Versuch.
- Der QR-Code läuft nicht ab. Er enthält das Token selbst, behandeln Sie ein Foto davon daher wie das Token.
- Sie können das Token auch in die App einfügen. Der Dialog zeigt es mit einer Kopierschaltfläche an.
Token-Gruppen #
Eine Token-Gruppe enthält Geräte-Tokens. Gruppen ordnen Geräte zu Pools: Ein Rotierender Proxy verwendet die Geräte der Gruppen, die Sie auswählen, und ein Token-Webhook wird für eine Gruppe erstellt.
-
Eine Gruppe erstellen #
Klappen Sie unter Meine Tokens Token-Gruppen auf, geben Sie einen Gruppenname ein und wählen Sie Gruppe erstellen. Der Name darf höchstens 30 Zeichen lang sein, keine Leerzeichen enthalten und muss unter Ihren Gruppen eindeutig sein.
-
Ihre Tokens auswählen #
Der Dialog Token-Gruppe verwalten öffnet sich mit einer Liste aller Ihrer Tokens. Haken Sie die Geräte-Tokens an, die zur Gruppe gehören, und wählen Sie Änderungen speichern.
Um eine Gruppe später zu ändern, wählen Sie in ihrer Zeile Verwalten. Der Dialog ist für lange Listen gemacht:
- Suchen Sie nach Namen. Trennen Sie mehrere Namen mit Kommas.
- Filtern Sie nach Gerätestatus: Beliebiger Status, Online oder Offline.
- Wechseln Sie zwischen Alle, In der Gruppe und Nicht in der Gruppe.
- Mit Alle auswählen haken Sie jedes angezeigte Token an und entfernen dann die Haken bei denen, die Sie auslassen möchten. Umschalt+Klick wählt einen Bereich aus.
- Die Fußzeile zeigt, was sich ändern wird, zum Beispiel +3 hinzuzufügen. Zurücksetzen verwirft Ihre Änderungen.
Wenn Sie Tokens aus einer Gruppe entfernen, bittet der Dialog um Bestätigung, weil rotierende Proxys, die die Gruppe verwenden, auf diesen Geräten anhalten. Ein Speichervorgang kann bis zu 5000 Tokens ändern.
Gruppe löschen entfernt die Gruppe und ihre Zuordnungen. Die Tokens selbst bleiben erhalten.
Wo Tokens verwendet werden #
| Ort | Wie das Token verwendet wird |
|---|---|
| Formulare zum Erstellen von Tunneln | Geräte-Token wählt das Gerät aus, das den Tunnel bereitstellt. Um einen vorhandenen Tunnel auf ein anderes Gerät zu verschieben, verwenden Sie beim Tunnel AuthToken ändern: Ein laufender Tunnel stoppt, wartet 2 Sekunden und startet dann mit dem gewählten Token neu. |
| Rotierender Proxy | Verwendet Token-Gruppen statt eines einzelnen Tokens. Jedes verbundene Gerät in einer ausgewählten Gruppe wird zu einem Ausgang des gemeinsamen Endpunkts. |
| Webhooks | Ein Token-Webhook wird für eine Auth-Token-Gruppe eingerichtet. |
| VPN-Manager | Wenn Sie einem Netzwerk ein Gerät hinzufügen, wählen Sie das Token, mit dem Localtonet auf diesem Gerät angemeldet ist. Jedes Gerät benötigt ein eigenes Token. |
| Geräte-Terminal | Das Token verknüpft einen Computer unter Meine Geräte mit Ihrem Konto. |
| USB-Geräte | Ein Token im USB-Gerätemodus verbindet den Computer, an dem USB-Modems oder -Telefone angeschlossen sind. |
| Proxy-Manager | Jedes Android-Telefon meldet sich mit einem eigenen Token an. |
Tokens und Token-Gruppen lassen sich auch mit der API und dem MCP-Server auflisten, erstellen und löschen.
Solange im Dashboard ein Team ausgewählt ist, zeigt Meine Tokens die Tokens dieses Teams an und erstellt neue für das Team. Siehe Teamverwaltung.
Fehlerbehebung #
Ein Token mit dem Namen … existiert bereits
Token-Namen sind eindeutig. Wählen Sie einen anderen Namen oder benennen Sie zuerst das vorhandene Token um.
Der Name darf nicht länger als 30 Zeichen sein
Kürzen Sie den Token-Namen oder den Gruppennamen auf höchstens 30 Zeichen.
Das Token zeigt Offline
Das Gerät ist getrennt. Öffnen Sie die Localtonet-App auf dem Gerät, um sich zu verbinden. Wurde ein anderes Gerät mit demselben Token gestartet, hat es diese Verbindung ersetzt: Erstellen Sie für jedes Gerät ein eigenes Token.
Der Client meldet Wrong Token!
Der Wert ist kein vollständiges Token. Kopieren Sie das vollständige Token erneut aus Meine Tokens: Die Liste blendet den mittleren Teil aus, verwenden Sie also die Kopierschaltfläche, statt den sichtbaren Text zu markieren.
PIN abgelaufen
Die PIN ist eine Minute gültig und funktioniert einmal. Wählen Sie Neue PIN erzeugen oder scannen Sie stattdessen den QR-Code.
QR-Code und PIN konnten nicht geladen werden
Wählen Sie im Dialog Erneut versuchen. Schlägt es weiterhin fehl, kopieren Sie das Token und fügen Sie es in die App ein.