Aller au contenu
Localtonet Localtonet Tableau de bord

AuthTokens

Aide pour cette page
Sur cette page 8 sections
  1. Ce qu'est un AuthToken
  2. Créer un jeton
  3. Ouvrir Mes jetons
  4. Nommer l'appareil
  5. Copier le jeton dans l'application
  6. Choisir l'appareil dans Mes tunnels
  7. La liste des jetons
  8. Historique IP
  9. Paramètres du jeton
  10. Supprimer un jeton
  11. Connecter un appareil Android avec un QR code ou un PIN
  12. Ouvrir Connecter l'appareil
  13. Scanner le code ou saisir le PIN
  14. Groupes de jetons
  15. Créer un groupe
  16. Choisir ses jetons
  17. Où les jetons sont utilisés
  18. Dépannage
  19. Pages associées

Un AuthToken relie l'application Localtonet d'un appareil à votre compte. Créez un jeton pour chaque appareil dans Mes jetons, connectez l'appareil avec ce jeton, puis choisissez ce jeton lorsque vous créez un tunnel.

Ce qu'est un AuthToken #

L'application Localtonet se connecte avec un AuthToken à la place de votre e-mail et de votre mot de passe. Dans le tableau de bord, le jeton représente l'appareil qui l'utilise : un tunnel est créé pour un jeton, et il fonctionne tant que l'application qui utilise ce jeton est connectée.

  • Donnez à chaque appareil son propre jeton. Une nouvelle connexion qui utilise le même jeton remplace la précédente.
  • Le nom d'un jeton n'est qu'une étiquette. Localtonet génère lui-même le jeton.
  • Un AuthToken connecte un appareil. Il ne protège pas un tunnel contre les visiteurs. Pour cela, voir Contrôle d'accès.

Gardez vos jetons privés. Toute personne qui possède le jeton peut s'en servir pour se connecter à l'application. Il en va de même pour le QR code et le PIN d'un jeton.

Créer un jeton #

  1. Ouvrir Mes jetons #

    Ouvrez Mes jetons et développez Créer un jeton.

  2. Nommer l'appareil #

    Saisissez un nom reconnaissable dans Nom du jeton, par exemple Office-PC, et sélectionnez Créer un jeton.

    RègleDétail
    ObligatoireUn nom vide affiche Le nom est obligatoire !
    Longueur30 caractères au maximum.
    EspacesNon autorisés. Le champ n'accepte pas les espaces, et les espaces d'un nom collé sont supprimés.
    UniqueDeux de vos jetons ne peuvent pas porter le même nom.
  3. Copier le jeton dans l'application #

    Le nouveau jeton apparaît sous Vos jetons. Sélectionnez-le pour copier le jeton complet, puis démarrez l'application Localtonet avec celui-ci :

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    Sur Android, utilisez plutôt le QR code ou le PIN. Voir Connecter un appareil Android ci-dessous.

  4. Choisir l'appareil dans Mes tunnels #

    Lorsque vous créez un tunnel, sélectionnez ce jeton dans Jeton d'appareil. Le Démarrage rapide présente tout le déroulement.

La liste des jetons #

Vos jetons liste tous les jetons du compte dans lequel vous travaillez. Utilisez Rechercher des jetons pour filtrer par nom ou par jeton, et Actualiser pour recharger la liste. Sur un écran étroit, certaines colonnes passent derrière le bouton Détails de chaque ligne.

