Faire la mise en route : clé, application Discord, administrateur

En bref. Ouvre ton Hub (ton site Agora) dans un navigateur : l'écran Mise en route s'affiche tout seul. En trois étapes, Clé de licence, Application Discord et Administrateur, ton compte Discord devient l'administrateur de ton installation.

Avant de commencer #

• Agora a démarré : la console du serveur (ou ses journaux, les messages qu'il écrit) affiche Ready in …. Si ce n'est pas le cas, reprends l'étape 4 de Ton premier jour avec Agora.
• Tu as ta clé de licence (elle commence par AGORA-). Tu la trouves dans ton espace sur agorapanel.com, sous Mes licences, avec le bouton Afficher la clé : voir Activer ou changer de clé de licence. C'est la même clé que celle déjà posée sur ton serveur : l'écran vérifie que tu la connais.
• Tu as un compte Discord et tu peux ouvrir le portail des développeurs Discord. C'est le site où l'on déclare une « application » Discord, c'est-à-dire l'identité d'Agora auprès de Discord.
• Tu connais l'adresse de ton Hub : http://IP:PORT. Avec Docker, c'est l'adresse IP de ta machine suivie de :3000. Sur un panel, c'est l'adresse et le port de l'allocation du serveur (onglet Network). Les mots techniques sont expliqués dans le glossaire.

Étapes #

Étape 1 : saisir ta clé de licence #

1. Ouvre le Hub par son adresse (http://IP:PORT convient).
2. Colle ta clé dans le champ Clé de licence. Majuscules et espaces en trop n'ont pas d'importance.
3. Clique sur Continuer.

<!-- CAPTURE C-009 -->

Une clé acceptée ouvre la suite pendant 15 minutes. Au-delà, l'écran affiche « La session de mise en route a expiré » : saisis de nouveau la clé.

<!-- CAPTURE C-013 -->

Étape 2 : déclarer l'application Discord #

En haut de l'étape, l'écran affiche l'URL de redirection, l'adresse où Discord renverra tes membres après leur connexion, avec un bouton Copier. Elle est calculée depuis l'adresse par laquelle tu es arrivé : ne la tape jamais à la main.

<!-- CAPTURE C-010 -->

1. Dans le portail Discord (connecte-toi à Discord si on te le demande), clique sur New Application et donne-lui un nom.

2. Ouvre l'onglet OAuth2 et copie l'Application ID, une longue suite de chiffres.

   <!-- CAPTURE C-014 -->

3. Clique sur Reset Secret et copie le secret affiché : il ne se montre qu'une fois.

4. Dans la section Redirects, ajoute l'URL donnée par l'écran d'Agora, puis clique sur Save Changes.

   <!-- CAPTURE C-015 -->

5. Reviens sur Agora et remplis les trois champs : Nom du site, Identifiant de l'application Discord (l'Application ID) et Secret de l'application Discord.

6. Clique sur Enregistrer et me connecter avec Discord.

Les noms des boutons du portail sont donnés en anglais. Si ton Discord est en français, le portail les affiche en français : Créer et configurer ton bot Discord montre chaque écran du portail avec ses équivalents.

Discord accepte une adresse en http:// sur une adresse IP : tu n'as besoin ni de certificat ni de nom de domaine pour démarrer.

Étape 3 : devenir administrateur #

1. Autorise l'application sur Discord : l'écran demande l'accès à ton identité et à ton courriel, rien d'autre.

   <!-- CAPTURE C-016 -->

2. De retour sur Agora, l'écran affiche « Connecté en tant que … ». Clique sur Terminer l'installation.

3. Clique sur Ouvrir l'administration.

<!-- CAPTURE C-011 -->

Aucune reconnexion n'est nécessaire.

Tu sais que c'est réussi quand… #

• La barre du haut affiche Modération, Serveur et Administration.

  <!-- CAPTURE C-019 -->

• Administration → Agora affiche l'état de ta licence, « Essai » ou « Actif », sans « Dernière erreur ».

  <!-- CAPTURE C-018 -->

• L'adresse /api/health de ton Hub répond "ok": true. Tape-la à la suite de l'adresse de l'étape 1 : http://IP:PORT/api/health, ou https://ton-domaine/api/health si tu as un domaine.

  <!-- CAPTURE C-017 -->

Si ça ne marche pas #

Pour aller plus loin #

• Dans le navigateur, pas dans la tablette. La mise en route (et la prise en main du premier administrateur) ne se fait que depuis un navigateur, connecté avec Discord : une session ouverte depuis la tablette en jeu est refusée, même pour le premier compte.

• La porte se ferme. Dès qu'un administrateur existe, /mise-en-route affiche seulement « Cette installation est déjà configurée ». Ni une clé ni un jeton ne la rouvre. Pour donner les droits à quelqu'un d'autre, passe par Administration → Membres. Si tu as perdu l'accès, reprends la main depuis ton panel d'hébergement.

  <!-- CAPTURE C-012 -->

• Installation sans clé de licence. Si la variable AGORA_SETUP_TOKEN est posée, l'étape 1 demande à la place le jeton d'installation, c'est-à-dire la valeur de cette variable.

• Limites. Huit essais par adresse IP et par quart d'heure. Un refus ne dit jamais pourquoi : c'est voulu.

• Ce que l'installation a créé pour toi. Sur une base neuve, Agora pose une structure de départ : les rôles (Administrateur, Modérateur, Whitelist, Police, Justice, EMS…), deux catégories de forum, un formulaire « Demande de whitelist » et une campagne de dons d'exemple à valider. Tout se modifie ensuite.

• La suite. Relier Discord (bot et rôles, facultatif), Brancher la base de données du serveur de jeu pour ouvrir le MDT, puis Installer la ressource FiveM agora pour la tablette.