Quand un compte a un mot de passe enregistré, Asterobot peut le connecter pour vous. Il lance un vrai navigateur sur l'ordinateur où il tourne, remplit la page de connexion d'Ankama et lit le résultat, sans afficher de fenêtre par défaut. Quand Ankama ne le laisse pas passer, le journal d'Asterobot en donne la raison.
Ce qu'il faut
- Un mot de passe enregistré pour le compte. Voir Ajouter un compte. Connecter automatiquement n'apparaît que pour les comptes qui en ont un.
- Google Chrome, Chromium ou Microsoft Edge sur l'ordinateur où tourne Asterobot. Pas sur l'appareil depuis lequel vous ouvrez Asteroboard, si c'en est un autre.
Asterobot cherche d'abord Chrome ou Chromium, et n'essaie Edge que si aucun des deux ne peut être lancé :
| Système | Où Asterobot cherche |
|---|---|
| Windows | chrome dans le chemin des commandes ; Chrome dans C:\Program Files\Google\Chrome\Application ou C:\Program Files (x86)\Google\Chrome\Application ; Chrome ou Chromium dans le dossier AppData\Local de votre utilisateur ; puis Edge dans le chemin des commandes ou dans C:\Program Files (x86)\Microsoft\Edge\Application ou C:\Program Files\Microsoft\Edge\Application |
| macOS | Chromium ou Google Chrome dans /Applications, puis Microsoft Edge dans /Applications |
| Linux | chromium, chromium-browser, google-chrome, google-chrome-stable, chrome ou /snap/bin/chromium, entre autres noms, dans le chemin des commandes ; puis microsoft-edge, microsoft-edge-stable ou /opt/microsoft/msedge/msedge |
Pour un navigateur installé ailleurs, ou pour un autre navigateur basé sur Chromium comme Brave, Vivaldi ou Opera, indiquez son chemin complet dans le réglage zaapmanager.browserPath, décrit plus bas. Firefox et Safari ne peuvent pas être utilisés.
Connecter un compte
Le plus rapide est de passer par le Gestionnaire de comptes :
- Ouvrez le menu du compte, les trois points au bout de sa ligne.
- Cliquez sur Connecter automatiquement.
- Patientez. Une connexion peut prendre jusqu'à deux minutes. Quand elle réussit, Asteroboard affiche l'identifiant suivi de s'est connecté tout seul, et le badge passe à Connecté.
Vous pouvez aussi passer par la fenêtre de connexion : cliquez sur Connecter ou Reconnecter dans le même menu, puis sur Connecter automatiquement en haut de la fenêtre. Quand la connexion réussit, Asteroboard affiche l'identifiant suivi de est connecté et ferme la fenêtre. Quand elle échoue, la fenêtre reste ouverte avec Échec de la connexion automatique - connectez-vous vous-même ci-dessous et une image de la page, comme expliqué plus bas. La raison elle-même ne figure que dans le journal d'Asterobot.
Vous n'avez pas toujours besoin de cliquer. Quand un bot se connecte avec ce compte et que la connexion du compte ne fonctionne plus, Asterobot reconnecte le compte de la même manière pendant la connexion du bot. Mode Full socket décrit cette connexion, et Vérifier dans État et actions d'un compte peut aussi la déclencher.
Ce qui se passe pendant une connexion
- Si la connexion actuelle du compte fonctionne encore, Asterobot la garde et s'arrête là. Aucun navigateur n'est lancé.
- Sinon, il demande à Ankama de renouveler la connexion discrètement, toujours sans navigateur.
- Ce n'est qu'en cas de refus qu'il lance le navigateur, avec le profil propre au compte, et ouvre la page de connexion d'Ankama. Son journal, dans le terminal et dans Serveur > Console, affiche
Signing in to Ankama through a browser. - Si le profil contient encore une session Ankama valide, Ankama saute le formulaire et passe directement à sa page de confirmation.
- Sinon, le navigateur saisit l'identifiant et le mot de passe dans le formulaire d'Ankama et l'envoie.
- Sur la page de confirmation d'Ankama, Asterobot lit le lien derrière le bouton Continuer. Ce lien contient un code à usage unique, qu'Asterobot échange contre la connexion du compte.
- Asterobot vérifie aussitôt la nouvelle connexion auprès d'Ankama, puis ferme le navigateur.
Trois délais s'appliquent : 30 secondes pour que le formulaire de connexion d'Ankama apparaisse, 60 secondes après son envoi pour la page de confirmation, et deux minutes pour l'ensemble de la tentative.
Pas de fenêtre par défaut
Le navigateur tourne sans aucune fenêtre, parce que zaapmanager.browserHeadless est activé par défaut. C'est ce qui permet à la connexion automatique de fonctionner sur un ordinateur devant lequel personne n'est assis, comme un serveur. Vous pouvez activer la fenêtre quand vous avez besoin de voir ce qu'Ankama demande, comme expliqué ci-dessous.
Un profil de navigateur par compte
Chaque compte a son propre profil de navigateur, conservé d'une connexion à l'autre dans le dossier zaapmanager/browser-profiles du dossier de données d'Asterobot. Les comptes n'en partagent jamais. Comme le profil garde la session Ankama du compte, une connexion ultérieure va souvent directement à la page de confirmation sans repasser par le formulaire. Le profil est donc tout aussi sensible que le mot de passe lui-même.
Quand Ankama réclame un humain
Il arrive qu'Ankama place un contrôle ou un captcha devant son formulaire de connexion. Asterobot n'essaie pas de le franchir : il abandonne et laisse une personne prendre le relais. Vous avez deux solutions.
Connectez-vous vous-même, dans votre propre navigateur. La fenêtre de connexion le propose juste sous le bouton automatique, sous « ou connectez-vous vous-même ». Voir Connexion manuelle. Cela fonctionne toujours, où que tourne Asterobot.
Répondez au contrôle dans la fenêtre du navigateur de connexion. Cela ne fonctionne que si Asterobot tourne sur un ordinateur doté d'un écran devant lequel vous êtes assis :
- Dans Serveur > Config, désactivez
zaapmanager.browserHeadless. Le changement s'applique dès la prochaine connexion, sans redémarrer Asterobot. - Relancez la connexion automatique. Une fenêtre de navigateur s'ouvre sur l'ordinateur où tourne Asterobot.
- Répondez rapidement à ce qu'Ankama demande dans cette fenêtre : le formulaire doit apparaître dans les 30 secondes, et la page de confirmation dans les 60 secondes qui suivent l'envoi du formulaire.
- Quand le compte affiche Connecté, réactivez
zaapmanager.browserHeadless.
Quand elle échoue
Une tentative ratée affiche Échec de la connexion automatique - connectez-vous vous-même ci-dessous dans la fenêtre, ou Échec de la connexion automatique en notification quand vous l'avez lancée depuis le menu. Le message en dessous commence par ankama account authorization required, suivi de l'adresse de la page de connexion d'Ankama. Ignorez la fin de ce message, qui parle d'enregistrer un code dans la configuration : la connexion se fait dans la fenêtre, comme le montre Connexion manuelle.
Ce message est le même quelle que soit l'erreur. La vraie raison se trouve dans le journal d'Asterobot.
Trouver la raison
Dans le terminal où tourne Asterobot, ou dans Serveur > Console, cherchez l'avertissement Automatic Ankama sign-in failed, a person has to sign in. Son erreur dit ce qui s'est passé, et la plupart du temps elle se termine par le titre et l'adresse de la page sur laquelle se trouvait le navigateur :
| L'erreur contient | Ce qui s'est passé | Que faire |
|---|---|---|
failed to start a browser (is Chrome, Chromium or Edge installed?) |
Asterobot n'a trouvé aucun navigateur qu'il puisse lancer. | Installez Chrome, Chromium ou Edge sur l'ordinateur où tourne Asterobot, ou renseignez zaapmanager.browserPath. |
ankama's sign-in page is asking for a human (bot challenge or captcha) |
Le formulaire de connexion d'Ankama n'est pas apparu dans les 30 secondes, ou la page n'était pas le formulaire qu'attend Asterobot. C'est à cela que ressemble un contrôle du point de vue d'Asterobot. | Voir Quand Ankama réclame un humain. |
the request was refused by Ankama's edge network before Ankama saw it |
Le navigateur a reçu une page de blocage du réseau placé devant Ankama. Le compte lui-même n'a pas été vérifié. | Réessayez plus tard, ou connectez-vous manuellement. |
ankama did not accept the sign-in (wrong password, a verification step, or a challenge raised after submitting) |
Le formulaire a été envoyé, mais la page de confirmation d'Ankama n'est pas arrivée dans les 60 secondes. | Vérifiez le mot de passe et enregistrez-le à nouveau si besoin. Si Ankama demande une étape de vérification pour ce compte, celui-ci ne peut pas se connecter automatiquement : voir Shield et authentification à deux facteurs. |
failed to open ankama's sign-in page, failed to fill ankama's sign-in form ou failed to submit ankama's sign-in form |
Le navigateur n'a pas pu charger la page d'Ankama, ou n'a pas pu remplir ou envoyer son formulaire. | Vérifiez la connexion internet de l'ordinateur où tourne Asterobot, puis connectez-vous manuellement. |
browser signed in but the Continue link carried no code |
La connexion a abouti, mais le lien derrière Continuer ne contenait aucun code. | Connectez-vous manuellement. |
Problèmes de connexion aux comptes passe ces erreurs en revue une par une.
La capture d'écran
Quand le navigateur est allé jusqu'à afficher une page, Asterobot en prend une image au moment où il abandonne. Juste après un échec lancé depuis le bouton Connecter automatiquement de la fenêtre elle-même, la fenêtre affiche cette image sous l'alerte, avec la légende « Ce que le navigateur avait sous les yeux en abandonnant - cliquez pour l'ouvrir en grand ». Cliquez dessus pour la voir en taille réelle. C'est souvent le moyen le plus rapide de distinguer un captcha d'un mauvais mot de passe.
Asterobot garde une image par compte, dans le dossier zaapmanager de son dossier de cache, et la remplace au prochain échec. Le terminal affiche Captured what the browser saw when the Ankama sign-in failed avec le chemin du fichier. Quand le navigateur n'a pas pu démarrer du tout, il n'y a pas d'image.
Réglages de la connexion automatique
Ces trois réglages se trouvent dans Serveur > Config. Aucun ne nécessite de redémarrage : chaque connexion les relit.
| Réglage | Par défaut | Ce qu'il change |
|---|---|---|
zaapmanager.browserHeadless |
Activé | Lance le navigateur de connexion sans fenêtre. Désactivez-le pour suivre la connexion et répondre à un contrôle à la main. |
zaapmanager.browserPath |
Vide | Chemin complet du navigateur à utiliser. Vide, Asterobot cherche Chrome, Chromium, puis Edge. Quand vous le renseignez, Asterobot utilise uniquement ce navigateur et n'en cherche pas d'autre s'il ne démarre pas. |
zaapmanager.browserUserAgent |
Vide | La façon dont le navigateur de connexion s'identifie auprès des pages qu'il ouvre. Vide, il se présente comme Chrome sous Windows 11, avec le numéro de version majeure du navigateur réellement installé. Ce que vous saisissez remplace cette identité. |
Référence des réglages liste tous les réglages, et La page Config montre comment en modifier un.
Pour aller plus loin
- Connexion manuelle, quand la connexion automatique n'est pas possible.
- État et actions d'un compte, pour vérifier qu'un compte connecté fonctionne toujours.
- Problèmes de connexion aux comptes, pour le détail de chaque erreur.