Aller au contenu principal

Votre première heure avec fremforge

Cette page présente la prise en main du point de vue de l’acheteur et de l’administrateur : ce que vous allez réellement cliquer et voir pendant la première heure qui suit votre décision de vous inscrire. Elle complète Prise en main, davantage orientée développeurs (clés SSH, premier dépôt, première exécution CI).

Si vous allez être le premier propriétaire de votre organisation fremforge, lisez cette page en entier avant de vous inscrire. L’essentiel se fait sans intervention de votre part, mais quatre petites décisions prises pendant cette heure fixent la posture de sécurité et de facturation pour toute la suite de votre utilisation de fremforge ; il est bien moins coûteux de les prendre correctement maintenant que de revenir dessus plus tard.

Le parcours en un coup d’œil

                ┌──────────────────────────────────────────────────────────┐
                │  1. Sign up at www.frem.sh                               │
                │     email + org slug + country/VAT + Altcha PoW          │
                └─────────────────────────┬────────────────────────────────┘
                                          │
                                          ▼
                ┌──────────────────────────────────────────────────────────┐
                │  2. Verification email arrives (Lettermint, EU)          │
                │     click within 24h                                     │
                └─────────────────────────┬────────────────────────────────┘
                                          │
                                          ▼
                ┌──────────────────────────────────────────────────────────┐
                │  3. Confirm page → Mollie hosted checkout (card / SEPA)  │
                │     mandate captured at €0 → tenant + Forgejo org        │
                │     provisioned → welcome email with a one-time link     │
                └─────────────────────────┬────────────────────────────────┘
                                          │
                            ┌─────────────┴─────────────┐
                            ▼                           ▼
            ┌─────────────────────────┐   ┌──────────────────────────────┐
            │  4a. Sign in            │   │  4b. Configure your org      │
            │  frem.sh/_app/login     │   │  frem.sh/<slug>/_admin/   │
            │  → your dashboard       │   │  billing — wire SSO, invite, │
            │                         │   │  review billing              │
            └─────────────────────────┘   └──────────────────────────────┘
                                          │
                            ┌─────────────┴─────────────┐
                            ▼                           ▼
            ┌─────────────────────────┐   ┌──────────────────────────────┐
            │  5. Wire SSO            │   │  6. Confirm billing details  │
            │  (optional but strongly │   │  monthly vs. annual term,    │
            │  recommended on day 1)  │   │  seats, VAT — auto-converts  │
            │                         │   │  on day 30 of trial          │
            └─────────────────────────┘   └──────────────────────────────┘
                                          │
                                          ▼
                ┌──────────────────────────────────────────────────────────┐
                │  7. Harden the break-glass account (MFA on local owner)  │
                │     and invite teammates                                 │
                └──────────────────────────────────────────────────────────┘

L’ensemble du parcours prend 15 à 30 minutes pour une organisation avec un seul administrateur et sans SSO, ou 30 à 60 minutes si vous configurez un IdP et invitez une équipe.

1. Inscrivez-vous

Rendez-vous sur www.frem.sh et cliquez sur Sign up dans la barre de navigation (ou allez directement sur frem.sh/_app/signup). Le formulaire d’inscription demande :

  • E-mail professionnel : il devient l’adresse e-mail de l’administrateur initial et l’adresse de contact de facturation par défaut (vous pourrez modifier l’une et l’autre plus tard).
  • Slug de l’organisation : de 3 à 30 lettres minuscules, chiffres et tirets. C’est le chemin d’URL de votre organisation (frem.sh/<slug> pour l’espace développeurs, frem.sh/<slug>/_admin/... pour l’espace d’administration). Choisissez-le avec soin : un changement de slug passe par l’opérateur, il ne se fait pas en libre-service.
  • Nom d’affichage : ce qui apparaît dans l’interface quand la place manque pour le slug.
  • Pays : détermine le traitement de la TVA et la comptabilité. fremforge est réservé aux entreprises : les États membres de l’UE exigent un numéro de TVA, les autres pays un numéro de TVA ou d’immatriculation de l’entreprise (Norvège : le numéro d’organisation à 9 chiffres).
  • Numéro de TVA ou d’immatriculation de l’entreprise : pour les clients de l’UE, nous le vérifions en direct auprès de VIES avant de créer l’organisation. Si votre registre VIES est momentanément indisponible (cela arrive environ une fois par trimestre et se résout généralement en moins de 24 h), un message d’erreur s’affiche et vous pourrez réessayer une fois le registre rétabli.
  • Déclaration d’entreprise : une case par laquelle vous confirmez vous inscrire au nom d’une entreprise. fremforge ne vend pas aux consommateurs.

