Asterobot doit être connecté à votre compte asterobot.net avant que vous puissiez ajouter un bot, et c'est aussi avec ce compte qu'il installe les paquets du marché. Vous ne saisissez jamais votre mot de passe dans Asterobot pour cela : Asterobot obtient un code de connexion, et vous confirmez ce code sur asterobot.net dans votre navigateur. Quand un code expire, Asterobot en demande un nouveau tout seul.
Quand Asterobot vous demande de vous connecter
Asterobot lance une connexion de lui-même dès qu'il n'en a aucune d'enregistrée, ce qui est le cas lors de son premier lancement. Il en lance aussi une quand asterobot.net cesse d'accepter la connexion qu'il avait, et quand vous cliquez sur Se connecter dans Asteroboard après vous être déconnecté.
À chaque fois, vous trouvez le lien de connexion à trois endroits :
- Le terminal, sur la ligne qui suit
Website sign-in required. Please visit this link to authorize access to your account; the app will continue automatically once authorized. - Un onglet du navigateur qu'Asterobot ouvre tout seul, sur l'ordinateur où il tourne. Il ne le fait que pour le premier code : si ce code expire, les suivants n'ouvrent pas d'onglet.
- Le bouton de compte d'Asteroboard, en bas de la barre latérale, qui affiche désormais Connexion en attente.
Confirmer le code
- Ouvrez le lien : cliquez sur le bouton de compte dans Asteroboard, ou passez à l'onglet ouvert par Asterobot.
- Si asterobot.net vous demande de vous connecter, connectez-vous avec votre compte asterobot.net. Si vous n'en avez pas encore, vous pouvez le créer maintenant.
- Autorisez Asterobot à accéder à votre compte.
- Fermez l'onglet. En quelques secondes, le terminal affiche
Website sign-in completed, Asteroboard affiche Bonjour suivi de votre nom, et le bouton de compte affiche votre avatar et votre nom asterobot.net.
Asterobot reste ensuite connecté, même quand vous le redémarrez.
Le code
Le code compte huit caractères, des chiffres et des lettres de A à F, et le lien le contient déjà, après code=. Ouvrir le lien le remplit pour vous.
Si vous ouvrez l'adresse sans le code à la fin, par exemple parce que vous avez tapé le lien à la main sur un autre appareil, asterobot.net affiche à la place une page Connect a device. Tapez les huit caractères dans le champ Device code et confirmez. Les espaces, les tirets et les minuscules n'ont pas d'importance.
Un code est valable 15 minutes. Si vous ne le confirmez pas à temps, le terminal affiche Sign-in was not completed in time; it will be offered again, et Asterobot demande tout seul un nouveau code dans les minutes qui suivent. Le bouton de compte ouvre alors le nouveau lien. Pour obtenir un nouveau code tout de suite, rechargez Asteroboard : si le bouton de compte affiche Se connecter, cliquez dessus.
Messages sur asterobot.net
| Message | Ce qui s'est passé | Que faire |
|---|---|---|
| « This code is invalid or has expired. Check the code displayed on your device and try again. » | Le code a été mal saisi, a déjà servi ou date de plus de 15 minutes. | Vérifiez le code, ou ouvrez le lien le plus récent qu'Asterobot vous a donné. |
| « Too many incorrect codes have been entered. Wait a few minutes and try again. » | 20 codes erronés ont été saisis depuis votre connexion en moins de 15 minutes. | Patientez. Vous pourrez de nouveau saisir des codes au plus tard 15 minutes après le dernier code erroné. |
| « The authorization was denied. You can close this page; your device will stop waiting shortly. » | Vous avez refusé l'accès à Asterobot. | Rien, si c'était voulu. Asterobot cesse d'attendre et redemande plus tard. |
| « This authorization link is invalid or has expired. Start again from your device. » | La page a été ouverte depuis un lien périmé ou abîmé. | Ouvrez le lien le plus récent qu'Asterobot vous a donné. |
| « This authorization session has expired. Start again from your device. » | Le code a expiré pendant que vous vous connectiez. | Ouvrez le lien le plus récent qu'Asterobot vous a donné. |
| « The authorization could not be completed. Start again from your device. » | asterobot.net n'a pas pu terminer la connexion. | Ouvrez le lien le plus récent qu'Asterobot vous a donné, ou rechargez Asteroboard et cliquez sur Se connecter. |
Se connecter depuis un téléphone
Quand Asterobot tourne sur une machine où vous ne pouvez pas ouvrir de navigateur, comme un serveur, il peut afficher le lien sous forme de QR code dans son terminal :
- Dans Asteroboard, ouvrez Serveur > Config et activez
website.showQRCode. - Attendez le code suivant. Le QR code apparaît dans le terminal au-dessus de la ligne
Alternatively, scan the QR code above to open the link directly. - Scannez-le avec votre téléphone et confirmez le code depuis celui-ci.
Le réglage s'applique à partir du prochain code demandé par Asterobot. Si un code est déjà en attente, le QR code arrive avec le suivant, ou quand Asterobot redémarre sans connexion enregistrée.
Le bouton de compte
| Le bouton de compte affiche | Ce que cela signifie | Ce que fait un clic |
|---|---|---|
| Se connecter, avec un point rouge | Asterobot n'est pas connecté et n'attend aucun code. | Lance une nouvelle connexion. |
| Connexion en attente | Un code vous attend. | Ouvre le lien de connexion dans un nouvel onglet. |
| Votre avatar et votre nom, ou Connecté pendant le chargement de votre profil | Asterobot est connecté. | Ouvre un menu avec Compte, Profil en ligne et Se déconnecter. |
Compte ouvre une page consacrée à votre compte asterobot.net, décrite dans Votre compte.
Se déconnecter puis se reconnecter
- Cliquez sur le bouton de compte, puis sur Se déconnecter. Le bouton Déconnecter de la page Compte fait la même chose.
- Confirmez. Asterobot oublie sa connexion, et le bouton de compte affiche de nouveau Se connecter.
Après une déconnexion, Asterobot ne se reconnecte pas tout seul, pas même quand il redémarre. Pour vous reconnecter, cliquez sur Se connecter sur le bouton de compte. Asterobot demande un nouveau code et ouvre le lien dans un onglet du navigateur sur l'ordinateur où il tourne, et le bouton de compte l'ouvre aussi.
Quand la connexion cesse de fonctionner
asterobot.net peut cesser d'accepter la connexion d'Asterobot, par exemple une fois qu'elle a expiré ou qu'elle a été révoquée. Dans ce cas, Asterobot l'oublie et lance aussitôt une nouvelle connexion. Le terminal affiche un avertissement, comme Website rejected the token, puis un nouveau lien, et le bouton de compte passe à Connexion en attente. Confirmez le nouveau code comme décrit plus haut.
Garder la connexion privée
Asterobot enregistre sa connexion dans config.toml, sous le réglage website.token : c'est ce qui lui permet de rester connecté d'un redémarrage à l'autre. Quiconque obtient cette valeur peut s'en servir pour utiliser votre accès asterobot.net. Ne la partagez jamais, pas plus que le fichier config.toml qui la contient. Obtenir de l'aide liste ce que vous pouvez partager sans risque quand vous demandez de l'aide.