ColonneCe qu'elle afficheCe que vous pouvez faire
NomLe nom que vous avez donné au jeton.Sélectionnez le nom pour renommer le jeton. Les règles d'un nouveau nom s'appliquent.
StatutEn ligne signifie que l'application Localtonet est connectée. Hors ligne signifie que l'appareil est déconnecté, même si ses tunnels sont toujours configurés.
JetonLe jeton, dont la partie centrale est masquée.Sélectionnez-le pour copier le jeton complet. Le bouton QR ouvre Connecter l'appareil.
TunnelsTunnels actifs / total des tunnels liés à ce jeton. Un appareil en ligne n'a pas forcément de tunnel actif.
ClientLa dernière version de l'application signalée et son état de mise à jour.Un badge Mise à jour requise renvoie vers la page de téléchargement, afin que vous puissiez installer la dernière application Localtonet. Connectez l'appareil pour actualiser cette information.
AppareilUtilisation des threads, niveau de batterie et température de la batterie, tels que le dernier rapport de l'appareil.Pour les appareils Android : Paramètres de l'appareil Android, Paramètres SMS lorsqu'ils sont pris en charge, et Journaux d'actions de l'appareil. Le Gestionnaire de proxys offre les mêmes commandes pour toute une flotte.
ActionsHistorique IP, Paramètres du jeton, Supprimer le jeton.

Historique IP #

Historique IP ouvre la liste des adresses IP publiques enregistrées pour le jeton, chacune avec sa date. Au-dessus de la liste, vous voyez quatre compteurs : Total des répétitions, Total des IP répétées, IP répétées sur la dernière heure et Total des IP sur la dernière heure. Sélectionnez Actualiser pour les mettre à jour. C'est surtout utile pour un appareil dont l'IP change, comme un téléphone qui fait tourner son IP mobile.

Paramètres du jeton #

Paramètres du jeton ouvre un panneau avec le jeton complet, un bouton Copier le jeton, le bouton QR / PIN et deux paramètres :

ParamètreFonctionValeurs
Mode appareil USBUtilisez ce mode lorsque le jeton connecte un appareil USB. Vous gérez ses appareils depuis Mes appareils USB.Oui ou Non. La modification demande une confirmation.
Arguments du clientEnregistre des options du client avec le jeton. Sélectionnez Gérer, activez Actif et renseignez Arguments. Le client Localtonet n'applique pas les arguments enregistrés ici ; il applique les Arguments définis sur un tunnel. Pour choisir une interface réseau ou une adresse IP locale, définissez-les sur chaque tunnel.Lorsque Actif est activé, le champ ne peut pas être vide. Voir Choix du réseau.

Supprimer un jeton #

Sélectionnez Supprimer le jeton et confirmez. Le tableau de bord vous avertit d'abord :

Les tunnels de ce jeton seront arrêtés et supprimés. Un appareil qui utilise encore le jeton ne pourra plus se connecter avec lui. Créez un nouveau jeton pour cet appareil si vous en avez de nouveau besoin.

Connecter un appareil Android avec un QR code ou un PIN #

Vous n'avez pas à saisir un jeton sur un téléphone. Chaque jeton possède un QR code et un court PIN.

  1. Ouvrir Connecter l'appareil #

    Dans Mes jetons, sélectionnez le bouton QR à côté du jeton. La boîte de dialogue Connecter l'appareil s'ouvre.

  2. Scanner le code ou saisir le PIN #

    Ouvrez Localtonet pour Android. Scannez le code sous Scanner le QR code, ou saisissez le PIN à six chiffres affiché sous Saisir plutôt un PIN dans le champ de connexion de l'application, puis sélectionnez Connect.

  • Le PIN est valable une minute. La boîte de dialogue fait un compte à rebours puis affiche PIN expiré. Générez un nouveau PIN pour continuer.
  • Un PIN ne fonctionne qu'une fois. Sélectionnez Générer un nouveau PIN pour un autre appareil ou un autre essai.
  • Le QR code n'expire pas. Il contient le jeton lui-même : traitez donc une photo de celui-ci comme le jeton.
  • Vous pouvez aussi coller le jeton dans l'application. La boîte de dialogue l'affiche avec un bouton de copie.

Groupes de jetons #

Un groupe de jetons contient des jetons d'appareil. Les groupes organisent les appareils en pools : un Proxy rotatif utilise les appareils des groupes que vous sélectionnez, et un webhook de jeton est créé pour un groupe.

  1. Créer un groupe #

    Dans Mes jetons, développez Groupes de jetons, saisissez un Nom du groupe et sélectionnez Créer un groupe. Le nom peut comporter 30 caractères au maximum, ne contient pas d'espaces et doit être unique parmi vos groupes.

  2. Choisir ses jetons #

    La boîte de dialogue Gérer le groupe de jetons s'ouvre avec la liste de tous vos jetons. Cochez les jetons d'appareil qui appartiennent au groupe et sélectionnez Enregistrer les modifications.