Un captcha à preuve de travail s’exécute à l’envoi du formulaire. Il se résout en 1 à 3 secondes et reste invisible : pas de feux de circulation à cliquer.

Pièges courants :

  • Les slugs réservés (par exemple admin, support, legal) et les marques d’autres éditeurs (par exemple github, gitlab) sont refusés à l’envoi. Choisissez un nom distinctif.
  • Les fournisseurs d’adresses e-mail jetables sont bloqués ; utilisez une véritable adresse d’entreprise ou de votre fournisseur d’accès.

2. Vérifiez votre e-mail

Un e-mail de vérification arrive dans votre boîte de réception en quelques secondes. Le lien est valable 24 heures et ne fonctionne qu’une fois : cliquer deux fois ne provisionne pas une seconde organisation (le second clic affiche simplement celle qui existe déjà).

L’e-mail de vérification est envoyé depuis noreply@frem.sh via Lettermint (infrastructure d’envoi ancrée aux Pays-Bas, exclusivement européenne ; l’un des sous-traitants de fremforge désignés dans le DPA). S’il n’est pas arrivé au bout de 5 minutes, vérifiez vos courriers indésirables et le filtre de messagerie de votre entreprise ; l’adresse d’expédition et DKIM devraient être alignés.

3. Confirmation → paiement Mollie → organisation provisionnée → e-mail de bienvenue

Cliquez sur le lien de vérification, puis sur Créer l’organisation sur la page de confirmation. Vous êtes redirigé vers la page de paiement hébergée par Mollie pour autoriser un mandat de paiement avant le provisionnement de l’organisation. Mollie accepte les cartes, le prélèvement SEPA, iDEAL, Bancontact et d’autres moyens de paiement régionaux. La vérification se fait à 0 € (l’émetteur de votre carte peut brièvement pré-autoriser 0,01 € puis l’annuler immédiatement, dans le cadre de l’étape de vérification standard). Rien n’est facturé pendant les 30 jours d’essai : le mandat sert uniquement à ce que l’essai puisse se convertir automatiquement au 30e jour sans nouvelle étape de paiement. Vous pouvez annuler sans frais à tout moment avant cette date dans Admin → Facturation ; nous vous envoyons un rappel trois jours avant le prélèvement automatique.

Une fois le mandat accepté par Mollie, votre organisation est provisionnée, un administrateur initial est créé et l’e-mail de bienvenue est envoyé. Cet administrateur est le même identifiant que votre compte fremforge personnel : si vous inscrivez plus tard une seconde organisation avec la même adresse e-mail, c’est le même utilisateur qui est réutilisé (pas de second compte).

L’e-mail de bienvenue arrive en quelques secondes. Il ne contient aucun mot de passe ; vous y trouverez à la place :

  • Un bouton, « Se connecter à fremforge → » : un lien de connexion à usage unique (utilisable une seule fois, il expire au bout de 48 heures). Il vous connecte automatiquement et vous amène sur la page d’accueil de votre organisation, où il vous est demandé de choisir un mot de passe et de configurer l’authentification à deux facteurs. (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.)
  • Votre nom d’utilisateur d’administrateur et votre e-mail d’inscription, affichés sous la mention « à conserver pour l’accès de secours ». L’un comme l’autre sert d’identifiant ; il n’y a aucun mot de passe à copier, vous le définissez via le lien ci-dessus.
  • La facturation : un lien pour gérer le moyen de paiement et un rappel que l’essai se convertit automatiquement au 30e jour.
  • La page d’administration à mettre en favori : frem.sh/<your-slug>/_admin/overview.

Si l’e-mail de bienvenue n’arrive pas alors que la vérification a fonctionné, votre organisation a bien été créée (l’envoi de l’e-mail est au mieux) : connectez-vous via la connexion par découverte avec votre e-mail d’inscription et utilisez Forgot password pour définir un mot de passe.

4a. Connectez-vous pour la première fois

