Connexion

Connectez l'application mobile Stib à votre serveur pour gérer vos boards, cartes et agents depuis votre téléphone ou tablette. Ce guide couvre la méthode de connexion par QR code et la saisie manuelle de l'URL.

Prérequis

Avant de connecter l'application mobile, assurez-vous que :

• Le serveur Stib est en cours d'exécution — le serveur doit être démarré et accessible (vérifiez en ouvrant son URL dans un navigateur)
• L'application mobile Stib est installée — téléchargez-la depuis le store de votre plateforme ou installez l'APK
• Accès réseau — votre appareil mobile doit pouvoir atteindre le serveur :
  • Réseau local : le serveur et votre téléphone doivent être sur le même Wi-Fi / LAN
  • Accès distant : le serveur doit être exposé via une URL publique (ex. https://stib.example.com)

TIP

Le port par défaut du serveur Stib est 50505. Si vous accédez à l'interface web via http://192.168.1.10:50505, vous utiliserez la même adresse pour l'application mobile.

Connexion par QR Code

La méthode la plus rapide est de scanner un QR code depuis l'interface web :

1. Ouvrez l'interface web Stib dans votre navigateur
2. Ouvrez les Paramètres utilisateur depuis la barre latérale
3. Dans l'onglet Général, trouvez la section Connexion mobile
4. Sur votre téléphone, ouvrez l'application mobile Stib
5. Sur l'écran d'accueil, appuyez sur Scanner le QR Code
6. Pointez votre caméra vers le QR code affiché à l'écran
7. L'application lit automatiquement l'adresse du serveur et se connecte

INFO

Le QR code contient l'adresse, le port et l'URL WebSocket de votre serveur. Aucun identifiant ni jeton n'est transmis — son affichage à l'écran est sans risque.

Une fois scanné, l'application valide la connexion en contactant le serveur. En cas de succès, vous accédez directement à la liste des projets.

Connexion par URL manuelle

Si le scan du QR code n'est pas possible, vous pouvez saisir l'URL du serveur manuellement :

1. Ouvrez l'application mobile Stib
2. Sur l'écran d'accueil, appuyez sur Saisir l'URL manuellement
3. Tapez l'adresse de votre serveur au format :
   • Local : http://<ip-du-serveur>:50505
   • Public : https://stib.example.com
4. Appuyez sur Connexion

WARNING

Assurez-vous que l'URL commence par http:// ou https://. L'application rejettera les URL sans schéma.

TIP

Si votre application a été installée avec une URL serveur pré-configurée, le champ URL sera pré-rempli. Vous pouvez toujours la modifier.

Modes d'authentification

Après la connexion de l'application mobile au serveur, le comportement dépend du mode d'authentification configuré sur le serveur :

Mode solo (par défaut)

Si l'authentification n'est pas activée sur le serveur, vous accédez directement à tous les projets et fonctionnalités. Aucune connexion n'est requise.

Mode collaboratif

Si l'authentification est activée, l'application vous demandera de vous connecter après l'établissement de la liaison :

• Identifiant et mot de passe — saisissez vos identifiants
• OIDC / SSO — appuyez sur le bouton SSO pour vous authentifier via votre fournisseur d'identité

INFO

En mode collaboratif, votre jeton de session est stocké localement sur l'appareil. Vous restez connecté jusqu'à la déconnexion explicite ou l'expiration du jeton.

Comportement de reconnexion

Lorsque l'application mobile passe en arrière-plan (par exemple, si vous changez d'application), le système d'exploitation peut fermer la connexion réseau. C'est un comportement normal sur les appareils mobiles.

Quand vous revenez dans l'application Stib, elle se reconnecte automatiquement au serveur. Un bref indicateur de chargement peut apparaître pendant le rétablissement de la connexion — aucune action de votre part n'est nécessaire.

Dépannage

Si vous rencontrez des difficultés pour connecter l'application mobile, vérifiez les problèmes courants suivants :

Erreur « URL invalide »

L'URL doit commencer par http:// ou https://. Vérifiez le format et supprimez les espaces en fin de saisie.

Erreur « Impossible de se connecter au serveur »

• Vérifiez que le serveur Stib est en cours d'exécution (essayez d'ouvrir l'URL dans un navigateur)
• Assurez-vous que l'adresse IP et le port sont corrects
• En réseau local, confirmez que les deux appareils sont sur le même Wi-Fi
• Vérifiez qu'aucun pare-feu ne bloque le port 50505

Erreur « Erreur réseau »

Votre appareil ne peut pas du tout atteindre le serveur. Cela signifie généralement :

• Vous n'êtes pas connecté au Wi-Fi ou aux données mobiles
• Le serveur est sur un réseau local et votre téléphone est sur un réseau différent
• Le serveur est derrière un pare-feu sans accès externe

Erreur « Authentification requise »

Le serveur fonctionne en mode collaboratif. Vous devez vous connecter avec vos identifiants ou utiliser l'OIDC/SSO. Si vous n'avez pas de compte, contactez votre administrateur Stib.

TIP

Vous pouvez modifier l'URL du serveur à tout moment depuis l'écran des paramètres de l'application pour vous connecter à un serveur différent.

Étapes suivantes

Maintenant que votre application mobile est connectée, consultez le guide d'utilisation mobile pour apprendre à gérer vos boards, cartes et agents depuis votre téléphone.