Pour modifier un groupe plus tard, sélectionnez Gérer dans sa ligne. La boîte de dialogue est conçue pour les longues listes :

  • Recherchez par nom. Séparez plusieurs noms par des virgules.
  • Filtrez par statut d'appareil : Tous les états, En ligne ou Hors ligne.
  • Basculez entre Tous, Dans le groupe et Hors du groupe.
  • Utilisez Tout sélectionner pour cocher tous les jetons affichés, puis décochez ceux à exclure. Maj+clic sélectionne une plage.
  • Le pied de la boîte de dialogue indique ce qui va changer, par exemple +3 à ajouter. Réinitialiser annule vos modifications.

Lorsque vous retirez des jetons d'un groupe, la boîte de dialogue vous demande de confirmer, car les proxys rotatifs qui utilisent le groupe s'arrêtent sur ces appareils. Un seul enregistrement peut modifier jusqu'à 5000 jetons.

Supprimer le groupe supprime le groupe et ses appartenances. Les jetons eux-mêmes restent.

Où les jetons sont utilisés #

EndroitUtilisation du jeton
Formulaires de création de tunnelJeton d'appareil sélectionne l'appareil qui sert le tunnel. Pour déplacer un tunnel existant vers un autre appareil, utilisez Changer d'AuthToken sur le tunnel : un tunnel en cours d'exécution s'arrête, attend 2 secondes, puis redémarre avec le jeton sélectionné.
Proxy rotatifUtilise des groupes de jetons à la place d'un jeton unique. Chaque appareil connecté d'un groupe sélectionné devient une sortie du endpoint partagé.
WebhooksUn webhook de jeton est configuré pour un Groupe de jetons d'authentification.
Gestionnaire VPNLorsque vous ajoutez un appareil à un réseau, vous sélectionnez le jeton utilisé pour connecter Localtonet sur cet appareil. Chaque appareil a besoin de son propre jeton.
Terminal d'appareilLe jeton relie un ordinateur à votre compte dans Mes appareils.
Appareils USBUn jeton en Mode appareil USB connecte l'ordinateur sur lequel des modems ou des téléphones USB sont branchés.
Gestionnaire de proxysChaque téléphone Android se connecte avec son propre jeton.

Vous pouvez aussi lister, créer et supprimer des jetons et des groupes de jetons avec l'API et le serveur MCP.

Lorsqu'une équipe est sélectionnée dans le tableau de bord, Mes jetons affiche et crée les jetons de cette équipe. Voir Gestion d'équipe.

Dépannage #

Un jeton nommé … existe déjà

Les noms de jetons sont uniques. Choisissez un autre nom, ou renommez d'abord le jeton existant.

Le nom ne peut pas dépasser 30 caractères

Raccourcissez le nom du jeton ou du groupe à 30 caractères maximum.

Le jeton affiche Hors ligne

L'appareil est déconnecté. Ouvrez l'application Localtonet sur l'appareil pour vous connecter. Si un autre appareil a été démarré avec le même jeton, il a remplacé cette connexion : créez un jeton distinct pour chaque appareil.

Le client affiche Wrong Token!

La valeur n'est pas un jeton complet. Copiez de nouveau le jeton complet depuis Mes jetons : la liste masque la partie centrale, utilisez donc le bouton de copie plutôt que de sélectionner le texte visible.

PIN expiré

Le PIN est valable une minute et ne fonctionne qu'une fois. Sélectionnez Générer un nouveau PIN, ou scannez plutôt le QR code.

Impossible de charger le QR code et le PIN.

Sélectionnez Réessayer dans la boîte de dialogue. Si l'échec persiste, copiez le jeton et collez-le dans l'application.

Support