Artikel über: Integrationen, SSO & API

SSO als Endbenutzer nutzen: Erste Anmeldung & Account-Verknüpfung

Ihre Organisation hat Single Sign-On (SSO) eingerichtet — Sie melden sich ab jetzt mit Ihrem Firmen-Account (z. B. Microsoft Entra) bei ContractHero an, nicht mehr mit einem separaten Passwort. Dieser Artikel zeigt beides: wie Sie sich als neu eingeladene Person per SSO registrieren, und wie Sie einen bestehenden ContractHero-Account mit Ihrem Firmen-Account verknüpfen.

Ihr Vorteil

Kein zweites Passwort mehr merken, keine separaten Logout/Login-Schleifen — Sie melden sich einmal am Tag bei Ihrem Firmen-Account an und nutzen ContractHero direkt. Ihre Organisation profitiert gleichzeitig von zentral gesteuerter MFA und sauberem Offboarding (wer das Unternehmen verlässt, verliert den ContractHero-Zugriff automatisch).

Welcher Fall trifft auf Sie zu?

Sie wurden gerade eingeladen und hatten noch nie einen ContractHero-Account. Dann registrieren Sie sich über die Einladung per SSO — siehe „Neu eingeladen: per SSO registrieren".
Sie haben bereits einen ContractHero-Account und Ihre Organisation stellt gerade auf SSO um. Dann verknüpfen Sie Ihren bestehenden Account einmalig — siehe „Bestehenden Account mit SSO verknüpfen".

Voraussetzungen

Eine Einladung Ihrer Organisation. Ohne vorherige Einladung legt eine reine SSO-Anmeldung keinen Account an.
Ihr/Ihre Eigentümer:in der Organisation hat Custom SSO eingerichtet.
Für die Verknüpfung eines bestehenden Accounts: Sie kennen Ihre ContractHero-E-Mail und Ihr ContractHero-Passwort sowie Ihre organisationseigene ContractHero-URL (z. B. <praefix>.app.contracthero.com).

So funktioniert's

Neu eingeladen: per SSO registrieren

1. Einladungslink öffnen

Öffnen Sie den Link aus der Einladungs-E-Mail. Sie landen auf der Seite „Konto erstellen" mit dem Hinweis „Erstellen Sie ein Benutzerkonto, um in die Vertragsverwaltung mit ContractHero einzusteigen." Darunter steht, in welches Team Sie eingeladen wurden: „Sie wurden in das Team [Name Ihrer Organisation] eingeladen!"

2. „Mit OpenID Connect registrieren" wählen

Nutzt Ihre Organisation SSO, ist „Mit OpenID Connect registrieren" die einzige Schaltfläche — ein Feld für ein eigenes Passwort gibt es nicht. Das ist so gewollt: Ihr Zugang läuft künftig über Ihren Firmen-Account.

3. Mit dem Firmen-Account anmelden

Nach dem Klick werden Sie zur Anmeldung Ihres Unternehmens weitergeleitet (z. B. Microsoft Entra / Microsoft 365). Melden Sie sich dort wie gewohnt an. Sind Sie im Browser bereits angemeldet, geht das ohne erneute Passwort-Eingabe. Danach ist Ihr ContractHero-Zugang eingerichtet.

Passiert beim Klick nichts, lesen Sie bitte unten die Frage „Ich klicke auf ‚Mit OpenID Connect registrieren' und es passiert nichts".

Bestehenden Account mit SSO verknüpfen

1. Organisationseigene URL öffnen

Rufen Sie Ihre Custom-URL auf (die genaue Adresse erhalten Sie von Ihrer:Ihrem Eigentümer:in). Die Anmeldeseite zeigt Ihnen jetzt „Login via OpenID Connect" als einzige Option — das Standard-Passwortfeld ist ausgeblendet.

Klicken Sie auf den Button und melden Sie sich mit Ihrem Firmen-Account (z. B. Microsoft Entra / Microsoft 365) an. Falls Sie bereits in Ihrem Browser eingeloggt sind, geht das ohne erneute Passwort-Eingabe.

Beim ersten SSO-Login fragt ContractHero Sie nach Ihrer ContractHero-E-Mail und Ihrem ContractHero-Passwort — das ist die Verknüpfung Ihres bestehenden Accounts mit Ihrem Firmen-Account. Geben Sie die Daten ein.

Warum die zusätzliche Bestätigung? Ohne die einmalige Bestätigung würde ContractHero einen zweiten Account mit derselben E-Mail-Adresse anlegen — das geht aus Datenschutz- und Eindeutigkeitsgründen nicht. Die Verknüpfung passiert nur einmal, danach genügt der SSO-Login.

4. Fertig — ab jetzt nur noch SSO

Ihr ContractHero-Account ist jetzt mit Ihrem Firmen-Account verknüpft. Bei jedem weiteren Login klicken Sie nur noch „Login via OpenID Connect" und sind in Sekunden in ContractHero — ohne Passwort-Eingabe.

Häufige Fragen

Ich klicke auf „Mit OpenID Connect registrieren" und es passiert nichts

