---
title: Enterprise SAML und Whitelabel-Login
description: Anmelden auf einem gebrandeten Vereinsportal mit SSO, OAuth oder E-Mail-Login-Codes
order: 57
source_hash: e9db77099340
slug: 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](sign-in-options.md) (E-Mail, Google, Apple, Passkey).

## Gebrandetes Teilnehmerportal

Auf einer Whitelabel-Seite:

1. Öffnen Sie die **gebrandete URL Ihres Vereins** (nicht distantrace.com).
2. Durchsuchen Sie veröffentlichte Challenges und Events ohne Anmeldung.
3. 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:

1. **Sitzungsflags**, die während eines gestalteten Logins auf Ihrem Portal gesetzt werden
2. **Verifizierte Einbettungsdomain** — der Host in Ihrer Portal-URL oder OAuth-`next`-Link wird über [Einbettungsdomains](../running-events/embed-domains-for-iframes.md) 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](../running-events/whitelabel-and-enterprise-setup.md).

## SAML / Enterprise SSO

Für Vereine mit konfiguriertem SAML:

1. Öffnen Sie die gebrandete URL des Vereins oder einen direkten Event-Link.
2. Klicken Sie auf **Mit Arbeitskonto anmelden** / Organisations-Login (oder starten Sie von einem SAML-fähigen Einstiegspunkt).
3. 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/`).
4. Schließen Sie die Authentifizierung im Microsoft-Portal Ihres Unternehmens (oder dem konfigurierten IdP) ab.
5. 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](../integrations/sendgrid.md)-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](two-factor-authentication.md). 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](../more-tools/public-api-overview.md).

## Verwandte Themen

- [Whitelabel und Enterprise-Einrichtung](../running-events/whitelabel-and-enterprise-setup.md)
- [Vereinsbranding und Hero-Bilder](../running-events/club-branding-and-hero-images.md)
- [Anmeldeoptionen](sign-in-options.md)
- [Einladungslinks per E-Mail](email-invitation-links.md)