So funktioniert die Anmeldung

Diese Seite ist die maßgebliche Quelle für die Anmeldung an der fremforge-Weboberfläche – deinem Organisations-Dashboard und der Verwaltung unter frem.sh/<your-slug>/_admin/.

Zwei verwandte Themen werden an anderer Stelle behandelt:

• Die Authentifizierung von git selbst (Clone / Push / Pull) ist ein eigener Mechanismus – HTTPS + Git Credential Manager. Siehe Sichere Anmeldung.
• Bestätigen, dass du es bist, wenn sich Git Credential Manager, tea, die fremforge-CLI oder ein Connector eines KI-Assistenten neu anmeldet. Siehe Warum werde ich gebeten zu bestätigen, dass ich es bin?
• Der vollständige Rundgang durch die erste Stunde (Registrierung → Abrechnung → SSO → Einladung) steht in Deine erste Stunde. Diese Seite betrachtet nur den Schritt der Anmeldung genauer.

Das Prinzip

In keiner E-Mail von fremforge steht ein Passwort. Ein ganz neuer Admin wird über einen Einmal-Link angemeldet; alle anderen melden sich über einen von drei Einstiegspunkten an, die alle an denselben Ort führen. Wer diese beiden Fakten verstanden hat, versteht auch den Rest.

Erste Anmeldung (neuer Admin)

Wenn deine Organisation bereitgestellt ist, kommt die Willkommens-E-Mail mit einem einzigen Button:

• „Bei fremforge anmelden →“ – ein Einmal-Anmeldelink (nur einmal verwendbar, läuft nach 48 Stunden ab). Klickst du darauf, wirst du automatisch angemeldet; fremforge fordert dich dann auf, ein Passwort zu wählen und die Zwei-Faktor-Authentifizierung einzuschalten, und bringt dich auf die Willkommensseite deiner Organisation.
• Hatte deine Registrierungs-E-Mail-Adresse bereits ein fremforge-Konto, lautet der Button stattdessen „<your-slug> öffnen →“, und du meldest dich mit deinem bestehenden Passwort an.

Die E-Mail zeigt außerdem deinen Admin-Benutzernamen und deine Registrierungs-E-Mail-Adresse unter „für den Notfallzugang aufbewahren“. Das sind keine Zugangsdaten zum Kopieren – sie sollen dir nur deine Anmeldekennungen nennen. Das Passwort legst du über den Link fest.

Läuft der Link ab, bevor du ihn nutzt, verwende einfach die Discovery-Anmeldung unten und klicke auf Forgot password.

Spätere Anmeldungen

Sobald dein Passwort (oder SSO) eingerichtet ist, führen drei URLs zu deiner Organisation. Nimm die, die du dir am besten merkst – sie führen an denselben Ort:

Das sind Stufen eines einzigen Trichters, keine konkurrierenden Optionen: Discovery klärt, bei welcher Organisation du dich anmeldest, die Seite der Organisation bietet an, wie (SSO oder Passwort), und die universelle Anmeldung ist das zugrunde liegende Formular, das dich tatsächlich authentifiziert.

Dein Benutzername ist ein stabiles Kurzkennzeichen, das in URLs (frem.sh/<username>), in Autorzeilen von Commits und in @mentions verwendet wird – du brauchst ihn aber selten, denn deine Registrierungs-E-Mail-Adresse funktioniert überall dort als Anmeldename, wo ein Benutzername funktioniert.

Nachdem du SSO eingerichtet hast

Sobald ein Admin unter Organisationsverwaltung → SSO eine Auth-Quelle registriert hat (siehe OIDC-SSO):

• Die Anmeldeseiten deiner Organisation (/<your-slug>/login und die universelle Anmeldung) zeigen einen Button „Anmelden mit <name>“. Ein Klick darauf startet den OIDC-Ablauf bei deinem IdP und bringt dich danach zu deiner Organisation zurück.
• Neue Mitglieder, die sich über SSO anmelden, werden bei der ersten Anmeldung automatisch als fremforge-Benutzer angelegt (oder vorab über SCIM übertragen).
• Die Discovery-Anmeldung (/_app/login) leitet SSO-Mitglieder genauso weiter – E-Mail → deine Organisation → IdP.

SSO ist der alltägliche Weg für dein Team. Das lokale Passwort verschwindet aber nie – genau darum geht es beim Break-Glass-Zugang.

Break-Glass (wenn dein IdP ausfällt)

Ist dein Identitätsanbieter einmal nicht erreichbar oder falsch konfiguriert, kommen SSO-Mitglieder nicht über den IdP herein. Die universelle Anmeldung unter frem.sh/user/login (ohne Organisationszusatz ?redirect_to=) akzeptiert lokales Passwort + 2FA und läuft nicht über das SSO deiner Organisation – ein Owner, der seine lokalen Zugangsdaten behalten hat, kommt also immer wieder hinein.

Genau deshalb legt fremforge bei der Registrierung ein lokales Bootstrap-Admin-Konto an und zwingt dich nie, es aufzugeben: Lösche dieses Konto nicht, nachdem du SSO eingerichtet hast. Vollständiges Runbook: SSO-Break-Glass.

Wo du landest

• Beim ersten Mal: auf der Willkommensseite deiner Organisation (Teammitglieder einladen, Abrechnung abschließen).
• Danach: auf deinem Forgejo-Dashboard – frem.sh/<your-slug> für den Entwicklerbereich (Repositorys, Issues, CI) und frem.sh/<your-slug>/_admin/overview für die fremforge-Verwaltung (Abrechnung, SSO, Mitglieder, Audit). Lege dir die Verwaltungs-URL für jede Organisation als Lesezeichen an; es gibt keinen Organisationsumschalter im Produkt, die Navigation erfolgt über den Slug in der URL.

URLs im Überblick