Nouvelle organisation, nouvel administrateur : cliquez simplement sur « Se connecter à fremforge → » dans l’e-mail de bienvenue. Le lien vous connecte automatiquement (aucun mot de passe à saisir), puis vous demande de choisir un mot de passe et d’activer l’authentification à deux facteurs, avant de vous amener sur la page d’accueil de votre organisation. Le lien est à usage unique et expire au bout de 48 heures ; s’il a expiré avant que vous l’utilisiez, connectez-vous via la connexion par découverte et utilisez Forgot password.

Compte fremforge existant : le bouton de l’e-mail indique alors « Ouvrir <your-slug> → ». Connectez-vous avec le mot de passe que vous avez déjà (le nom d’utilisateur comme l’e-mail d’inscription fonctionnent).

Vous connecter par la suite

Une fois votre mot de passe défini, trois points d’entrée mènent tous à votre organisation ; choisissez celui que vous retiendrez :

  • frem.sh/_app/login : la connexion par découverte. Saisissez votre e-mail ; si le domaine de votre organisation est vérifié, vous êtes renvoyé directement vers la connexion de votre organisation (SSO si vous l’avez configuré, sinon mot de passe). C’est l’adresse à communiquer à votre équipe.
  • frem.sh/<your-slug>/login : la page de connexion à l’image de votre organisation, en accès direct. Elle affiche votre ou vos boutons SSO une fois le SSO configuré ; sinon, elle renvoie vers la connexion par mot de passe.
  • frem.sh/user/login : la connexion universelle par mot de passe, qui est aussi votre accès de secours (break-glass) si votre IdP devient indisponible. Elle accepte toujours votre nom d’utilisateur ou votre e-mail d’inscription avec votre mot de passe.

Pour une vue d’ensemble (comment ces trois points d’entrée s’articulent, ce qui change avec le SSO et la règle du compte de secours), consultez Comment fonctionne la connexion.

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 l’e-mail est toujours accepté comme identifiant. Choisissez un long mot de passe aléatoire dans votre gestionnaire de mots de passe ; vous le saisirez rarement (voir l’étape 7).

La première fois, vous arrivez sur la page d’accueil de votre organisation ; ensuite, la connexion vous amène au tableau de bord de votre organisation à l’adresse frem.sh/<your-slug> (« aucun dépôt pour l’instant » est normal : vous n’avez encore rien poussé). Si vous commencez par configurer le SSO et inviter vos collègues (recommandé), ouvrez l’étape 4b dans un autre onglet.

4b. Configurez votre organisation (l’URL d’administration)

frem.sh/<your-slug>/_admin/overview est la page d’accueil de l’administration : une vue d’ensemble avec des liens rapides vers la facturation, le SSO, la sécurité, les membres, le journal d’audit, etc. Mettez cette URL en favori. Si vous administrez plusieurs organisations fremforge, l’espace d’administration est déterminé par le slug dans l’URL ; il n’existe pas de sélecteur d’organisation dans le produit, vous naviguez en saisissant l’adresse ou via vos favoris.

La première fois que vous ouvrez cette URL, vous êtes redirigé vers la page de connexion de votre organisation (les pages d’administration exigent une session authentifiée). Après la connexion, vous revenez ici.

Lors de la première visite, vous verrez :

  • Le nombre d’utilisateurs (1 par défaut : vous, l’administrateur initial).
  • La durée d’engagement : mensuelle (par défaut ; passez à l’annuel à tout moment pour bénéficier de la remise de 15 % ; vous ne pouvez revenir au mensuel qu’à la fin de la période annuelle).
  • L’état du moyen de paiement : mandat actif (le mandat Mollie recueilli à l’inscription), ou « aucun moyen » avec un bouton Configurer un moyen de paiement → si le paiement a été abandonné à l’inscription ou si le mandat a depuis été révoqué auprès de l’émetteur de votre carte.
  • L’état de l’essai : essai de 30 jours actif, avec la date de conversion automatique.

Si vous voyez « aucun moyen », la priorité est d’ajouter un moyen de paiement avant le 30e jour pour éviter la procédure de suspension. Sinon, passez au SSO et au compte de secours ; la facturation est déjà en place.

5. Configurez le SSO (vivement recommandé dès le premier jour)

