Whitelabel- und Enterprise-Einrichtung

Einige Vereine betreiben DistantRace in einer Whitelabel-Bereitstellung: ein gebrandetes Teilnehmerportal auf einer eigenen Domain, das mit der gleichen Organisator-Konsole und den Eventdaten auf DistantRace verbunden ist.

Whitelabel ist ein plattformverwaltetes Angebot. DistantRace aktiviert die Vereinsflagge, OAuth-Anmeldedaten, thematische Anmeldeseiten, Hosting auf eigener Domain und SAML-Identitätsanbieter. Organisatoren erstellen weiterhin Events und verwalten Teilnehmer in der Manager-Konsole wie gewohnt.

Kontaktieren Sie den DistantRace-Support, um Whitelabel für Ihre Organisation zu besprechen.

Was Whitelabel ermöglicht #

Wie es zusammenpasst #

flowchart LR
  subgraph portal [Gebrandetes Teilnehmerportal]
    SPA[Custom Domain SPA]
  end
  subgraph drace [DistantRace-Plattform]
    API["/api/v1/"]
    Auth[OAuth + thematische Anmeldung]
    Console[Manager-Konsole]
    SAML[SAML-Erkennung]
  end
  SPA -->|org token — öffentliche Daten| API
  SPA -->|user token — nach Anmeldung| API
  SPA -->|Weiterleitung| Auth
  Auth --> SAML
  Console --> API

1. Teilnehmerportal — eine Web-App auf Ihrer Domain. Sie lädt öffentliche Eventdaten mit einem organisationsbezogenen API-Token und sendet Teilnehmer zur DistantRace-OAuth-Anmeldung.
2. DistantRace-Authentifizierung — verwaltet Anmeldecodes, OAuth, SAML und Sport-App-Verbindungen. Thematische Vorlagen werden angewendet, wenn die OAuth-Anfrage den Kontext Ihrer Organisation enthält.
3. Manager-Konsole — Organisatoren erstellen Challenges, Wettkämpfe, Tickets und Marketing auf distantrace.com. Änderungen erscheinen über die API auf dem gebrandeten Portal.

Einrichtung (plattformverwaltet) #

DistantRace übernimmt in der Regel:

Was Organisatoren selbst konfigurieren #

Teilnehmer-Anmeldeflüsse #

Whitelabel-Portale verwenden häufig OAuth Authorization Code:

1. Teilnehmer klickt auf Sign in auf der gebrandeten Seite.
2. Der Browser leitet zu DistantRace /oauth/authorize/ mit der UUID Ihrer Organisation weiter.
3. DistantRace zeigt eine thematische Anmeldeseite (E-Mail-Code, Zugangsschlüssel oder SAML — je nach Vereinskonfiguration).
4. Nach der Authentifizierung kehrt der Browser mit einem Code, der gegen Zugriffs- und Aktualisierungstoken eingetauscht wird, zu Ihrem Portal zurück.
5. Das Portal ruft /api/v1/ mit dem Benutzertoken für persönliche Aktionen auf (Challenge beitreten, Workouts synchronisieren, Profil aktualisieren).

E-Mail-Einladungslinks können Teilnehmer automatisch über den redeem-email-token-API-Endpunkt anmelden, wenn das Portal mit einem Org-Token konfiguriert ist.

SAML SSO ist für Unternehmensvereine verfügbar. Teilnehmer geben eine Arbeits-E-Mail ein; DistantRace leitet je nach Domain zum richtigen IdP weiter. Siehe Enterprise SAML und Whitelabel-Anmeldung.

API-Anmeldedaten (Übersicht) #

Whitelabel-Integrationen verwenden zwei Arten von Anmeldedaten:

Beide werden von DistantRace während der Onboarding-Phase erstellt und rotiert. Redirect-URIs müssen dem /auth/callback-Pfad Ihres Portals in jeder Umgebung entsprechen (Staging *.wl.distantrace.com und Produktions-eigene Domain).

OAuth-Authorize-URL #

Die Teilnehmeranmeldung beginnt bei /oauth/authorize/ mit:

• client_id — Ihre Benutzer-OAuth-Anwendung
• redirect_uri — registrierter Callback auf Ihrem Portal
• response_type=code
• org=<club-uuid> — bindet die Anmeldeseite an Ihre Organisation und wählt die thematische Vorlage

Nachdem der Teilnehmer authentifiziert wurde (E-Mail-Code, Zugangsschlüssel oder SAML), leitet DistantRace zu Ihrem Callback mit einem Autorisierungscode weiter. Tauschen Sie diesen serverseitig oder im SPA gegen Zugriffs- und Aktualisierungstoken ein.

Beitrittscodes und Einladungsemails #

Die Einlösung des Magic-Links kann automatisch ein Konto aus den Beitrittscode-Vorfülldaten erstellen, OAuth-Token zurückgeben und den Teilnehmer automatisch in einer gebundenen Challenge anmelden, wenn konfiguriert.

Vollständige Endpunktkarte: Öffentliche API-Übersicht.

E-Mail und Benachrichtigungen #

Wenn SendGrid verbunden ist:

• Anmeldecode-E-Mails verwenden die Transaktionsvorlage und Absenderadresse Ihrer Organisation.
• Registrierungs- und Marketingvorlagen folgen derselben Integration.

Whitelabel-Vereine können die automatisierte Daily Overview-E-Mail für Schritt-Challenges auf Organisationsebene (daily_email_disabled) oder pro Challenge unterdrücken.

Mobile App #

Die standardmäßige DistantRace Mobile App bleibt verfügbar. Teilnehmer können Sport-Apps verbinden und Schritte über die App synchronisieren, auch wenn sie sich über ein gebrandetes Webportal registrieren. Die App ist nicht whitelabel; Kontodaten werden über distantrace.com, die mobile App und das gebrandete Portal geteilt.

Organisatorenzugriff #

Organisatoren und Mitarbeiter nutzen weiterhin die Manager-Konsole auf distantrace.com:

• URL-Muster: /console/<org-code>/
• Zwei-Faktor-Authentifizierung ist erforderlich
• SAML kann für die Anmeldung von Mitarbeitern in Unternehmensvereinen verwendet werden, aber der Zugriff auf die Manager-Konsole ist getrennt vom OAuth-Fluss des Teilnehmerportals

Siehe Wie man auf die Organisator-Konsole zugreift.

Verwandte Themen #

• Enterprise SAML und Whitelabel-Anmeldung — Teilnehmeranmeldung
• Vereinsbranding und Hero-Images
• Eingebettete Domains für iframes
• Öffentliche API-Übersicht
• SendGrid