Whitelabel en bedrijfsinstellingen

Sommige clubs gebruiken DistantRace in een whitelabel implementatie: een merkdeelnemersportaal op een aangepast domein, verbonden met dezelfde organisatorenconsole en evenementgegevens op DistantRace.

Whitelabel is een platformbeheer aanbod. DistantRace stelt de clubvlag, OAuth-referenties, thematische inlogpagina's, hosting van aangepaste domeinen en SAML-identiteitsproviders in. Organisatoren blijven evenementen maken en deelnemers beheren in de manager console zoals gebruikelijk.

Neem contact op met de ondersteuning van DistantRace om whitelabel voor uw organisatie te bespreken.

Wat whitelabel mogelijk maakt #

Hoe het samenwerkt #

flowchart LR
  subgraph portal [Merkdeelnemersportaal]
    SPA[Aangepast domein SPA]
  end
  subgraph drace [DistantRace platform]
    API["/api/v1/"]
    Auth[OAuth + themagebaseerd inloggen]
    Console[Manager console]
    SAML[SAML ontdekking]
  end
  SPA -->|org token — openbare gegevens| API
  SPA -->|gebruikers token — na inloggen| API
  SPA -->|omleiden| Auth
  Auth --> SAML
  Console --> API

1. Deelnemersportaal — een webapp op uw domein. Het laadt openbare evenementgegevens met een organisatie-gebonden API-token en stuurt deelnemers naar DistantRace OAuth voor inloggen.
2. DistantRace-authenticatie — behandelt inlogcodes, OAuth, SAML en sportapp-verbindingen. Thematische sjablonen worden toegepast wanneer het OAuth-verzoek uw organisatiecontext bevat.
3. Manager console — organisatoren maken uitdagingen, competities, tickets en marketing op distantrace.com. Wijzigingen verschijnen op het merkportaal via de API.

Instellen (platformbeheer) #

DistantRace verzorgt doorgaans:

Wat organisatoren zelf configureren #

Deelnemers inlogstromen #

Whitelabel portalen gebruiken meestal OAuth authorization code:

1. Deelnemer klikt op Sign in op de merkwebsite.
2. Browser leidt om naar DistantRace /oauth/authorize/ met de UUID van uw organisatie.
3. DistantRace toont een themagebaseerde inlogpagina (e-mailcode, toegangssleutel of SAML — afhankelijk van clubconfiguratie).
4. Na authenticatie keert de browser terug naar uw portaal met een code die wordt ingewisseld voor toegang en vernieuw tokens.
5. Het portaal roept /api/v1/ aan met het gebruikers token voor persoonlijke acties (deelnemen aan uitdaging, trainingen synchroniseren, profiel bijwerken).

E-mailuitnodigingslinks kunnen deelnemers automatisch inloggen via het redeem-email-token API-eindpunt wanneer het portaal is geconfigureerd met een org token.

SAML SSO is beschikbaar voor bedrijfsclubs. Deelnemers voeren een werk-e-mailadres in; DistantRace leidt naar de juiste IdP per domein. Zie Enterprise SAML en whitelabel login.

API-referenties (overzicht) #

Whitelabel integraties gebruiken twee soorten referenties:

Beide worden aangemaakt en geroteerd door DistantRace tijdens onboarding. Omleidings-URI's moeten overeenkomen met het /auth/callback pad van uw portaal in elke omgeving (staging *.wl.distantrace.com en productie aangepast domein).

OAuth authorize URL #

Deelnemers inloggen begint bij /oauth/authorize/ met:

• client_id — uw gebruikers OAuth-applicatie
• redirect_uri — geregistreerde callback op uw portaal
• response_type=code
• org=<club-uuid> — bindt de inlogpagina aan uw organisatie en selecteert de thematische sjabloon

Nadat de deelnemer authenticatie heeft voltooid (e-mailcode, toegangssleutel of SAML), leidt DistantRace om naar uw callback met een autorisatiecode. Wissel deze server-side of in de SPA in voor toegang en vernieuw tokens.

Join codes en uitnodigingsmails #

Magische link inwisseling kan automatisch een account aanmaken vanuit join-code vooraf ingevulde gegevens, OAuth tokens retourneren en de deelnemer automatisch inschrijven in een gebonden uitdaging wanneer geconfigureerd.

Volledige eindpuntkaart: Openbare API-overzicht.

E-mail en meldingen #

Wanneer SendGrid is verbonden:

• Inlogcode e-mails gebruiken de transactionele sjabloon en afzenderadres van uw organisatie.
• Registratie- en marketingsjablonen volgen dezelfde integratie.

Whitelabel clubs kunnen de automatische Dagelijkse Overzicht e-mail voor stappentellingen onderdrukken op organisatieniveau (daily_email_disabled) of per uitdaging.

Mobiele app #

De standaard DistantRace mobiele app blijft beschikbaar. Deelnemers kunnen sportapps verbinden en stappen synchroniseren via de app, zelfs als ze zich registreren op een merkwebportaal. De app is niet witgelabeld; accountgegevens worden gedeeld tussen distantrace.com, de mobiele app en het merkportaal.

Toegang voor organisatoren #

Organisatoren en personeel blijven de manager console gebruiken op distantrace.com:

• URL-patroon: /console/<org-code>/
• Twee-factor authenticatie is vereist
• SAML kan worden gebruikt voor personeelslogin bij bedrijfsclubs, maar toegang tot de manager console is gescheiden van de deelnemersportaal OAuth-stroom

Zie Hoe toegang te krijgen tot de organisatorenconsole.

Gerelateerd #

• Enterprise SAML en whitelabel login — deelnemers inloggen
• Clubbranding en hero-afbeeldingen
• Domeinen insluiten voor iframes
• Openbare API-overzicht
• SendGrid