---
title: Whitelabel og bedriftsoppsett
description: Egendefinerte domener, merkevareportaler, SAML SSO og API-tilgang for
  bedriftsklubber
order: 86
source_hash: 2cf29b121add
slug: whitelabel-og-bedriftsoppsett
---

# Whitelabel og bedriftsoppsett

Noen klubber kjører DistantRace på en **whitelabel** distribusjon: en merkevareportal for deltakere på et egendefinert domene, koblet til den samme arrangørkonsollen og eventdataene på DistantRace.

Whitelabel er et **plattformadministrert** tilbud. DistantRace aktiverer klubbflagget, OAuth-legitimasjon, tematiserte innloggingssider, hosting av egendefinert domene og SAML-identitetsleverandører. Arrangører fortsetter å opprette arrangementer og administrere deltakere i **manager console** som vanlig.

Kontakt DistantRace support for å diskutere whitelabel for din organisasjon.

## Hva whitelabel muliggjør

| Funksjon | Deltakeropplevelse | Arrangør / plattform |
|------------|------------------------|----------------------|
| **Egendefinert domene** | Bla gjennom og registrer deg på klubbens URL (f.eks. `events.yourcompany.com`) | DNS + TLS levert av DistantRace; domene verifisert via [Embed domains](embed-domains-for-iframes.md) |
| **Merkevareportal** | Klubbnavn, logo, farger og lokaliserte UI-elementer | SPA-branding konfigurert ved distribusjon; eventinnhold kommer fortsatt fra DistantRace |
| **Tematisert innlogging** | Innloggings- og kontosider matcher merkevaren din under OAuth | `domain_theme`-maler på DistantRace autentiseringsvert |
| **OAuth deltakerinnlogging** | Logg inn på portalen din; økten vedvarer i nettleseren | Autorisasjonskode OAuth2-app tilpasset organisasjonen din |
| **Org API-token** | Offentlige lister (arrangementer, utfordringer, ledertabeller) uten innlogging | Langvarig lesetoken for backend på merkevaresiden |
| **Hero-bilder API** | Karusellbannere på portalens hjemmeside | [Klubbbranding og hero-bilder](club-branding-and-hero-images.md) — tilgjengelig når `is_whitelabel` er aktivert |
| **SAML / bedrifts-SSO** | Logg inn med jobb-e-post via Microsoft Entra ID eller annen IdP | Per-domene IdP-kartlegging; oppdagelse på `/saml2/discovery/` — se [Enterprise SAML og whitelabel-innlogging](../joining-events/enterprise-saml-and-whitelabel-login.md) |
| **Merkevare-e-post** | Innloggingskoder og transaksjonsmail fra din avsender | [SendGrid](../integrations/sendgrid.md) integrasjon på klubben |
| **Bli med-koder og invitasjoner** | Løs inn koder og e-postinvitasjonslenker på merkevaresiden | Samme bli med-koder som distantrace.com; magisk-lenke auto-påmelding via API |
| **Sportapp-tilkoblinger** | Koble til Garmin, Strava, skrittkilder osv. | OAuth-tilkoblingsflyter kjører på den kanoniske DistantRace autentiseringsverten, deretter tilbake til portalen din |
| **REST API** | Full deltakerhandling etter innlogging (bli med, synkroniser treningsøkter, profil) | Samme `/api/v1/` overflate som mobilappen — [Offentlig API-oversikt](../more-tools/public-api-overview.md) |
| **Manager console** | Ikke relevant — arrangører bruker distantrace.com | Uendret; [Tofaktorautentisering](../joining-events/two-factor-authentication.md) er fortsatt nødvendig |

::: note Plattform vs. portalomfang
En whitelabel deltakerportal er en fokusert frontend på toppen av DistantRace API. Hvilke skjermer som eksponeres (kun utfordringer, konkurranser med utsjekking, teamledertabeller osv.) avhenger av distribusjonen. Alle underliggende eventtyper og innstillinger konfigureres i manager console.
:::

