Référence de la CLI

Un seul binaire, addtothese, suffit : se connecter, ouvrir des tunnels et rediriger des ports TCP. Votre connexion est stockée dans ~/.addtothese/config.yaml (%USERPROFILE%\.addtothese\config.yaml sous Windows).

addtothese login

addtothese login --token att_...

Enregistre un jeton API. Sans --token, la commande le demande sur l'entrée standard. addtothese logout l'oublie.

addtothese http

addtothese http <port|host:port|url> [--subdomain name]

Expose un service HTTP local. Sans --subdomain, vous obtenez un endpoint aléatoire. Avec, le tunnel utilise un nom que vous avez réservé dans le tableau de bord. La CLI se reconnecte toute seule après une coupure réseau et renouvelle ses identifiants avant leur expiration.

OptionPar défautSignification
--subdomainaléatoireNom réservé à utiliser
--timeout10sDélai d'attente pour transmettre chaque requête à votre service
--access-logtrueAffiche chaque requête relayée
--log-levelwarndebug, info, warn ou error

Protégez une URL avec des codes e-mail

addtothese http 4321 --allowed-email ana@gmail.com --allowed-email '*@company.com'

Seules les personnes de votre liste peuvent ouvrir l'URL. Le visiteur saisit son e-mail ; s'il figure dans la liste, il reçoit un code à 6 chiffres valable 10 minutes et reste connecté 24 heures. *@company.com autorise tout un domaine. Répétez le flag pour chaque adresse ou domaine.

Votre service reçoit l'adresse vérifiée dans l'en-tête X-AddToThese-Email. Chaque exécution remplace la liste : lancer la commande sans --allowed-email rend donc l'URL de nouveau publique. Vous pouvez aussi modifier la liste sur la page de l'endpoint dans le tableau de bord.

addtothese tcp

addtothese tcp 5432 --subdomain mydb

Expose un port TCP brut, comme Postgres, SSH ou RDP. Les personnes qui doivent y accéder lancent le redirecteur de leur côté, qui ouvre un port local connecté à votre service :

addtothese forward tcp 5432 mydb --connect.url https://mydb.addtothese.com

Elles peuvent ensuite se connecter à localhost:5432 comme si la base de données était sur leur machine.

Variables d'environnement

VariableSignification
ADDTOTHESE_TOKENJeton API, prioritaire sur celui enregistré
ADDTOTHESE_CONFIGChemin vers un autre fichier de configuration