Comment fonctionne la connexion

Cette page est la référence unique pour la connexion à l’interface web de fremforge : le tableau de bord de votre organisation et l’espace d’administration à l’adresse frem.sh/<your-slug>/_admin/.

Deux sujets voisins sont traités ailleurs :

• L’authentification de git lui-même (clone / push / pull) est un mécanisme distinct : HTTPS + Git Credential Manager. Voir Connexion sécurisée.
• Confirmer votre identité quand Git Credential Manager, tea, la CLI fremforge ou le connecteur d’un assistant IA se connecte à nouveau. Voir Pourquoi me demande-t-on de confirmer mon identité ?
• Le parcours complet de la première heure (inscription → facturation → SSO → invitations) se trouve dans Votre première heure. Cette page se concentre sur la seule étape de connexion.

Le principe

Il n’y a aucun mot de passe dans les e-mails de fremforge. Un tout nouvel administrateur est connecté par un lien à usage unique ; tous les autres se connectent par l’un des trois points d’entrée, qui mènent tous au même endroit. Une fois ces deux faits compris, le reste en découle.

Première connexion (nouvel administrateur)

Lorsque votre organisation est provisionnée, l’e-mail de bienvenue arrive avec un seul bouton :

• « Se connecter à fremforge → » : un lien de connexion à usage unique (utilisable une seule fois, il expire au bout de 48 heures). Cliquez dessus et vous êtes connecté automatiquement ; fremforge vous demande ensuite de choisir un mot de passe et d’activer l’authentification à deux facteurs, puis vous amène sur la page d’accueil de votre organisation.
• Si votre adresse d’inscription avait déjà un compte fremforge, le bouton indique « Ouvrir <your-slug> → » et vous vous connectez avec votre mot de passe existant.

L’e-mail affiche aussi votre nom d’utilisateur d’administrateur et votre e-mail d’inscription sous la mention « à conserver pour l’accès de secours ». Ce n’est pas un identifiant secret à copier : c’est pour que vous connaissiez vos identifiants de connexion. Vous définissez le mot de passe via le lien.

Si le lien expire avant que vous l’utilisiez, passez simplement par la connexion par découverte ci-dessous et cliquez sur Forgot password.

Se connecter ensuite

Une fois votre mot de passe (ou le SSO) en place, trois URL mènent toutes à votre organisation. Choisissez celle que vous retiendrez, elles aboutissent au même endroit :

Ce sont les étages d’un même entonnoir, pas des options concurrentes : la découverte détermine dans quelle organisation vous vous connectez, la page à l’image de l’organisation propose comment (SSO ou mot de passe), et la connexion universelle est le formulaire sous-jacent qui vous authentifie réellement.

Votre nom d’utilisateur est un identifiant court et stable, utilisé dans les URL (frem.sh/<username>), les lignes d’auteur des commits et les @mentions ; vous en avez rarement besoin, car votre e-mail d’inscription fait aussi office d’identifiant partout où un nom d’utilisateur est accepté.

Une fois le SSO configuré

Dès qu’un administrateur enregistre une source d’authentification dans Administration de l’organisation → SSO (voir SSO OIDC) :

• Les pages de connexion de votre organisation (/<your-slug>/login et la connexion universelle) affichent un bouton « Se connecter avec <name> ». Un clic dessus lance le parcours OIDC auprès de votre IdP, puis vous ramène à votre organisation.
• Les nouveaux membres qui se connectent via le SSO sont provisionnés automatiquement comme utilisateurs fremforge à leur première connexion (ou créés à l’avance via SCIM).
• La connexion par découverte (/_app/login) oriente les membres SSO de la même façon : e-mail → votre organisation → IdP.

Le SSO est le chemin quotidien de votre équipe. Le mot de passe local ne disparaît pas pour autant, et c’est tout l’intérêt de l’accès de secours.

Accès de secours (quand votre IdP est en panne)

Si votre fournisseur d’identité devient injoignable ou est mal configuré, les membres SSO ne peuvent plus entrer via l’IdP. La connexion universelle à l’adresse frem.sh/user/login (sans suffixe d’organisation ?redirect_to=) accepte mot de passe local + 2FA et ne passe pas par le SSO de votre organisation : un propriétaire qui a conservé ses identifiants locaux peut donc toujours revenir.

C’est précisément pour cela que fremforge crée un compte d’administrateur initial local à l’inscription et ne vous oblige jamais à l’abandonner : ne supprimez pas ce compte après avoir configuré le SSO. Procédure complète : SSO break-glass.

Où vous arrivez

• La première fois : la page d’accueil de votre organisation (inviter des collègues, finaliser la facturation).
• Ensuite : votre tableau de bord Forgejo, frem.sh/<your-slug> pour l’espace développeurs (dépôts, tickets, CI), et frem.sh/<your-slug>/_admin/overview pour l’administration fremforge (facturation, SSO, membres, audit). Mettez l’URL d’administration de chaque organisation en favori ; il n’existe pas de sélecteur d’organisation dans le produit, la navigation se fait par le slug dans l’URL.

Les URL en un coup d’œil