Enterprise SAML und Whitelabel-Login
Enterprise SAML und Whitelabel-Login
Einige Vereine nutzen eine Whitelabel-DistantRace-Implementierung — eine gebrandete Website auf einer benutzerdefinierten Domain mit Enterprise Single Sign-On (SSO) über SAML (häufig Microsoft Entra ID / Azure AD) oder OAuth-basiertem Login über DistantRace.
Für wen das gilt #
- Unternehmens- oder Verbandsvereine mit aktiviertem Whitelabel
- Teilnehmer, die eine Arbeits-E-Mail-Domain verwenden sollen (für SAML)
- Organisationen, die den Login über ein gebrandetes Portal anstelle von distantrace.com leiten
Standardbenutzer von distantrace.com verwenden Anmeldeoptionen (E-Mail, Google, Apple, Passkey).
Gebrandetes Teilnehmerportal #
Auf einer Whitelabel-Seite:
- Öffnen Sie die gebrandete URL Ihres Vereins (nicht distantrace.com).
- Durchsuchen Sie veröffentlichte Challenges und Events ohne Anmeldung.
- Klicken Sie auf Anmelden, wenn Sie beitreten, Workouts synchronisieren oder Ihr Profil verwalten möchten.
Die Anmeldung leitet zu DistantRace OAuth mit der UUID Ihrer Organisation in der Autorisierungs-URL weiter. Anmeldeseiten verwenden die gestalteten Vorlagen Ihres Vereins (Logo, Farben, Text), wenn der Verein ein nicht standardmäßiges domain_theme hat. Nach der Authentifizierung kehren Sie zur gebrandeten Seite zurück, bereits angemeldet.
DistantRace löst das Branding aus:
- Sitzungsflags, die während eines gestalteten Logins auf Ihrem Portal gesetzt werden
- Verifizierte Einbettungsdomain — der Host in Ihrer Portal-URL oder OAuth-
next-Link wird über Einbettungsdomains Ihrem Verein zugeordnet
Was das Portal zeigt — Ranglisten, Teamergebnisse, Wettkampf-Checkout, Workout-Historie — hängt davon ab, wie das Portal Ihres Vereins konfiguriert ist. Eventregeln und Registrierung kommen weiterhin aus den DistantRace-Einstellungen des Organisators.
Übersicht für Organisatoren: Whitelabel und Enterprise-Einrichtung.
SAML / Enterprise SSO #
Für Vereine mit konfiguriertem SAML:
- Öffnen Sie die gebrandete URL des Vereins oder einen direkten Event-Link.
- Klicken Sie auf Mit Arbeitskonto anmelden / Organisations-Login (oder starten Sie von einem SAML-fähigen Einstiegspunkt).
- Geben Sie Ihre Arbeits-E-Mail ein, wenn Sie dazu aufgefordert werden — DistantRace leitet Sie anhand der E-Mail-Domain zum richtigen Identitätsanbieter (
/saml2/discovery/). - Schließen Sie die Authentifizierung im Microsoft-Portal Ihres Unternehmens (oder dem konfigurierten IdP) ab.
- Kehren Sie zu DistantRace zurück, angemeldet — registrieren Sie sich wie gewohnt für Events.
Wenn Ihre Domain nicht konfiguriert ist, sehen Sie einen Fehler, der Sie auffordert, Ihren IT-Administrator zu kontaktieren.
Mehrere Identitätsanbieter #
Wenn mehrere SAML-Anbieter existieren, ordnet die Entdeckungsseite Ihre E-Mail-Domain dem richtigen IdP zu, bevor sie zu /saml2/login/?idp=… weiterleitet.
Wenn nur ein IdP konfiguriert ist, überspringt die Entdeckung das Formular und leitet Sie direkt zur Anmeldung weiter.
Entdeckungsfehler #
| Nachricht | Bedeutung |
|---|---|
| Geben Sie eine gültige Arbeits-E-Mail ein | Fehlende oder falsch formatierte Adresse |
| Wir haben für diese Domain kein Single Sign-On konfiguriert | Ihr IT-Team hat diese E-Mail-Domain nicht bei DistantRace registriert |
Kontaktieren Sie Ihren Vereinsadministrator oder IT, wenn Ihre Domain unterstützt werden sollte.
Andere Anmeldemethoden auf Whitelabel #
Je nach Vereinskonfiguration können gestaltete Anmeldeseiten auch anbieten:
| Methode | Hinweise |
|---|---|
| E-Mail-Login-Code | Einmaliger Code, der an Ihr Postfach gesendet wird; verwendet den SendGrid-Absender Ihres Vereins, wenn konfiguriert |
| Passkey (WebAuthn) | Passwortloses Login, wenn Sie bei einem vorherigen Besuch einen Passkey registriert haben |
| OAuth (Autorisierungscode) | Standardablauf für gebrandete Webportale — der Browser leitet über DistantRace und zurück |
Verbindungen zu Sport-Apps (Garmin, Strava, Schrittquellen) öffnen sich auf dem kanonischen DistantRace-Auth-Host für OAuth-Anbieter-Weiterleitungen. Ein signiertes soziales Rückkehr-Token in der URL bringt Sie zurück zum gebrandeten Portal mit demselben Thema, auch wenn das Anbieter-OAuth auf distantrace.com läuft.
Whitelabel-Branding #
Whitelabel-Vereine können zeigen:
- Vereinslogo und Farben auf Anmelde- und Kontoseiten
- Benutzerdefinierte Hero-Bilder auf dem öffentlichen Portal
- Gebrandete Transaktions-E-Mails (Login-Codes, Einladungen) über SendGrid
Die Einrichtung von Domains, SAML und Portal-Hosting für Organisatoren wird plattformseitig verwaltet — kontaktieren Sie DistantRace, um Whitelabel für Ihre Organisation zu aktivieren.
Organisatoren in Whitelabel-Vereinen #
Der Zugriff auf die Manager-Konsole erfordert weiterhin Zwei-Faktor-Authentifizierung. SSO oder OAuth übernimmt die Teilnehmeranmeldung auf der gebrandeten Seite; 2FA ist ein separater Sicherheitsschritt für /console/-Ansichten auf distantrace.com.
API-Zugriff #
Whitelabel-Organisationen können die REST-API mit organisationsspezifischen Anmeldeinformationen nutzen — siehe Öffentliche API-Übersicht.