## Hvordan det henger sammen

```mermaid
flowchart LR
  subgraph portal [Branded participant portal]
    SPA[Custom domain SPA]
  end
  subgraph drace [DistantRace platform]
    API["/api/v1/"]
    Auth[OAuth + themed login]
    Console[Manager console]
    SAML[SAML discovery]
  end
  SPA -->|org token — public data| API
  SPA -->|user token — after login| API
  SPA -->|redirect| Auth
  Auth --> SAML
  Console --> API
```

1. **Deltakerportal** — en webapp på ditt domene. Den laster offentlige eventdata med et organisasjonsspesifikt API-token og sender deltakere til DistantRace OAuth for innlogging.
2. **DistantRace autentisering** — håndterer innloggingskoder, OAuth, SAML og sportapp-tilkoblinger. Tematiserte maler brukes når OAuth-forespørselen inkluderer organisasjonskonteksten din.
3. **Manager console** — arrangører oppretter utfordringer, konkurranser, billetter og markedsføring på distantrace.com. Endringer vises på merkevareportalen gjennom API.

## Oppsett (plattformadministrert)

DistantRace håndterer vanligvis:

| Element | Detaljer |
|------|---------|
| `is_whitelabel` klubbflagg | Låser opp hero-bildehåndtering og hero-bilder API |
| OAuth-applikasjoner | **User client** (autorisasjonskode) for deltakerinnlogging; **org token** for offentlige lister |
| `domain_theme` | Velger merkevareinnloggings-/registreringsmaler på autentiseringsverten |
| Hosting av egendefinert domene | TLS-sertifikat, ingress og valgfritt `*.wl.distantrace.com` staging vertsnavn (matcher din `domain_theme` slug) |
| SAML-identitetsleverandører | `SAMLIdentityProvider`-poster kartlagt til e-postdomener |
| Portaldistribusjon | Merkevare SPA-bygg, cache-proxy og CI/CD på whitelabel-infrastrukturen |

## Hva arrangører konfigurerer selv

| Oppgave | Hvor |
|------|-------|
| Arrangementer, billetter, bli med-koder | Manager console — som for enhver klubb |
| Hero-bilder for portalens karusell | Marketing → **Hero images** (kun whitelabel-klubber) |
| Embed / egendefinerte domener | Club → **Embed domains** — [Embed domains for iframes](embed-domains-for-iframes.md) |
| Merkevare-e-postavsender | Club → Integrations → [SendGrid](../integrations/sendgrid.md) |
| Klubbens logo | Club → Settings |
| Deaktiver daglige oversikts-e-poster | Klubbnivå eller per utfordringsinnstilling (whitelabel-klubber) |

## Deltakerinnloggingsflyter

Whitelabel-portaler bruker vanligvis **OAuth autorisasjonskode**:

1. Deltaker klikker **Sign in** på merkevaresiden.
2. Nettleseren omdirigerer til DistantRace `/oauth/authorize/` med organisasjonens UUID.
3. DistantRace viser en **tematisert** innloggingsside (e-postkode, passnøkkel eller SAML — avhengig av klubbkonfigurasjon).
4. Etter autentisering returnerer nettleseren til portalen din med en kode som byttes mot tilgangs- og oppfriskningstokener.
5. Portalen kaller `/api/v1/` med brukertokenet for personlige handlinger (bli med i utfordring, synkronisere treningsøkter, oppdatere profil).

**E-postinvitasjonslenker** kan automatisk logge deltakere inn via `redeem-email-token` API-endepunktet når portalen er konfigurert med et org-token.

**SAML SSO** er tilgjengelig for bedriftsklubber. Deltakere skriver inn en jobb-e-post; DistantRace ruter til riktig IdP etter domene. Se [Enterprise SAML og whitelabel-innlogging](../joining-events/enterprise-saml-and-whitelabel-login.md).

