Whitelabel och företagsinställningar

6 min läsning Uppdaterad Jul 2026 14 språk

Whitelabel och företagsinställningar

Vissa klubbar kör DistantRace på en whitelabel-installation: en varumärkesportal för deltagare på en anpassad domän, ansluten till samma arrangörskonsol och eventdata på DistantRace.

Whitelabel är ett plattformshanterat erbjudande. DistantRace aktiverar klubbflaggan, OAuth-referenser, tematiserade inloggningssidor, värd för anpassad domän och SAML-identitetsleverantörer. Arrangörer fortsätter att skapa evenemang och hantera deltagare i manager console som vanligt.

Kontakta DistantRace support för att diskutera whitelabel för din organisation.

Vad whitelabel möjliggör #

Funktion	Deltagarupplevelse	Arrangör / plattform
Anpassad domän	Surfa och registrera dig på din klubbs URL (t.ex. `events.yourcompany.com`)	DNS + TLS tillhandahålls av DistantRace; domän verifieras via Bädda in domäner
Varumärkesportal	Klubbnamn, logotyp, färger och lokaliserat användargränssnitt	SPA-varumärke konfigurerat vid distribution; eventinnehåll kommer fortfarande från DistantRace
Tematiserad inloggning	Inloggnings- och kontosidor matchar ditt varumärke under OAuth	`domain_theme`-mallar på DistantRace autentiseringsvärd
OAuth-deltagarinloggning	Logga in på din portal; sessionen kvarstår i webbläsaren	Authorization-code OAuth2-app begränsad till din organisation
Org API-token	Offentliga listor (evenemang, utmaningar, ledartavlor) utan inloggning	Långlivad lästoken för den varumärkta webbplatsens backend
Hero images API	Karusellbanners på portalens startsida	Klubbvarumärke och hero images — tillgänglig när `is_whitelabel` är aktiverad
SAML / företags-SSO	Logga in med arbets-e-post via Microsoft Entra ID eller annan IdP	Per-domän IdP-mappning; upptäckt på `/saml2/discovery/` — se Företags-SAML och whitelabel-inloggning
Varumärkes-e-post	Inloggningskoder och transaktionsmail från din avsändare	SendGrid integration på klubben
Inbjudningskoder och inbjudningar	Lös in koder och e-postinbjudningslänkar på den varumärkta webbplatsen	Samma inbjudningskoder som distantrace.com; magisk länk auto-registrering via API
Sportappanslutningar	Anslut Garmin, Strava, stegräknare, etc.	OAuth-anslutningsflöden körs på den kanoniska DistantRace autentiseringsvärden, sedan återvänder till din portal
REST API	Fullständiga deltagaråtgärder efter inloggning (gå med, synkronisera träningspass, profil)	Samma `/api/v1/` yta som mobilappen — Offentlig API-översikt
Manager console	N/A — arrangörer använder distantrace.com	Oförändrad; Tvåfaktorsautentisering krävs fortfarande

Plattform vs. portalomfattning

En whitelabel-deltagarportal är en fokuserad frontend ovanpå DistantRace API. Vilka skärmar som exponeras (endast utmaningar, tävlingar med utcheckning, teamledartavlor, etc.) beror på distributionen. Alla underliggande eventtyper och inställningar konfigureras i manager console.

Hur det hänger ihop #

flowchart LR
  subgraph portal [Varumärkesportal för deltagare]
    SPA[Anpassad domän SPA]
  end
  subgraph drace [DistantRace-plattform]
    API["/api/v1/"]
    Auth[OAuth + tematiserad inloggning]
    Console[Manager console]
    SAML[SAML-upptäckt]
  end
  SPA -->|org token — offentlig data| API
  SPA -->|user token — efter inloggning| API
  SPA -->|omdirigera| Auth
  Auth --> SAML
  Console --> API

Deltagarportal — en webbapp på din domän. Den laddar offentliga eventdata med en organisationsbegränsad API-token och skickar deltagare till DistantRace OAuth för inloggning.
DistantRace-autentisering — hanterar inloggningskoder, OAuth, SAML och sportappanslutningar. Tematiserade mallar tillämpas när OAuth-begäran innehåller din organisationskontext.
Manager console — arrangörer skapar utmaningar, tävlingar, biljetter och marknadsföring på distantrace.com. Ändringar visas på den varumärkta portalen via API.

Inställning (plattformshanterad) #

DistantRace hanterar vanligtvis:

Objekt	Detaljer
`is_whitelabel` klubbflagga	Låser upp hantering av hero-bilder och hero-bilder API
OAuth-applikationer	User client (authorization code) för deltagarinloggning; org token för offentliga listor
`domain_theme`	Väljer varumärkesinloggnings-/registreringsmallar på autentiseringsvärden
Värd för anpassad domän	TLS-certifikat, ingress och valfritt `*.wl.distantrace.com` staging-värdnamn (matchar din `domain_theme`-slug)
SAML-identitetsleverantörer	`SAMLIdentityProvider`-poster mappade till e-postdomäner
Portaldistribution	Varumärkes-SPA-bygge, cache-proxy och CI/CD på whitelabel-infrastrukturen