Si votre équipe utilise un fournisseur SSO (Okta, Entra, Google Workspace, Authentik, Keycloak, Auth0), configurez-le avant d’inviter qui que ce soit. Le mettre en place après que vos collègues ont des comptes à mot de passe local implique une étape de migration par utilisateur.

Ouvrez Administration de l’organisation → SSO. Il y a deux choses à faire :

  1. Vérifier votre domaine, par un enregistrement DNS TXT ou un défi HTTP .well-known/fremforge-domain.txt. C’est obligatoire avant de pouvoir enregistrer une source d’authentification. Comptez 1 à 5 minutes si vous pouvez modifier le DNS ou déposer un fichier à la racine de votre domaine.

  2. Enregistrer une source d’authentification OIDC. Les formulaires vous guident dans les champs à reprendre de l’IdP. Consultez SSO OIDC pour la configuration propre à chaque IdP, y compris Entra ID et ADFS. SAML n’est pas encore disponible.

Facultatif mais recommandé pour les charges de travail réglementées : pendant que vous êtes sur le formulaire OIDC, remplissez les trois champs Per-org session-binding step-up en bas de page. Ils imposent une nouvelle authentification auprès de l’IdP lors d’un accès d’une organisation à une autre ; consultez OIDC § Per-org session-binding step-up pour les prérequis côté IdP. Si vous laissez ces champs vides, vous retombez sur un rattachement souple (cela fonctionne toujours, simplement sans nouvelle demande forcée de l’IdP ; l’accès de secours par identifiants locaux est préservé dans les deux cas).

Une fois une source d’authentification enregistrée, la prochaine personne qui se connecte via le SSO est automatiquement provisionnée comme utilisateur fremforge. SCIM (provisionnement par envoi depuis l’IdP) se configure séparément : voir SCIM 2.0.

6. Confirmez les informations de facturation

Le mandat a été recueilli à l’inscription : il n’y a donc rien à faire ici pour activer la facturation, mais c’est dans Admin → Facturation que vous confirmez ou modifiez les conditions avant le prélèvement automatique du 30e jour :

Tarifs (prélevés automatiquement au 30e jour, sauf annulation préalable) :

  • Mensuel : 30 € par utilisateur et par mois, facturés d’avance au début de chaque cycle de 30 jours. Résiliable à tout moment ; l’accès se poursuit jusqu’à la fin du mois payé en cours.
  • Annuel : 306 € par utilisateur et par an (soit 25,50 € par utilisateur et par mois, 15 % de remise sur le prix catalogue), facturés d’avance en un seul paiement annuel. Non remboursable en cas de résiliation en cours de période : l’accès se poursuit jusqu’à la date de fin d’engagement et l’année payée n’est pas remboursée.

Ce que vous pouvez modifier avant le 30e jour :

  • Durée d’engagement : passez du mensuel à l’annuel pour bénéficier de la remise de 15 %. Le passage du mensuel à l’annuel est possible à tout moment ; le passage de l’annuel au mensuel ne prend effet qu’au renouvellement suivant.
  • Utilisateurs : invitez vos collègues dès maintenant et le prélèvement du 30e jour reflétera votre nombre réel d’utilisateurs (chaque membre invité compte à partir de son acceptation).
  • Moyen de paiement : remplacez le mandat Mollie (par exemple une autre carte, ou le passage de la carte au prélèvement SEPA) via Replace payment method dans Admin → Facturation. Le remplacement suit la même vérification à 0 € que Mollie a utilisée à l’inscription.
  • Annulation : l’action Annuler l’essai (sans frais) annule le mandat et empêche le prélèvement du 30e jour ; l’organisation conserve un accès en lecture seule pendant la période de conservation des données prévue au §16.5 des conditions.

Rappels : nous envoyons un avertissement 3 jours avant le prélèvement automatique pour que la conversion ne soit pas une surprise. Si le prélèvement automatique Mollie échoue au 30e jour (carte expirée, provision insuffisante), vous recevez la séquence standard d’e-mails de relance : trois nouvelles tentatives sur 14 jours avant que l’organisation passe en période de grâce en lecture seule.

7. Renforcez le compte de secours

L’administrateur initial que vous venez de créer est votre compte de secours (break-glass) : conservez-le, renforcez-le, ne le supprimez pas.

