Whitelabel og bedriftsoppsett

6 min lesing Oppdatert Jul 2026 14 språk

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
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 — 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
Merkevare-e-post	Innloggingskoder og transaksjonsmail fra din avsender	SendGrid 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
Manager console	Ikke relevant — arrangører bruker distantrace.com	Uendret; Tofaktorautentisering er fortsatt nødvendig

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 #

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

Deltakerportal — en webapp på ditt domene. Den laster offentlige eventdata med et organisasjonsspesifikt API-token og sender deltakere til DistantRace OAuth for innlogging.
DistantRace autentisering — håndterer innloggingskoder, OAuth, SAML og sportapp-tilkoblinger. Tematiserte maler brukes når OAuth-forespørselen inkluderer organisasjonskonteksten din.
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
Merkevare-e-postavsender	Club → Integrations → SendGrid
Klubbens logo	Club → Settings
Deaktiver daglige oversikts-e-poster	Klubbnivå eller per utfordringsinnstilling (whitelabel-klubber)

Deltakerinnloggingsflyter #

Whitelabel-portaler bruker vanligvis OAuth autorisasjonskode:

Deltaker klikker Sign in på merkevaresiden.
Nettleseren omdirigerer til DistantRace /oauth/authorize/ med organisasjonens UUID.
DistantRace viser en tematisert innloggingsside (e-postkode, passnøkkel eller SAML — avhengig av klubbkonfigurasjon).
Etter autentisering returnerer nettleseren til portalen din med en kode som byttes mot tilgangs- og oppfriskningstokener.
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.

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.

E-post og varsler #

Når SendGrid 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 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.

Relatert #

Enterprise SAML og whitelabel-innlogging — deltakerinnlogging
Klubbbranding og hero-bilder
Embed domains for iframes
Offentlig API-oversikt
SendGrid

Var denne siden nyttig?

Takk — tilbakemeldingen din hjelper oss å forbedre dokumentasjonen.

Vis som Markdown