Serveur > Config liste tous les réglages de votre Asterobot, ceux que vous avez modifiés comme ceux restés à leur valeur par défaut. Ce que vous y changez est enregistré aussitôt dans le fichier config.toml d'Asterobot. Le rôle de chaque réglage est détaillé dans Référence des réglages.
L'ouvrir
- Dans la barre latérale, cliquez sur Serveur.
- Cliquez sur l'onglet Config.
La page commence par « Tous les réglages stockés sur le serveur Asterobot. Les changements s'appliquent en direct. » En dessous se trouvent le filtre, les compteurs et deux boutons, puis une carte par groupe de réglages.
Comment les réglages sont regroupés
Chaque réglage a une clé en deux parties, comme server.listenAddress. La partie avant le point désigne le groupe, et chaque groupe a sa carte, dans l'ordre alphabétique des noms. L'en-tête de la carte affiche le nom du groupe, le nombre de ses réglages listés et combien d'entre eux sont modifiés.
Dans une carte, chaque ligne affiche la partie après le point, comme listenAddress, avec tout ce qui concerne ce réglage :
| Partie de la ligne | Ce qu'elle affiche |
|---|---|
| Le nom | La seconde partie de la clé. Le bouton de copie juste à côté, Copier la clé, copie la clé entière, comme server.listenAddress. |
| Modifié | Vous avez défini ce réglage vous-même. Voir Modifié et valeur par défaut. |
| Redémarrage requis | Asterobot n'utilise une nouvelle valeur qu'à son démarrage. Voir Redémarrage requis. |
| La description | Ce que fait le réglage. Les descriptions des réglages botmanager restent en anglais, quelle que soit la langue d'Asteroboard. |
| Défaut : | La valeur du réglage quand personne ne l'a changée. (vide) signifie un texte vide. |
| Le contrôle | L'endroit où vous changez la valeur : un interrupteur, une liste, une zone de texte ou Éditer en JSON. |
| Le bouton de réinitialisation | Rétablir la valeur par défaut remet la valeur par défaut. Il est grisé, avec l'infobulle Déjà à la valeur par défaut, quand le réglage n'est pas modifié. |
Trouver un réglage
- Filtrer les réglages... garde les réglages dont la clé ou la description contient ce que vous tapez, sans tenir compte des majuscules et des minuscules. La description compte aussi : taper
httpstrouveserver.tls, dont la description parle d'HTTPS. - Modifiés uniquement masque tous les réglages que vous n'avez pas modifiés.
Le badge à côté compte ce que vous voyez, par exemple « 3 sur 19 · 2 modifié(s) » : 3 réglages affichés sur 19, et 2 modifiés au total. Quand rien ne correspond, la page indique « Aucun réglage ne correspond à ce filtre. »
Modifier un réglage
Le contrôle dépend du type de valeur :
| Type de valeur | Contrôle | Quand la modification est enregistrée |
|---|---|---|
| Activé ou désactivé | Un interrupteur | Dès que vous le basculez. |
| Une valeur parmi quelques-unes, comme un niveau de journalisation | Une liste | Dès que vous choisissez une valeur. |
| Du texte ou un nombre | Une zone de texte | Quand vous appuyez sur Entrée ou cliquez en dehors de la zone. Quitter la zone sans changer le texte n'enregistre rien. |
Des identifiants et mots de passe, comme server.basicAuth |
Éditer en JSON | Quand vous cliquez sur Appliquer. |
Une modification enregistrée va directement dans config.toml, et tous les Asteroboard connectés à cet Asterobot l'affichent. Sauf si le réglage porte le badge Redémarrage requis, Asterobot utilise la nouvelle valeur tout de suite.
Quand une modification ne peut pas être enregistrée, Asteroboard affiche Impossible d'enregistrer avec la clé du réglage, et le contrôle reprend la valeur enregistrée. Cela arrive par exemple quand la valeur n'est pas du type que le réglage attend.
Nombres
Un réglage qui contient un nombre n'accepte qu'un nombre. Tout le reste, zone vide comprise, affiche Ce n'est pas un nombre et la zone reprend la valeur enregistrée.
Réglages édités en JSON
server.basicAuth contient une liste d'identifiants avec leurs mots de passe, qu'une simple zone de texte ne peut pas afficher. Cliquez sur Éditer en JSON pour ouvrir un éditeur sous la ligne :
- Modifiez la valeur, par exemple
{"alice": "a long password"}pour un seul identifiant. - Cliquez sur Appliquer. Annuler, ou Masquer le JSON sur la ligne, ferme l'éditeur sans enregistrer.
Si le texte n'est pas du JSON valide, Asteroboard affiche JSON invalide et laisse l'éditeur ouvert pour que vous puissiez corriger.
Modifié et valeur par défaut
Un réglage devient Modifié dès que vous enregistrez une valeur pour lui, même si cette valeur est identique à la valeur par défaut. Seuls les réglages modifiés sont écrits dans config.toml.
Cette différence compte quand vous mettez Asterobot à jour. Un réglage laissé à sa valeur par défaut suit la nouvelle version : si celle-ci change la valeur par défaut, le réglage change avec elle. Un réglage modifié garde votre valeur, quelle que soit la nouvelle valeur par défaut. N'enregistrez donc une valeur que si vous tenez vraiment à la conserver.
Le bouton de réinitialisation annule ce choix : le réglage revient à sa valeur par défaut, perd le badge Modifié et disparaît de config.toml.
Redémarrage requis
Quelques réglages ne sont lus qu'au démarrage d'Asterobot et portent le badge Redémarrage requis : server.listenAddress, server.basicAuth, server.tls, botmanager.mitmSignInPort, botmanager.mitmSessionPort, botmanager.mitmBindHost et botmanager.mitmAdvertiseHost.
Quand l'un d'eux change pendant que la page est ouverte, une alerte apparaît en haut : Redémarrer pour appliquer, « Certains réglages modifiés ne prennent effet qu'après un redémarrage d'asterobot. » Pour redémarrer, arrêtez Asterobot puis relancez-le, comme l'explique Premier lancement. L'alerte apparaît aussi quand la modification vient d'ailleurs, par exemple d'un autre Asteroboard, et elle reste affichée jusqu'à ce que vous rechargiez Asteroboard, même après le redémarrage.
Warning
server.listenAddress, server.basicAuth et server.tls changent la façon dont Asteroboard joint Asterobot. Après le redémarrage, Asteroboard risque de ne plus pouvoir se connecter avec son URL du serveur actuelle. Lisez Asteroboard sur un autre appareil avant de les modifier, et gardez un accès à l'ordinateur sur lequel tourne Asterobot.
Rétablir des réglages
Vous pouvez rétablir à trois niveaux :
- Un réglage : le bouton de réinitialisation au bout de sa ligne.
- Un groupe : le bouton de réinitialisation dans l'en-tête de la carte, Rétablir les réglages de ce service. Il n'apparaît que si le groupe contient des réglages modifiés.
- Tout : Tout rétablir, en haut à droite. Il reste grisé tant que rien n'est modifié.
Tout rétablir demande d'abord confirmation, avec Rétablir tous les réglages modifiés ? et « Cela rétablit 2 réglage(s) modifié(s) à leur valeur par défaut. » Cliquez sur Tout rétablir dans cette alerte pour continuer, ou sur Annuler. Asteroboard confirme avec Réglages rétablis. Le résultat est le même qu'avec la commande config reset (Ligne de commande). Si une réinitialisation échoue, Asteroboard affiche Impossible de rétablir le réglage.
Warning
Une fois Asterobot connecté à asterobot.net, website.token est un réglage modifié. Le rétablir, seul, avec le groupe website ou avec Tout rétablir, déconnecte Asterobot. Asterobot lance alors une nouvelle connexion la prochaine fois qu'il a besoin de votre compte, ou quand vous cliquez sur Se connecter dans le bouton du compte. Voir Se connecter avec asterobot.net.
Valeurs masquées
Deux réglages contiennent des secrets et ne sont jamais affichés par défaut :
website.token, le jeton de connexion d'Asterobot sur asterobot.net. Sa zone affiche des points, et le bouton en forme d'œil à côté révèle la valeur.server.basicAuth, les identifiants et mots de passe qui protègent Asterobot. Sa valeur par défaut s'affiche sous forme de points, mais Éditer en JSON montre les identifiants et les mots de passe en clair.
Un réglage sur lequel Asterobot ne fournit aucune information est masqué de la même façon quand sa clé contient token, password ou secret.
Ne révélez pas ces valeurs, et n'ouvrez pas server.basicAuth dans l'éditeur, si quelqu'un peut voir votre écran. Obtenir de l'aide explique pourquoi.
Réglages déclarés par aucun service
Une ligne qui affiche « Déclaré par aucun service » à la place d'une valeur par défaut correspond à un réglage que config.toml contient mais qu'aucune partie d'Asterobot n'utilise. C'est en général un reste d'une ancienne version, ou une clé tapée à la main avec une faute. Il n'a aucun effet. Son bouton de réinitialisation le retire de config.toml.
Tout recharger
Tout recharger relit tous les réglages depuis Asterobot. La page se tient normalement à jour d'elle-même, vous en aurez donc rarement besoin. Si le rechargement échoue, Asteroboard affiche Impossible de recharger les réglages, ce qui veut en général dire qu'il n'est pas connecté à Asterobot.
Pendant le chargement des réglages, la page indique « Chargement des réglages... », et « Aucun réglage chargé pour le moment. » quand Asteroboard n'a rien à afficher.
Modifier config.toml à la main
Vous pouvez aussi modifier les réglages dans config.toml avec un éditeur de texte. Asterobot surveille le fichier : enregistrez-le, et Asterobot applique la modification en un instant, exactement comme si vous l'aviez faite sur la page Config, puis Asteroboard se met à jour. Le terminal affiche Config loaded from suivi du chemin du fichier.
Le fichier est au format TOML, avec une section par groupe, et ne contient que les réglages que vous avez modifiés. Par exemple :
[logger]
cliLevel = "DEBUG"
[server]
skipOpenFrontend = true
[server.basicAuth]
alice = "a long password"Supprimer une ligne remet ce réglage à sa valeur par défaut. Fichiers et dossiers indique où se trouve le fichier sur chaque système.
Si le fichier ne peut plus être lu après votre modification, par exemple à cause d'un guillemet manquant, le terminal affiche l'avertissement Failed to reload config from file et Asterobot garde les valeurs qu'il avait. Corrigez le fichier et enregistrez-le de nouveau. Asterobot n'écrase pas un fichier qu'il ne peut pas lire, pas même quand il s'arrête.