Enregistrez des proxys SOCKS5 et HTTP dans Asterobot, attribuez-en un à un compte Ankama ou à un bot, et choisissez l'adresse depuis laquelle Ankama voit arriver chacun d'eux.
Un proxy fait partir des connexions d'une autre adresse que la vôtre. Asterobot en tient la liste sur la page Gestionnaire de proxys, et vous en attribuez un à un compte Ankama, à un bot, ou aux deux. À partir de ces deux choix, Asterobot détermine par quel proxy passe chaque connexion.
Deux sortes de proxy fonctionnent : SOCKS5 et HTTP. Les proxys SOCKS4 ne fonctionnent pas.
La raison la plus courante d'en vouloir un est un serveur loué. Quand Asterobot tourne sur un VPS dans un datacenter, la page de connexion d'Ankama le bloque ou lui pose souvent un défi, parce que les adresses de datacenter sont fréquemment signalées par la protection placée devant cette page. Un proxy sur le compte fait partir la connexion, et tout ce qu'Asterobot demande d'autre à Ankama pour ce compte, de l'adresse du proxy.
Comptes et bots
Un compte Ankama et un bot ont chacun un réglage Proxy, et ils ne couvrent pas les mêmes connexions :
- Le proxy d'un compte transporte tout ce qu'Asterobot demande à Ankama pour ce compte sur le web : la connexion automatique dans le navigateur qu'Asterobot pilote, l'échange du code qui termine toute connexion, le renouvellement des jetons, Vérifier, et le jeton de connexion au jeu dont un bot a besoin à chaque connexion.
- Le proxy d'un bot transporte les connexions du bot lui-même vers les serveurs de Dofus : le serveur de connexion et le serveur de jeu.
Par défaut, un bot utilise le proxy de son compte : un seul proxy réglé sur un compte couvre donc tout ce qui se fait avec lui, de la connexion jusqu'au jeu. Vous pouvez quand même imposer à un bot un autre proxy, ou une connexion directe.
| Choix du Proxy d'un bot | Les connexions du bot passent par |
|---|---|
| Comme le compte (...) | Le proxy du compte, nommé entre parenthèses. Quand le compte n'en a pas, les parenthèses indiquent « directe » et le bot se connecte directement ; un bot sans compte se connecte directement lui aussi. C'est le choix par défaut. |
| Toujours en connexion directe | Aucun proxy, quel que soit celui du compte. |
| Le nom d'un proxy | Ce proxy, quel que soit celui du compte. |
Un compte a Aucun proxy (connexion directe), par défaut, ou le nom d'un proxy.
Ce qui passe par quel proxy
| Connexion | Quand elle a lieu | Passe par |
|---|---|---|
| La page de connexion d'Ankama, dans le navigateur qu'Asterobot pilote | Une connexion automatique | Le proxy du compte |
| L'échange du code après une connexion | Toute connexion, automatique ou manuelle | Le proxy du compte |
| Le renouvellement des jetons, Vérifier, Forcer le rafraîchissement du jeton et Déconnecter | Quand un bot en mode Full socket se connecte, et quand vous cliquez dessus | Le proxy du compte |
| Le jeton de connexion au jeu | À chaque connexion d'un bot en mode Full socket | Le proxy du compte |
| Le serveur de connexion | Un bot en mode Full socket qui se connecte | Le choix du bot |
| Le serveur de jeu | Un bot en mode Full socket, ou un bot en mode MITM qui relaie une session | Le choix du bot |
| Le serveur de connexion d'une session relayée | Un bot en mode MITM qui relaie une session | Directe |
| Le fichier de configuration du jeu et les téléchargements du jeu | Un bot qui se connecte, une version du jeu qui se télécharge | Directe |
Un bot en mode MITM, pour « homme du milieu » (man-in-the-middle), c'est-à-dire un bot qui relaie la session d'un client Dofus que vous jouez, n'envoie que la connexion au serveur de jeu par son proxy. La partie connexion d'une session relayée passe par deux ports que tous les bots en attente partagent, et Asterobot les ouvre avant que quoi que ce soit dans le trafic ne dise à quel bot appartient la session : à cet instant, il n'y a aucun bot dont lire le proxy. Votre propre launcher Dofus se connecte depuis votre ordinateur, comme toujours : le proxy d'un compte ne couvre que ce qu'Asterobot envoie lui-même.
Quand vous connectez un compte à la main, vous ouvrez la page d'Ankama dans votre propre navigateur : cette visite part donc de là où se trouve votre navigateur. Seul l'échange du code qui suit passe par le proxy du compte. Connexion manuelle décrit ce parcours.
Important
Avec les réglages par défaut, un bot en mode Full socket et son compte partent de la même adresse. Imposez au bot un autre proxy, ou Toujours en connexion directe, et Ankama voit le jeton de connexion au jeu du bot demandé depuis une adresse et ses connexions de jeu arriver d'une autre. Vérifiez que cela vous convient avant de le mettre en place.
Deux sortes de proxy
| Type | Ce que c'est | Identifiants |
|---|---|---|
| SOCKS5 | Un serveur SOCKS5, qui écoute souvent sur le port 1080. | Un identifiant et un mot de passe, avec l'authentification propre à SOCKS5. |
| HTTP | Un proxy HTTP qui ouvre des tunnels avec CONNECT. Les fournisseurs les vendent souvent comme « proxys HTTP/HTTPS ». |
Un identifiant et un mot de passe, envoyés en authentification Basic. |
Les deux transportent tout ce dont Asterobot a besoin, pour les comptes comme pour les bots, à une réserve près côté HTTP : certains proxys HTTP n'ouvrent de tunnels que vers le port 443, celui du HTTPS. Cela suffit pour un compte, dont les requêtes vers Ankama sont toutes en HTTPS. Cela ne suffit pas pour un bot, parce que les serveurs de Dofus écoutent sur d'autres ports. Tester ne peut pas non plus le révéler, puisqu'un test est lui aussi une requête HTTPS. Un bot qui échoue avec the HTTP proxy refused to open a tunnel suivi de 403 ou 405, alors que Tester fonctionne, a buté sur cette limite : demandez à votre fournisseur si d'autres ports sont autorisés, ou donnez au bot un proxy SOCKS5.
Quel que soit le type, l'identifiant et le mot de passe du proxy voyagent sans chiffrement d'Asterobot jusqu'au proxy, comme ces deux protocoles le prévoient. Ce qui passe dans le tunnel n'en est pas modifié : les pages d'Ankama restent en HTTPS de bout en bout.
Enregistrer un proxy
- Ouvrez le Gestionnaire de proxys dans la barre latérale. Une liste vide affiche « Aucun proxy enregistré. »
- Cliquez sur Ajouter un proxy.
- Remplissez les champs ci-dessous, puis cliquez sur Ajouter.
| Champ | Obligatoire | Ce qu'il faut y mettre |
|---|---|---|
| Nom | Non | Ce qui vous permettra de reconnaître ce proxy au moment de le choisir sur un compte ou un bot. Minuscules, chiffres et tirets, en commençant et en finissant par une lettre ou un chiffre. Laissez-le vide et Asterobot en génère un ; le bouton en forme de dé à côté du champ en remplit un pour que vous puissiez le voir et le modifier avant. Il ne pourra plus être modifié ensuite, et il ne peut pas valoir direct, le mot qu'utilise un bot pour se connecter directement. |
| Type | Oui | SOCKS5 ou HTTP, comme votre fournisseur le nomme. Il démarre sur SOCKS5. |
| Adresse | Oui | L'hôte et le port ensemble, tels que votre fournisseur les donne : proxy.exemple.com:1080. Une adresse IPv6 se met entre crochets, [2001:db8::1]:1080. Le port doit être compris entre 1 et 65535. |
| Identifiant | Non | L'identifiant que demande le proxy. Laissez-le vide, ainsi que Mot de passe, pour un proxy qui n'exige aucune authentification. |
| Mot de passe | Non | Le mot de passe qui va avec l'identifiant. Il n'est plus jamais affiché une fois enregistré. |
Rien n'est contacté pendant que vous tapez, et rien ne l'est quand vous cliquez sur Ajouter. Un proxy hors service, ou dont le mot de passe est faux, est enregistré exactement comme un proxy qui marche. C'est Tester, dans la même fenêtre, qui fait la différence, et l'enregistrement n'y est volontairement pas conditionné : un proxy injoignable sur le moment est souvent celui que vous êtes en train de réparer.
Le nom est l'identité définitive du proxy. Les comptes et les bots le désignent par ce nom, un renommage les casserait donc : pour en changer, ajoutez un second proxy et redirigez-les vers celui-là.
Lire la liste
| Colonne | Ce qu'elle affiche |
|---|---|
| Nom | Le nom que vous lui avez donné. Cliquez sur l'en-tête pour trier. |
| Adresse | L'hôte et le port, avec SOCKS5 ou HTTP en dessous. |
| Authentification | Avec identifiants quand un identifiant ou un mot de passe est enregistré, Sans identifiants sinon. Quand il y a un identifiant, il est affiché à côté du badge. |
| Utilisé par | Les comptes réglés sur ce proxy, chacun avec une icône de personne, puis les bots réglés sur lui par son nom, chacun étant un lien vers les Réglages de ce bot. Un bot qui suit son compte n'est pas listé une seconde fois : l'entrée du compte le couvre. Inutilisé quand personne ne l'utilise. |
| Dernier test | Ce qu'a trouvé le dernier test de ce proxy, tant que la page reste ouverte. Un tiret tant que vous n'avez rien demandé. |
Le champ au-dessus du tableau filtre sur le nom et sur l'hôte : vous pouvez chercher par l'un ou par l'autre.
Tester un proxy
Un test envoie une vraie requête HTTPS à travers le proxy et rapporte l'adresse depuis laquelle l'autre bout l'a vue arriver. C'est cette adresse la réponse : c'est celle d'où semble venir tout ce qui passe par ce proxy, et la comparer à la vôtre est ce qui vous dit que le proxy transporte vraiment le trafic, au lieu de se contenter d'accepter une connexion.
Il y a trois façons de le lancer, et c'est le même test :
- Tester dans la fenêtre Ajouter un proxy, avant que le proxy ne soit enregistré. De quoi essayer des informations que vous venez de coller.
- Tester dans le menu du proxy au bout de sa ligne, pour un proxy enregistré.
- Tout tester, à côté du champ de filtre, pour tous les proxys enregistrés d'un coup. Ils partent ensemble et non les uns après les autres : dix proxys prennent à peu près le temps d'un seul.
Les résultats s'affichent dans la colonne Dernier test : l'adresse de sortie et la durée de l'aller-retour en cas de réussite, Échec avec la raison en infobulle sinon. En cas d'échec, vous recevez la raison telle qu'Asterobot l'a obtenue : connexion refusée, mot de passe rejeté (username/password authentication failed pour SOCKS5, the HTTP proxy refused to open a tunnel: 407 Proxy Authentication Required pour HTTP) ou hôte introuvable. Asterobot abandonne au bout de 15 secondes.
Rien n'est retenu. Les résultats ne vivent que tant que la page reste ouverte, et aucun badge ne survit à un rechargement, parce qu'un proxy qui répondait il y a une minute n'est pas un proxy qui répond maintenant.
Note
Tester depuis la fenêtre pendant la modification d'un proxy existant n'utilise pas le mot de passe enregistré : Asterobot ne renvoie jamais un mot de passe au navigateur. La fenêtre le signale sous le résultat. Ressaisissez-le si vous voulez que le test le prenne en compte.
Ce que contacte le test
L'adresse vient d'un service extérieur à Asterobot, défini dans proxymanager.ipCheckUrl sur Serveur > Config. Il vaut au départ https://api.ipify.org?format=json, qui répond votre adresse et rien d'autre.
Seuls les tests s'en servent, uniquement quand vous en demandez un, et la requête ne transporte rien sur vous au-delà de l'adresse du proxy lui-même. Tester indique tout de même à qui exploite ce service que ce proxy existe et fonctionne : pointez le réglage vers le vôtre si vous préférez ne pas le dire. Asterobot lit un champ ip dans une réponse JSON, ou la réponse entière quand elle tient sur une ligne, ce qui couvre la plupart de ces services sans rien changer.
Attribuer un proxy à un compte
Quand vous ajoutez un compte dans le Gestionnaire de comptes, la fenêtre Ajouter un compte de bot comporte un champ Proxy sous le mot de passe. Il démarre sur Aucun proxy (connexion directe). Choisissez plutôt un proxy enregistré, ou utilisez le bouton + pour en enregistrer un sans quitter la fenêtre.
Pour un compte déjà enregistré, ouvrez son menu au bout de sa ligne et cliquez sur Choisir le proxy. La fenêtre Proxy de ... affiche le même champ : choisissez un proxy, ou Aucun proxy (connexion directe), puis cliquez sur Enregistrer. La colonne Proxy du Gestionnaire de comptes affiche le proxy de chaque compte, ou « directe ».
Le changement s'applique à partir de la prochaine requête qu'Asterobot fait pour ce compte. Un bot déjà en jeu n'est pas dérangé, et les bots qui suivent le compte utilisent le nouveau proxy à partir de leur prochaine connexion.
Plusieurs comptes peuvent partager un même proxy, et Asterobot ne limite pas leur nombre. C'est ainsi qu'une équipe de comptes semble se connecter depuis un même réseau.
Attribuer un proxy à un bot
Quand vous ajoutez un bot, l'onglet Connexion comporte un champ Proxy, entre Choix du serveur et l'identifiant de machine. Il démarre sur Comme le compte (...), avec le proxy du compte entre parenthèses dès que vous avez choisi un compte. Laissez-le ainsi pour suivre le compte, ou choisissez Toujours en connexion directe ou un proxy enregistré. Le bouton + enregistre un nouveau proxy sans quitter le formulaire.
Un bot existant dispose du même champ sur sa propre page, dans ses Réglages, à la section Connexion. Le modifier ne demande aucune déconnexion : Asterobot lit le proxy au moment d'ouvrir une connexion, le changement s'applique donc à la prochaine connexion du bot et laisse tranquille une session en cours. Cliquez sur Enregistrer comme d'habitude.
La colonne Proxy du Gestionnaire de bots affiche ce par quoi passe réellement chaque bot : le nom d'un proxy, le proxy du compte suivi de « (compte) » quand le bot suit son compte, ou « directe ».
Quelle que soit la façon de le régler, choisir un proxy affiche sous le champ un rappel de ce que ce proxy transporte.
La connexion automatique à travers un proxy
Quand un compte a un proxy, le navigateur qu'Asterobot pilote pour une connexion automatique passe lui aussi par ce proxy. Asterobot ne confie pas directement le proxy au navigateur : Chrome ne sait pas utiliser un proxy SOCKS5 qui a un mot de passe, et demande celui d'un proxy HTTP dans une fenêtre que personne n'est là pour remplir. À la place, Asterobot démarre le navigateur en le pointant vers un petit relais à lui, sur 127.0.0.1, qui envoie chaque connexion par le proxy du compte et se ferme avec le navigateur. Tout proxy qui fonctionne pour un bot fonctionne ainsi pour le navigateur, avec ou sans identifiants, et le mot de passe du proxy n'atteint jamais le navigateur.
La résolution des adresses passe aussi par le proxy, et Asterobot démarre le navigateur avec WebRTC limité aux connexions que transporte le proxy : une page ne peut pas apprendre votre propre adresse en contournant le proxy.
Si le proxy est hors service, le navigateur ne peut pas charger la page d'Ankama et la connexion échoue avec failed to open ankama's sign-in page. Testez d'abord le proxy quand vous voyez ce message sur un compte qui en a un.
Installations courantes
| Ce que vous voulez | Compte | Ses bots |
|---|---|---|
| Faire tourner Asterobot sur un VPS dont l'adresse est refusée par la connexion d'Ankama | Un proxy résidentiel | Comme le compte |
| Plusieurs comptes qui semblent se connecter depuis un même endroit | Le même proxy sur chacun | Comme le compte |
| Garder les requêtes web du compte sur un proxy cher et jouer par un proxy moins cher | Le proxy cher | Le proxy moins cher, par son nom |
| Essayer un nouveau proxy sur un bot sans toucher aux autres | Inchangé | Le nouveau proxy, sur ce bot seulement |
| Utiliser un fournisseur qui ne vend que des proxys HTTP | Le proxy HTTP | Comme le compte, si le fournisseur autorise les tunnels vers les ports du jeu |
La troisième installation économise de la bande passante, parce que les requêtes web d'un compte pèsent quelques kilo-octets par connexion alors qu'une session de jeu dure des heures. C'est aussi celle que vise l'avertissement de Ce qui passe par quel proxy : Ankama voit deux adresses pour un même bot.
Modifier ou supprimer un proxy
Modifier, dans le menu du proxy, rouvre la même fenêtre pour tout sauf le nom, type compris. Le champ du mot de passe est vide parce qu'Asterobot ne renvoie jamais un mot de passe enregistré : laissez-le vide pour conserver celui que vous aviez saisi, tapez-en un nouveau pour le remplacer, ou cochez Supprimer le mot de passe enregistré pour l'enlever complètement. Comme tout autre changement, une nouvelle adresse atteint un compte à sa prochaine requête et un bot à sa prochaine connexion.
Supprimer efface le proxy, et refuse tant qu'un compte ou un bot le désigne :
proxy "fr-datacenter-1" is still used by bots harvester-one, harvester-two and accounts my-loginRedirigez d'abord ces comptes et ces bots, puis supprimez-le. Ce refus est voulu : un compte ou un bot dont le proxy a disparu pourrait sinon continuer depuis votre propre adresse, ce qu'un proxy sert précisément à éviter.
Quand un proxy a disparu
Supprimer un proxy utilisé est refusé, ce cas se produit donc surtout si proxies.toml est modifié à la main ou restauré depuis une ancienne copie. Le compte ou le bot conserve le nom qu'on lui a donné, et Asterobot refuse de se connecter plutôt que de se connecter silencieusement en direct. Pour un bot :
bot "harvester-one" connects through proxy "fr-datacenter-1": proxy not found: "fr-datacenter-1"Pour un compte, quand vous le connectez, le vérifiez ou connectez l'un de ses bots :
account "my-login" connects through a proxy that cannot be used: proxy not found: "fr-datacenter-1"La page Réglages du bot, ou la fenêtre Choisir le proxy du compte, affiche le nom manquant dans le champ Proxy, signalé comme n'étant plus enregistré, avec un avertissement en dessous. Faites un autre choix, puis enregistrez.
Où sont enregistrés les proxys
Les proxys vivent dans proxies.toml, dans le dossier de données applicatives d'Asterobot, à côté de bots.toml et accounts.toml. Le proxy de chaque compte est enregistré par son nom dans accounts.toml, et le choix de chaque bot dans bots.toml.
Le mot de passe de chaque proxy se trouve en clair dans proxies.toml. C'est nécessaire : les proxys SOCKS5 comme HTTP le demandent à chaque connexion, Asterobot a donc besoin du mot de passe lui-même et non d'une version brouillée. Sous Linux et macOS, le fichier n'est lisible que par votre propre utilisateur, et Asterobot réapplique cette restriction à chaque démarrage et à chaque enregistrement. Aucun point d'entrée ne redonne un mot de passe enregistré, et c'est pourquoi la fenêtre ne peut pas le pré-remplir.
Asterobot lit ces fichiers au démarrage et les réécrit à chaque modification : ne les modifiez donc qu'Asterobot arrêté.
Limites
- Proxys SOCKS5 et HTTP uniquement. SOCKS4 n'est pas pris en charge.
- Un proxy HTTP qui n'ouvre de tunnels que vers le port 443 peut transporter les requêtes d'un compte, mais pas les connexions de jeu d'un bot.
- Un proxy par compte et un par bot. Asterobot ne fait pas tourner les proxys, n'en choisit pas automatiquement et ne bascule pas sur un second quand le premier échoue.
- En mode MITM, le serveur de connexion d'une session relayée reste en direct, et votre propre launcher se connecte depuis votre ordinateur.
- Les téléchargements du jeu et son fichier de configuration ne passent jamais par un proxy.
Où aller ensuite
- Ajouter un compte et État et actions d'un compte couvrent le reste du Gestionnaire de comptes.
- Mode Full socket explique comment connecter un bot qui se connecte tout seul.
- Mode MITM explique le relais de la partie que vous jouez.
- Réglages d'un bot passe en revue tous les champs modifiables ensuite.
- Sécurité traite de qui peut atteindre votre Asterobot et de ce qu'il peut en faire.