Enterprise SAML en whitelabel inloggen
Enterprise SAML en whitelabel inloggen
Sommige clubs draaien op een whitelabel DistantRace-implementatie — een merkwebsite op een aangepast domein met enterprise single sign-on (SSO) via SAML (meestal Microsoft Entra ID / Azure AD), of OAuth-gebaseerde login via DistantRace.
Voor wie dit geldt #
- Bedrijfs- of federatieclubs met ingeschakelde whitelabel
- Deelnemers die een werk e-mail domein moeten gebruiken (voor SAML)
- Organisaties die inloggen via een merkportaal in plaats van distantrace.com
Standaardgebruikers van distantrace.com gebruiken Inlogopties (e-mail, Google, Apple, toegangssleutel).
Merkdeelnemersportaal #
Op een whitelabel-site doe je meestal het volgende:
- Open de merk-URL van je club (niet distantrace.com).
- Blader door gepubliceerde uitdagingen en evenementen zonder in te loggen.
- Klik op Inloggen wanneer je wilt deelnemen, trainingen wilt synchroniseren of je profiel wilt beheren.
Inloggen leidt om naar DistantRace OAuth met de UUID van je organisatie in de autorisatie-URL. Inlogpagina's gebruiken de thema sjablonen van je club (logo, kleuren, tekst) wanneer de club een niet-standaard domain_theme heeft. Na authenticatie keer je terug naar de merkwebsite, al ingelogd.
DistantRace bepaalt branding op basis van:
- Sessie vlaggen ingesteld tijdens een thema-inlog op je portaal
- Geverifieerd embed domein — de host in je portaal-URL of OAuth
nextlink wordt aan je club gekoppeld via Embed domeinen
Wat het portaal toont — leaderboards, teamresultaten, competitieafrekening, trainingsgeschiedenis — hangt af van hoe het portaal van je club is geconfigureerd. Evenementregels en registratie komen nog steeds uit de DistantRace-instellingen van de organisator.
Overzicht voor organisatoren: Whitelabel en enterprise setup.
SAML / enterprise SSO #
Voor clubs met geconfigureerde SAML:
- Open de merk-URL van de club of een directe evenementlink.
- Klik op Inloggen met werkaccount / organisatie login (of begin vanaf een SAML-bewuste ingang).
- Voer je werk e-mail in als daarom wordt gevraagd — DistantRace leidt je naar de juiste identiteitsprovider op basis van het e-maildomein (
/saml2/discovery/). - Voltooi de authenticatie op het Microsoft-portaal van je bedrijf (of geconfigureerde IdP).
- Keer terug naar DistantRace ingelogd — registreer je voor evenementen zoals gebruikelijk.
Als je domein niet is geconfigureerd, zie je een foutmelding met het verzoek contact op te nemen met je IT-beheerder.
Meerdere identiteitsproviders #
Wanneer er meerdere SAML-providers zijn, stemt de ontdekkingspagina je e-mail domein af op de juiste IdP voordat je wordt doorgestuurd naar /saml2/login/?idp=….
Als er slechts één IdP is geconfigureerd, slaat de ontdekking het formulier over en word je direct naar de login gestuurd.
Ontdekkingsfouten #
| Bericht | Betekenis |
|---|---|
| Voer een geldig werk e-mailadres in | Ontbrekend of verkeerd geformatteerd adres |
| We hebben geen Single Sign-On geconfigureerd voor dit domein | Je IT-team heeft dat e-maildomein niet geregistreerd bij DistantRace |
Neem contact op met je clubbeheerder of IT als je domein ondersteund zou moeten worden.
Andere inlogmethoden op whitelabel #
Afhankelijk van de clubconfiguratie kunnen thema-inlogpagina's ook aanbieden:
| Methode | Opmerkingen |
|---|---|
| E-mail inlogcode | Eenmalige code verzonden naar je inbox; gebruikt de SendGrid afzender van je club wanneer geconfigureerd |
| Toegangssleutel (WebAuthn) | Wachtwoordloos inloggen als je eerder een toegangssleutel hebt geregistreerd |
| OAuth (autorisatiecode) | Standaardstroom voor merkwebportalen — browser leidt om via DistantRace en terug |
Sportapp-verbindingen (Garmin, Strava, stappentellers) openen op de canonieke DistantRace-authenticatiehost voor OAuth-provideromleidingen. Een ondertekende social return token in de URL brengt je terug naar het merkportaal met hetzelfde thema, ook al draait de provider OAuth op distantrace.com.
Whitelabel branding #
Whitelabel clubs kunnen tonen:
- Clublogo en kleuren op inlog- en accountpagina's
- Aangepaste hero-afbeeldingen op het openbare portaal
- Merktransactie-e-mails (inlogcodes, uitnodigingen) via SendGrid
Organisatorinstellingen voor domeinen, SAML en portaalhosting worden platformbeheer — neem contact op met DistantRace om whitelabel voor je organisatie in te schakelen.
Organisatoren op whitelabel clubs #
Toegang tot de manager console vereist nog steeds Twee-factor authenticatie. SSO of OAuth behandelt de deelnemerslogin op de merkwebsite; 2FA is een aparte beveiligingsstap voor /console/ weergaven op distantrace.com.
API toegang #
Whitelabel organisaties kunnen de REST API gebruiken met organisatiegerichte referenties — zie Openbare API overzicht.