Ajouter un compte

Un bot en mode Full socket se connecte à Ankama tout seul : il lui faut donc un compte Ankama enregistré dans Asterobot. Vous l'ajoutez dans le Gestionnaire de comptes, avec ou sans son mot de passe. Si vos bots n'utilisent que le mode MITM, pour « homme du milieu » (man-in-the-middle), où un bot relaie le jeu auquel vous jouez vous-même, rien de tout cela ne vous concerne : ces bots n'utilisent jamais de compte enregistré.

Ouvrir le Gestionnaire de comptes

Dans la barre latérale, cliquez sur Gestionnaire de comptes. La page liste vos comptes enregistrés, un par ligne :

Tapez dans Filtrer... pour retrouver un compte dans une longue liste. Avant tout ajout, le tableau indique « Aucun compte enregistré pour le moment. »

Ajouter le compte

1. Cliquez sur Ajouter un compte. La fenêtre Ajouter un compte de bot s'ouvre.
2. Dans Identifiant, tapez l'identifiant que vous utilisez sur la page de connexion d'Ankama. Les espaces autour sont retirés.
3. Remplissez Mot de passe Ankama (facultatif) uniquement si vous voulez qu'Asterobot connecte ce compte tout seul. La section suivante explique la différence.
4. Cliquez sur Ajouter. Le bouton reste grisé tant que le champ Identifiant est vide.

Le compte apparaît dans le tableau comme Non connecté. L'ajout ne contacte pas du tout Ankama : un identifiant ou un mot de passe erroné n'est donc pas détecté à ce stade. Connectez ensuite le compte, avec la Connexion automatique si vous avez enregistré un mot de passe, ou avec la Connexion manuelle sinon.

Si Asteroboard affiche Impossible d'ajouter le compte, la raison habituelle est qu'un compte avec le même identifiant est déjà enregistré. Un identifiant ne peut être enregistré qu'une seule fois.

Vous n'avez pas besoin de quitter la fenêtre Ajouter un bot pour cela. Le bouton à côté de son champ Compte ouvre la même fenêtre, puis la fenêtre de connexion, et sélectionne le nouveau compte pour le bot. Voir Ajouter un bot.

Avec ou sans mot de passe

Le mot de passe est à lui seul l'interrupteur de la connexion automatique. Il n'existe aucun autre réglage pour l'activer.

Avec un mot de passe, le compte reçoit le badge Se connecte tout seul. Vous pouvez le connecter en un clic, et quand un bot a plus tard besoin du compte alors que sa connexion ne fonctionne plus, Asterobot le reconnecte tout seul, grâce à un navigateur qu'il pilote. Asterobot tente toujours d'abord un renouvellement discret auprès d'Ankama et n'ouvre ce navigateur que si le renouvellement est refusé.

Sans mot de passe, le compte fonctionne exactement de la même façon tant que sa connexion est valide. La différence apparaît quand cette connexion cesse de fonctionner et ne peut pas être renouvelée discrètement : quelqu'un doit alors reconnecter le compte, et un bot qui tente de se connecter avant cela échoue.

Vous pouvez enregistrer un mot de passe plus tard, ou le remplacer, depuis la fenêtre de connexion. Voir Connexion manuelle. En revanche, Asteroboard ne permet pas d'effacer un mot de passe enregistré : pour désactiver à nouveau la connexion automatique, supprimez le compte et ajoutez-le de nouveau sans mot de passe.

Ce qu'Asterobot garde, et où

Asterobot enregistre vos comptes dans un fichier nommé accounts.toml, dans son dossier de données. Fichiers et dossiers indique où se trouve ce dossier sur chaque système. Pour chaque compte, le fichier contient :

• l'identifiant ;
• le mot de passe, si vous en avez enregistré un ;
• la connexion qu'Ankama a donnée à Asterobot : un jeton d'accès et un jeton de rafraîchissement, avec leur date d'émission et leur date d'expiration.

Le mot de passe n'est pas chiffré. Il est écrit en clair dans le fichier, parce qu'Asterobot doit le saisir sur la page de connexion d'Ankama. Sous Linux et macOS, Asterobot restreint le fichier pour que seul votre compte utilisateur puisse le lire ou le modifier, et réapplique cette restriction à chaque démarrage. Sous Windows, cette restriction n'a aucun effet. Dans tous les cas, toute personne qui peut ouvrir des fichiers avec votre compte utilisateur, ou qui obtient une copie du fichier, peut lire le mot de passe et utiliser les jetons.

Les comptes qui se connectent automatiquement laissent deux autres choses derrière eux :

• Un profil de navigateur par compte, dans le dossier zaapmanager/browser-profiles du dossier de données d'Asterobot. Il contient la session Ankama du compte dans le navigateur de connexion, ce qui permet à une connexion ultérieure de passer le formulaire d'Ankama. Sous Linux et macOS, seul votre utilisateur peut l'ouvrir. Traitez-le comme le mot de passe.
• Une capture d'écran de la dernière connexion automatique échouée, dans le dossier zaapmanager du dossier de cache d'Asterobot. Il y en a une par compte, remplacée à chaque nouvel échec. Connexion automatique explique à quoi elle sert.

Asterobot ne renvoie jamais le mot de passe à Asteroboard : tout ce qu'il indique à Asteroboard sur un compte, c'est si un mot de passe est enregistré et si le compte est connecté.

Un bot par compte

Un compte Ankama ne peut appartenir qu'à un seul bot. Dofus autorise une session de jeu par compte, et Asterobot applique la même règle : ajouter un second bot avec un compte qui en a déjà un échoue avec Impossible d'ajouter le bot, et choisir ce compte sur l'onglet Réglages d'un bot est refusé avec this account is already associated with a bot. Pour faire tourner plusieurs bots en mode Full socket, enregistrez un compte pour chacun. Voir Plusieurs bots.

Les comptes et le mode MITM

Un bot en mode MITM n'utilise jamais de compte enregistré, même s'il en a un : vous vous connectez vous-même, dans Dofus, et le bot relaie cette session. C'est pourquoi les comptes protégés par Ankama Shield ou par l'authentification à deux facteurs restent utilisables en mode MITM. Voir Shield et authentification à deux facteurs.

Pour aller plus loin

• Connexion automatique, si vous avez enregistré un mot de passe.
• Connexion manuelle, pour connecter le compte vous-même.
• Ajouter un bot, une fois que le compte affiche Connecté.