Pourquoi : une fois le SSO configuré, si votre IdP tombe en panne ou est mal configuré, c’est grâce au compte de secours que vous pouvez revenir dans l’administration de votre organisation pour désactiver l’obligation de SSO et débloquer votre équipe. La procédure est décrite dans SSO break-glass ; chaque propriétaire devrait la répéter une fois.

Trois choses à faire maintenant, pendant que vous êtes connecté :

  1. Remplacez le mot de passe initial par un long mot de passe aléatoire si ce n’est pas déjà fait. Générez un mot de passe de 24 caractères ou plus dans un gestionnaire de mots de passe et conservez-le. Vous le saisirez rarement.

  2. Activez la 2FA sur le compte initial : Forgejo prend en charge TOTP (n’importe quelle application d’authentification) et WebAuthn / clés d’accès. La 2FA sur le compte de secours est obligatoire, pas facultative : un long mot de passe aléatoire sans 2FA reste un facteur unique susceptible d’être hameçonné, et un accès de secours à facteur unique ruine l’intérêt d’imposer le SSO. Conservez les codes de récupération dans votre gestionnaire de mots de passe (ou dans une enveloppe scellée dans un coffre, pas dans un message privé Slack).

  3. Vérifiez que la connexion locale fonctionne dans une fenêtre de navigation privée avant d’activer l’option SSO Required. Ouvrez https://frem.sh/user/login, connectez-vous avec le mot de passe local et la 2FA, puis vérifiez que vous accédez bien à Administration de l’organisation → SSO. Faites-le pendant que votre session habituelle est encore ouverte dans une fenêtre normale, afin de pouvoir rattraper la situation en cas de problème.

Pour les organisations qui ont plus d’un administrateur humain, gardez au moins deux propriétaires préparés à l’accès de secours. Si l’un perd son accès (appareil perdu, ordinateur volé, départ de l’entreprise), le second peut rétablir l’accès sans passer par le support.

8. Invitez vos collègues

Allez dans Administration de l’organisation → Membres (frem.sh/<your-slug>/_admin/members) et choisissez Inviter par e-mail. Si vous avez configuré le SSO, vous n’avez à inviter personne : les membres apparaissent automatiquement dans Administration de l’organisation → Membres la première fois qu’ils se connectent via votre fournisseur d’identité, sans provisionnement manuel par utilisateur, et vous accordez les accès en associant des groupes de l’IdP à des équipes dans Administration de l’organisation → SSO. Avec le SSO configuré, Membres affiche Créer un compte local (accès de secours) au lieu d’Inviter par e-mail. Si vous n’avez pas configuré le SSO, chaque personne invitée reçoit un compte à mot de passe local.

Chaque membre invité compte comme utilisateur facturé dès qu’il accepte. fremforge n’a pas de paliers par utilisateur : chaque utilisateur est facturé au même tarif forfaitaire (30 € par mois, ou 306 € par an avec l’engagement annuel). Consultez Membres et équipes pour le modèle complet d’appartenance.

Ce que vous devriez avoir fait au bout d’une heure

Une liste de contrôle rapide à parcourir avant de considérer que c’est terminé :

  • Organisation provisionnée, frem.sh/<your-slug> et frem.sh/<your-slug>/_admin/billing accessibles tous les deux
  • Mot de passe initial remplacé par un long mot de passe aléatoire, 2FA activée et codes de récupération conservés
  • SSO configuré (source d’authentification enregistrée, domaine vérifié), ou décision explicite de le reporter
  • Authentification renforcée configurée (facultatif, pour les charges de travail réglementées), ou notée comme tâche de phase 2
  • Conditions de facturation confirmées (mensuel ou annuel, nombre d’utilisateurs) avant la conversion automatique du 30e jour
  • Au moins un collègue invité (ou noté comme suite à donner)
  • Procédure de secours répétée une fois : déconnexion, puis reconnexion avec le compte local et la 2FA dans une fenêtre de navigation privée

Tout ce que vous laissez non coché dans cette liste est une suite à donner identifiée : notez-la. Les deux qui coûtent cher plus tard sont la MFA du compte de secours et la configuration du SSO ; aujourd’hui, c’est un quart d’heure de travail, alors qu’une fois votre équipe active sur fremforge, cela devient un chantier de plusieurs heures.

Références croisées