Der Button reagiert scheinbar nicht und der Vorgang lässt sich nicht fortsetzen? Dafür gibt es drei häufige Gründe:

Ein Popup-Blocker oder eine Browser-Erweiterung blockiert die Weiterleitung. Öffnen Sie den Einladungslink einmal in einem privaten Fenster oder in einem anderen Browser.
Die Anmeldung öffnet sich in einem neuen Tab oder Fenster, das im Hintergrund hängt. Prüfen Sie Ihre offenen Tabs.
Ihr Konto ist in der Unternehmensanmeldung noch nicht für ContractHero freigeschaltet. Das kann nur Ihre IT beziehungsweise Ihr:e Eigentümer:in prüfen — dort muss Ihr Benutzerkonto der ContractHero-Anwendung zugeordnet sein.

Hilft das nicht weiter, wenden Sie sich an Ihre:n Eigentümer:in oder an support@contracthero.com. Nennen Sie uns dabei bitte Ihren Browser und ob sich beim Klick kurz ein Fenster öffnet oder wirklich gar nichts passiert — damit grenzen wir es schnell ein.

Ich sehe bei der Registrierung kein Feld für ein eigenes Passwort

Das ist richtig so. Nutzt Ihre Organisation SSO, läuft die Registrierung ausschließlich über „Mit OpenID Connect registrieren". Ein eigenes ContractHero-Passwort legen Sie dabei nicht an.

Meine Einladung ist schon ein paar Tage alt — gilt die noch?

Solange die Einladung in Ihrer Organisation als offen geführt wird, können Sie sie weiter nutzen. Kommen Sie nicht weiter, bitten Sie Ihre:n Eigentümer:in, die Einladung erneut zu versenden — oder schreiben Sie uns, wir schicken sie Ihnen neu.

Warum sehe ich kein Passwortfeld mehr?

Ihre Organisation hat den klassischen Passwort-Login deaktiviert, weil SSO produktiv ist. Das ist gewollt und ein Sicherheitsplus.

Was, wenn ich mein ContractHero-Passwort beim Verknüpfen vergessen habe?

Klicken Sie auf „Passwort vergessen" und setzen Sie es kurz neu — dann wiederholen Sie die Verknüpfung. Das neue Passwort brauchen Sie danach nicht mehr, weil künftige Logins über SSO laufen.

Was, wenn ich noch nie einen ContractHero-Account hatte?

Dann brauchen Sie zuerst eine Einladung Ihrer Organisation. Mit der Einladung registrieren Sie sich anschließend direkt per SSO — siehe oben „Neu eingeladen: per SSO registrieren". Eine reine SSO-Anmeldung ohne Vor-Einladung legt keinen Account an.

Was, wenn die E-Mail in meinem Firmen-Account anders ist als in ContractHero?

Die Verknüpfung erfolgt anhand der E-Mail-Adresse. Stimmen die Adressen nicht überein, fragen Sie Ihre:n Eigentümer:in, ob die Adresse in ContractHero auf die aktuelle Firmen-Adresse angepasst wird — dann läuft die Verknüpfung sauber.

Was, wenn die Standard-URL (`app.contracthero.com`) weiterhin funktioniert?

Für Eigentümer:innen ist ein Passwort-Login über die Standard-URL oft als Fallback aktiv. Endbenutzer:innen werden auf die organisationseigene URL geleitet — nutzen Sie die immer.

Was passiert, wenn unser SSO ausfällt?

Wenn der Identity Provider (z. B. Microsoft Entra) temporär nicht erreichbar ist, schlägt der Login fehl. Eigentümer:innen können sich ggf. über den Passwort-Login auf der Standard-URL anmelden, reguläre Mitglieder warten, bis der IdP wieder verfügbar ist.

Gut zu wissen

Die organisationseigene URL als Lesezeichen. Speichern Sie die Custom-URL als Browser-Lesezeichen — das verhindert, dass Sie versehentlich über die Standard-URL einsteigen und das Passwort-Feld vermissen.
Registrierung und Verknüpfung sind zwei verschiedene Wege. Wer neu eingeladen wurde, registriert sich direkt per SSO. Nur wer bereits einen ContractHero-Account mit Passwort hat, durchläuft die einmalige Verknüpfung.
MFA passiert beim Firmen-Login, nicht in ContractHero. Wenn Ihre IT MFA in Microsoft Entra erzwingt, wird die Zwei-Faktor-Prüfung beim SSO-Login einmal pro Sitzung ausgelöst — in ContractHero selbst gibt es keine separate MFA-Abfrage mehr.
Passwort regelmäßig ändern lohnt sich trotzdem. Auch wenn Sie das ContractHero-Passwort nach der Verknüpfung nicht mehr brauchen — als Fallback (z. B. wenn SSO ausfällt) sollte es nicht zu alt sein. Die Passwort-vergessen-Funktion bleibt verfügbar.
Bei Verwirrung: Eigentümer:in ansprechen. Wenn der erste SSO-Login nicht klappt oder Sie unsicher sind, ob die Verknüpfung sauber lief, wenden Sie sich an Ihre:n Eigentümer:in der Organisation — oft lässt sich das Problem in 2 Minuten lösen.