Accéder au Hub STOA

Ce guide est pour les membres de l’équipe STOA qui viennent de recevoir leur invitation. Il faut une dizaine de minutes, une seule fois par appareil.

Le Hub (l’espace de travail de STOA) ne s’ouvre qu’à travers NetBird, le réseau privé de STOA : une application gratuite et open source, reliée au serveur de STOA. Sans NetBird connecté, l’adresse du Hub ne mène nulle part.

Prestataires : NetBird ne vous concerne pas. Votre contact STOA vous indiquera comment accéder à votre espace.

Avant de commencer

• Ouvrez l’e-mail « Finalisez votre accès STOA » et suivez le lien : choisissez votre mot de passe et enregistrez une clé d’accès (Touch ID, Face ID, Windows Hello, votre téléphone ou une clé de sécurité). Le lien est valable 3 jours ; passé ce délai, demandez-en un nouveau à votre contact STOA.
• Ayez sous la main l’appareil à équiper : un ordinateur (Windows, Mac, Linux) ou un téléphone (iPhone, Android). Sur un ordinateur, l’installation peut demander le mot de passe administrateur de l’appareil.

1. Installer NetBird

• Windows : télécharger NetBird pour Windows, ouvrez le fichier et suivez l’installation.
• Mac : menu Pomme → À propos de ce Mac. Si la ligne « Puce » indique Apple M1, M2, M3 ou M4 : NetBird pour Mac Apple ; sinon (« Processeur » Intel) : NetBird pour Mac Intel. Ouvrez le fichier .pkg et suivez l’installation.
• Linux : suivez la page d’installation de NetBird pour Linux.
• iPhone, iPad : NetBird sur l’App Store.
• Android : NetBird sur Google Play.

Ces liens mènent aux pages officielles de NetBird et des magasins d’applications.

2. Relier NetBird au serveur STOA

L’adresse du serveur STOA, à copier :

https://netbird.stoa-preview.fr

• Ordinateur : au premier lancement, NetBird demande où se connecter. Choisissez Self-hosted et collez l’adresse ci-dessus. Écran déjà passé ? Cliquez sur l’icône NetBird (barre des menus sur Mac, zone de notification sur Windows) → Settings → General → Management Server → Self-hosted, puis collez l’adresse.
• Téléphone : ouvrez NetBird → menu → Change Server, collez l’adresse et validez.

Sur ordinateur, une commande fait la même chose (Terminal sur Mac et Linux, PowerShell sur Windows) ; elle ouvre aussi la page de connexion de l’étape 3 :

netbird up --management-url https://netbird.stoa-preview.fr

3. Se connecter

1. Dans NetBird, cliquez sur Connect. Votre navigateur s’ouvre sur la page de connexion de NetBird.
2. Choisissez la connexion STOA (Keycloak), puis connectez-vous avec votre compte STOA : la même adresse e-mail, le même mot de passe et la même clé d’accès qu’à l’étape « Avant de commencer ».
3. NetBird indique Connected. Laissez-le connecté pendant que vous travaillez dans le Hub.

4. Ouvrir le Hub

Avec NetBird connecté, ouvrez cette adresse dans votre navigateur, puis Se connecter avec votre compte STOA :

https://hub.stoa-preview.fr

Ajoutez-la à vos favoris. Les fois suivantes : NetBird connecté, puis le favori.

En cas de problème

• Le lien de l’invitation a expiré : demandez une nouvelle invitation à votre contact STOA.
• NetBird refuse la connexion (« not allowed », « does not belong to any of the allowed groups ») : votre compte n’a pas accès au réseau STOA. Écrivez à votre contact STOA.
• Le Hub ne s’ouvre pas : vérifiez que NetBird indique Connected ; sinon, Disconnect puis Connect.
• Nouvel appareil : refaites les étapes 1 à 3 sur cet appareil.
• Téléphone ou clé d’accès perdu : prévenez tout de suite votre contact STOA, qui bloque l’accès et vous envoie un nouveau lien.