---
title: Whitelabel en bedrijfsinstellingen
description: Aangepaste domeinen, merkportalen, SAML SSO en API-toegang voor bedrijfsclubs
order: 86
source_hash: 2cf29b121add
slug: whitelabel-en-bedrijfsinstellingen
---

# 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

| Mogelijkheid | Deelnemerservaring | Organisator / platform |
|--------------|---------------------|------------------------|
| **Aangepast domein** | Bladeren en registreren op uw club-URL (bijv. `events.yourcompany.com`) | DNS + TLS geleverd door DistantRace; domein geverifieerd via [Domeinen insluiten](embed-domains-for-iframes.md) |
| **Merkportaal** | Clubnaam, logo, kleuren en gelokaliseerde UI | SPA-branding geconfigureerd bij implementatie; evenementinhoud komt nog steeds van DistantRace |
| **Themagebaseerd inloggen** | Inlog- en accountpagina's passen bij uw merk tijdens OAuth | `domain_theme` sjablonen op de DistantRace-auth host |
| **OAuth deelnemerslogin** | Inloggen op uw portaal; sessie blijft behouden in de browser | Authorization-code OAuth2-app gericht op uw organisatie |
| **Org API-token** | Openbare lijsten (evenementen, uitdagingen, leaderboards) zonder inloggen | Langdurig leestoegangstoken voor de backend van de merkwebsite |
| **Hero-afbeeldingen API** | Carrouselbanners op de startpagina van het portaal | [Clubbranding en hero-afbeeldingen](club-branding-and-hero-images.md) — beschikbaar wanneer `is_whitelabel` is ingeschakeld |
| **SAML / bedrijfs-SSO** | Inloggen met werk-e-mail via Microsoft Entra ID of andere IdP | Per domein IdP-mapping; ontdekking op `/saml2/discovery/` — zie [Enterprise SAML en whitelabel login](../joining-events/enterprise-saml-and-whitelabel-login.md) |
| **Merk e-mail** | Inlogcodes en transactionele e-mails van uw afzender | [SendGrid](../integrations/sendgrid.md) integratie op de club |
| **Join codes & uitnodigingen** | Codes inwisselen en e-mailuitnodigingslinks op de merkwebsite | Dezelfde join codes als op distantrace.com; automatische inschrijving via API met magische link |
| **Sportapp-verbindingen** | Verbind Garmin, Strava, stappentellers, enz. | OAuth-verbindingen verlopen via de canonieke DistantRace-auth host en keren dan terug naar uw portaal |
| **REST API** | Volledige deelnemersacties na inloggen (deelnemen, trainingen synchroniseren, profiel) | Zelfde `/api/v1/` interface als de mobiele app — [Openbare API-overzicht](../more-tools/public-api-overview.md) |
| **Manager console** | N.v.t. — organisatoren gebruiken distantrace.com | Onveranderd; [Twee-factor authenticatie](../joining-events/two-factor-authentication.md) blijft vereist |

::: note Platform versus portaalbereik
Een whitelabel deelnemersportaal is een gerichte frontend bovenop de DistantRace API. Welke schermen worden blootgesteld (alleen uitdagingen, competities met afrekenen, team leaderboards, enz.) hangt af van de implementatie. Alle onderliggende evenementtypes en instellingen worden geconfigureerd in de manager console.
:::

## Hoe het samenwerkt

```mermaid
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:

| Item | Details |
|------|---------|
| `is_whitelabel` clubvlag | Ontgrendelt beheer van hero-afbeeldingen en de hero-afbeeldingen API |
| OAuth-applicaties | **User client** (authorization code) voor deelnemerslogin; **org token** voor openbare lijsten |
| `domain_theme` | Selecteert merk inlog-/aanmeldingssjablonen op de auth host |
| Hosting van aangepast domein | TLS-certificaat, ingress en optionele `*.wl.distantrace.com` staging-hostnaam (komt overeen met uw `domain_theme` slug) |
| SAML-identiteitsproviders | `SAMLIdentityProvider` records gekoppeld aan e-maildomeinen |
| Portaalimplementatie | Merk SPA-build, cacheproxy en CI/CD op de whitelabel infrastructuur |

## Wat organisatoren zelf configureren

| Taak | Waar |
|------|------|
| Evenementen, tickets, join codes | Manager console — hetzelfde als elke club |
| Hero-afbeeldingen voor de portaalcarrousel | Marketing → **Hero images** (alleen whitelabel clubs) |
| Insluiten / aangepaste domeinen | Club → **Embed domains** — [Domeinen insluiten voor iframes](embed-domains-for-iframes.md) |
| Merk e-mailafzender | Club → Integrations → [SendGrid](../integrations/sendgrid.md) |
| Clublogo | Club → Settings |
| Dagelijkse overzichtse-mails uitschakelen | Clubniveau of per uitdaging instelling (whitelabel clubs) |

## 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](../joining-events/enterprise-saml-and-whitelabel-login.md).

## API-referenties (overzicht)

Whitelabel integraties gebruiken twee soorten referenties:

| Referentie | Toekenning / type | Typisch gebruik |
|------------|-------------------|-----------------|
| **Org token** | Langdurig bearer token (org admin gebruiker) | Openbare uitdaging/evenement lijsten, hero-afbeeldingen, join-code validatie, e-mail-token inwisseling |
| **User OAuth client** | Authorization code (+ vernieuw token) | Deelnemers inloggen, deelnemen aan evenementen, trainingen, profiel, afrekenen |

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

| Stap | API |
|------|-----|
| Valideer een code voordat u afrekenen toont | `GET /api/v1/event/joincode/{code}/validate/` (org token) |
| Wissel e-mail magische link in | `POST /api/v1/event/joincode/redeem-email-token/` met `{ "token": "…" }` |
| Maak codes vanuit uw backoffice | `POST /api/v1/event/joincode/` (admin gebruikers token — niet het openbare org token) |

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](../more-tools/public-api-overview.md).

## E-mail en meldingen

Wanneer [SendGrid](../integrations/sendgrid.md) 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](../joining-events/two-factor-authentication.md) 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](access-the-organizer-console.md).

## Gerelateerd

- [Enterprise SAML en whitelabel login](../joining-events/enterprise-saml-and-whitelabel-login.md) — deelnemers inloggen
- [Clubbranding en hero-afbeeldingen](club-branding-and-hero-images.md)
- [Domeinen insluiten voor iframes](embed-domains-for-iframes.md)
- [Openbare API-overzicht](../more-tools/public-api-overview.md)
- [SendGrid](../integrations/sendgrid.md)