## API-legitimasjon (oversikt)

Whitelabel-integrasjoner bruker to typer legitimasjon:

| Legitimasjon | Tilskudd / type | Typisk bruk |
|------------|--------------|-------------|
| **Org token** | Langvarig bearer-token (org admin-bruker) | Offentlige utfordrings-/eventlister, hero-bilder, validering av bli med-koder, innløsning av e-posttoken |
| **User OAuth client** | Autorisasjonskode (+ oppfriskningstoken) | Deltakerinnlogging, bli med i arrangementer, treningsøkter, profil, utsjekking |

Begge opprettes og roteres av DistantRace under onboarding. Omdirigerings-URIer må matche portalens `/auth/callback`-sti i hvert miljø (staging `*.wl.distantrace.com` og produksjon egendefinert domene).

### OAuth autoriser URL

Deltakerinnlogging starter på `/oauth/authorize/` med:

- `client_id` — din bruker OAuth-applikasjon
- `redirect_uri` — registrert callback på portalen din
- `response_type=code`
- `org=<club-uuid>` — binder innloggingssiden til organisasjonen din og velger den tematiserte malen

Etter at deltakeren autentiserer seg (e-postkode, passnøkkel eller SAML), omdirigerer DistantRace til callbacken din med en autorisasjonskode. Bytt den server-side eller i SPA for tilgangs- og oppfriskningstokener.

### Bli med-koder og invitasjons-e-poster

| Trinn | API |
|------|-----|
| Valider en kode før du viser utsjekking | `GET /api/v1/event/joincode/{code}/validate/` (org token) |
| Løs inn e-post magisk lenke | `POST /api/v1/event/joincode/redeem-email-token/` med `{ "token": "…" }` |
| Opprett koder fra ditt back office | `POST /api/v1/event/joincode/` (admin-brukertoken — ikke det offentlige org-token) |

Magisk-lenke innløsning kan automatisk opprette en konto fra bli med-kode forhåndsutfylte data, returnere OAuth-tokener og automatisk melde deltakeren på en tilknyttet utfordring når konfigurert.

Full endepunktkart: [Offentlig API-oversikt](../more-tools/public-api-overview.md).

## E-post og varsler

Når [SendGrid](../integrations/sendgrid.md) er koblet til:

- **Innloggingskode** e-poster bruker organisasjonens transaksjonsmal og avsenderadresse.
- Registrerings- og markedsføringsmaler følger den samme integrasjonen.

Whitelabel-klubber kan undertrykke den automatiserte **Daily Overview** e-posten for skrittutfordringer på organisasjonsnivå (`daily_email_disabled`) eller per utfordring.

## Mobilapp

Den vanlige **DistantRace mobilappen** er fortsatt tilgjengelig. Deltakere kan koble til sportapper og synkronisere skritt gjennom appen selv når de registrerer seg på en merkevareportal. Appen er ikke whitelabel; kontodata deles på tvers av distantrace.com, mobilappen og merkevareportalen.

## Arrangørtilgang

Arrangører og ansatte fortsetter å bruke **manager console** på distantrace.com:

- URL-mønster: `/console/<org-code>/`
- [Tofaktorautentisering](../joining-events/two-factor-authentication.md) er nødvendig
- SAML kan brukes for ansattinnlogging på bedriftsklubber, men konsolltilgang er separat fra deltakerportalens OAuth-flyt

Se [Hvordan få tilgang til arrangørkonsollen](access-the-organizer-console.md).

## Relatert

- [Enterprise SAML og whitelabel-innlogging](../joining-events/enterprise-saml-and-whitelabel-login.md) — deltakerinnlogging
- [Klubbbranding og hero-bilder](club-branding-and-hero-images.md)
- [Embed domains for iframes](embed-domains-for-iframes.md)
- [Offentlig API-oversikt](../more-tools/public-api-overview.md)
- [SendGrid](../integrations/sendgrid.md)