Vad arrangörer konfigurerar själva #

Uppgift	Var
Evenemang, biljetter, inbjudningskoder	Manager console — samma som för vilken klubb som helst
Hero-bilder för portalens karusell	Marketing → Hero images (endast whitelabel-klubbar)
Bädda in / anpassade domäner	Club → Embed domains — Bädda in domäner för iframes
Varumärkes-e-postavsändare	Club → Integrations → SendGrid
Klubbens logotyp	Club → Settings
Inaktivera dagliga översiktsmail	Klubbnivå eller per utmaning (whitelabel-klubbar)

Deltagarinloggningsflöden #

Whitelabel-portaler använder vanligtvis OAuth authorization code:

Deltagaren klickar på Sign in på den varumärkta webbplatsen.
Webbläsaren omdirigerar till DistantRace /oauth/authorize/ med din organisations UUID.
DistantRace visar en tematiserad inloggningssida (e-postkod, passnyckel eller SAML — beroende på klubbkonfiguration).
Efter autentisering återvänder webbläsaren till din portal med en kod som byts mot åtkomst- och uppdateringstokens.
Portalen anropar /api/v1/ med användartoken för personliga åtgärder (gå med i utmaning, synkronisera träningspass, uppdatera profil).

E-postinbjudningslänkar kan automatiskt logga in deltagare via redeem-email-token API-slutpunkt när portalen är konfigurerad med en org-token.

SAML SSO är tillgängligt för företagsklubbar. Deltagare anger en arbets-e-post; DistantRace dirigerar till rätt IdP efter domän. Se Företags-SAML och whitelabel-inloggning.

API-referenser (översikt) #

Whitelabel-integrationer använder två typer av referenser:

Referens	Beviljande / typ	Typisk användning
Org token	Långlivad bärare-token (org admin-användare)	Offentliga utmanings-/evenemangslistor, hero-bilder, inbjudningskodvalidering, e-posttokeninlösen
User OAuth client	Authorization code (+ uppdateringstoken)	Deltagarinloggning, gå med i evenemang, träningspass, profil, utcheckning

Båda skapas och roteras av DistantRace under onboarding. Omdirigerings-URI:er måste matcha din portals /auth/callback-sökväg i varje miljö (staging *.wl.distantrace.com och produktionsanpassad domän).

OAuth authorize URL #

Deltagarinloggning börjar på /oauth/authorize/ med:

client_id — din användar-OAuth-applikation
redirect_uri — registrerad återuppringning på din portal
response_type=code
org=<club-uuid> — binder inloggningssidan till din organisation och väljer den tematiserade mallen

Efter att deltagaren autentiserats (e-postkod, passnyckel eller SAML) omdirigerar DistantRace till din återuppringning med en auktorisationskod. Byt den server-side eller i SPA mot åtkomst- och uppdateringstokens.

Inbjudningskoder och inbjudningsmail #

Steg	API
Validera en kod innan utcheckning visas	`GET /api/v1/event/joincode/{code}/validate/` (org token)
Lös in e-postens magiska länk	`POST /api/v1/event/joincode/redeem-email-token/` med `{ "token": "…" }`
Skapa koder från ditt backoffice	`POST /api/v1/event/joincode/` (admin-användartoken — inte den offentliga org-token)

Inlösen av magisk länk kan automatiskt skapa ett konto från förifyllda data för inbjudningskod, returnera OAuth-tokens och automatiskt registrera deltagaren i en bunden utmaning när den är konfigurerad.

Fullständig slutpunktskarta: Offentlig API-översikt.

E-post och aviseringar #

När SendGrid är ansluten:

Inloggningskod-mail använder din organisations transaktionsmall och avsändaradress.
Registrerings- och marknadsföringsmallar följer samma integration.

Whitelabel-klubbar kan undertrycka det automatiska Dagliga översikts-mailet för stegutmaningar på organisationsnivå (daily_email_disabled) eller per utmaning.

Mobilapp #

Den standard DistantRace mobilappen är fortfarande tillgänglig. Deltagare kan ansluta sportappar och synkronisera steg genom appen även när de registrerar sig på en varumärkt webbportal. Appen är inte whitelabel; kontodata delas mellan distantrace.com, mobilappen och den varumärkta portalen.

Arrangörsåtkomst #

Arrangörer och personal fortsätter att använda manager console på distantrace.com:

URL-mönster: /console/<org-code>/
Tvåfaktorsautentisering krävs
SAML kan användas för personalinloggning på företagsklubbar, men konsolåtkomst är separat från deltagarportalens OAuth-flöde

Se Hur man får åtkomst till arrangörskonsolen.

Relaterade #

Företags-SAML och whitelabel-inloggning — deltagarinloggning
Klubbvarumärke och hero images
Bädda in domäner för iframes
Offentlig API-översikt
SendGrid

Var den här sidan till hjälp?

Tack — din feedback hjälper oss att förbättra dokumentationen.

Visa som Markdown