---
title: Whitelabel och företagsinställningar
description: Anpassade domäner, varumärkesportaler, SAML SSO och API-åtkomst för företagsklubbar
order: 86
source_hash: 2cf29b121add
slug: whitelabel-och-foretagsinstallningar
---

# 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](embed-domains-for-iframes.md) |
| **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](club-branding-and-hero-images.md) — 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](../joining-events/enterprise-saml-and-whitelabel-login.md) |
| **Varumärkes-e-post** | Inloggningskoder och transaktionsmail från din avsändare | [SendGrid](../integrations/sendgrid.md) 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](../more-tools/public-api-overview.md) |
| **Manager console** | N/A — arrangörer använder distantrace.com | Oförändrad; [Tvåfaktorsautentisering](../joining-events/two-factor-authentication.md) krävs fortfarande |

::: note 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

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

1. **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.
2. **DistantRace-autentisering** — hanterar inloggningskoder, OAuth, SAML och sportappanslutningar. Tematiserade mallar tillämpas när OAuth-begäran innehåller din organisationskontext.
3. **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](embed-domains-for-iframes.md) |
| Varumärkes-e-postavsändare | Club → Integrations → [SendGrid](../integrations/sendgrid.md) |
| Klubbens logotyp | Club → Settings |
| Inaktivera dagliga översiktsmail | Klubbnivå eller per utmaning (whitelabel-klubbar) |

## Deltagarinloggningsflöden

Whitelabel-portaler använder vanligtvis **OAuth authorization code**:

1. Deltagaren klickar på **Sign in** på den varumärkta webbplatsen.
2. Webbläsaren omdirigerar till DistantRace `/oauth/authorize/` med din organisations UUID.
3. DistantRace visar en **tematiserad** inloggningssida (e-postkod, passnyckel eller SAML — beroende på klubbkonfiguration).
4. Efter autentisering återvänder webbläsaren till din portal med en kod som byts mot åtkomst- och uppdateringstokens.
5. 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](../joining-events/enterprise-saml-and-whitelabel-login.md).

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

## E-post och aviseringar

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

## Relaterade

- [Företags-SAML och whitelabel-inloggning](../joining-events/enterprise-saml-and-whitelabel-login.md) — deltagarinloggning
- [Klubbvarumärke och hero images](club-branding-and-hero-images.md)
- [Bädda in domäner för iframes](embed-domains-for-iframes.md)
- [Offentlig API-översikt](../more-tools/public-api-overview.md)
- [SendGrid](../integrations/sendgrid.md)