White-label un uzņēmumu iestatīšana

Daži klubi darbina DistantRace white-label izvietojumā: zīmola dalībnieku portāls pielāgotā domēnā, kas savienots ar to pašu organizatora pārvaldības skatu un pasākumu datiem DistantRace.

White-label ir platformas pārvaldīts piedāvājums. DistantRace iespējo kluba karodziņu, OAuth akreditācijas datus, tematizētas pieteikšanās lapas, pielāgota domēna mitināšanu un SAML identitātes nodrošinātājus. Organizatori turpina veidot pasākumus un pārvaldīt dalībniekus pārvaldības skatā kā ierasts.

Sazinies ar DistantRace atbalstu, lai apspriestu white-label savai organizācijai.

Ko white-label iespējo #

Iespēja	Dalībnieka pieredze	Organizators / platforma
Pielāgots domēns	Pārlūko un reģistrējies sava kluba URL adresē (piemēram, events.yourcompany.com)	DNS + TLS nodrošina DistantRace; domēnu verificē caur Iegultajiem domēniem
Zīmola portāls	Kluba nosaukums, logotips, krāsas un lokalizēta saskarne	SPA zīmols konfigurēts izvietošanas laikā; pasākumu saturs joprojām nāk no DistantRace
Tematizēta pieteikšanās	Pieteikšanās un konta lapas atbilst tavam zīmolam OAuth laikā	domain_theme veidnes DistantRace autentifikācijas resursdatorā
OAuth dalībnieka pieteikšanās	Pieteikšanās savā portālā; sesija saglabājas pārlūkā	Authorization-code OAuth2 lietotne, kas piesaistīta tavai organizācijai
Organizācijas API marķieris	Publiski saraksti (pasākumi, izaicinājumi, kopvērtējumi) bez pieteikšanās	Ilgdzīvojošs lasīšanas marķieris zīmola vietnes aizmugursistēmai
Galveno attēlu API	Karuseļa baneri portāla sākuma lapā	Kluba zīmols un galvenie attēli — pieejams, kad iespējots is_whitelabel
SAML / uzņēmuma SSO	Pieteikšanās ar darba e-pastu caur Microsoft Entra ID vai citu IdP	Domēnam specifiska IdP sasaiste; atklāšana /saml2/discovery/ — skati Uzņēmuma SAML un white-label pieteikšanās
Zīmola e-pasts	Pieteikšanās kodi un transakciju e-pasti no tava sūtītāja	SendGrid integrācija klubā
Pievienošanās kodi un uzaicinājumi	Izmanto kodus un e-pasta uzaicinājumu saites zīmola vietnē	Tie paši pievienošanās kodi kā distantrace.com; automātiska iesaiste ar maģisko saiti caur API
Sporta lietotņu savienojumi	Pievieno Garmin, Strava, soļu avotus u. c.	OAuth savienošanas plūsmas darbojas kanoniskajā DistantRace autentifikācijas resursdatorā, pēc tam atgriežas tavā portālā
REST API	Pilnas dalībnieka darbības pēc pieteikšanās (pievienošanās, treniņu sinhronizācija, profils)	Tā pati /api/v1/ saskarne kā mobilajai lietotnei — Publiskā API pārskats
Pārvaldības skats	Nav — organizatori izmanto distantrace.com	Nemainīgs; Divfaktoru autentifikācija joprojām nepieciešama

Kā tas saliekas kopā #

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. Dalībnieku portāls — tīmekļa lietotne tavā domēnā. Tā ielādē publiskos pasākumu datus ar organizācijai piesaistītu API marķieri un nosūta dalībniekus uz DistantRace OAuth pieteikšanos.
2. DistantRace autentifikācija — apstrādā pieteikšanās kodus, OAuth, SAML un sporta lietotņu savienojumus. Tematizētās veidnes tiek piemērotas, kad OAuth pieprasījums ietver tavas organizācijas kontekstu.
3. Pārvaldības skats — organizatori veido izaicinājumus, sacensības, biļetes un mārketingu vietnē distantrace.com. Izmaiņas parādās zīmola portālā caur API.

Iestatīšana (platformas pārvaldīta) #

DistantRace parasti nodrošina:

Vienums	Detaļas
is_whitelabel kluba karodziņš	Atbloķē galveno attēlu pārvaldību un galveno attēlu API
OAuth lietotnes	User client (authorization code) dalībnieku pieteikšanai; org token publiskiem sarakstiem
domain_theme	Izvēlas zīmola pieteikšanās/reģistrācijas veidnes autentifikācijas resursdatorā
Pielāgota domēna mitināšana	TLS sertifikāts, ingress un neobligāts *.wl.distantrace.com testa resursdatora nosaukums (atbilst tavam domain_theme slug)
SAML identitātes nodrošinātāji	SAMLIdentityProvider ieraksti, sasaistīti ar e-pasta domēniem
Portāla izvietošana	Zīmola SPA būvējums, kešatmiņas starpniekserveris un CI/CD white-label infrastruktūrā

Ko organizatori konfigurē paši #

Uzdevums	Kur
Pasākumi, biļetes, pievienošanās kodi	Pārvaldības skats — tāpat kā jebkuram klubam
Galvenie attēli portāla karuselim	Marketing → Hero images (tikai white-label klubiem)
Iegultie / pielāgotie domēni	Club → Embed domains — Iegultie domēni iframe elementiem
Zīmola e-pasta sūtītājs	Club → Integrations → SendGrid
Kluba logotips	Club → Settings
Atspējot ikdienas pārskata e-pastus	Kluba līmeņa vai atsevišķa izaicinājuma iestatījums (white-label klubiem)

Dalībnieka pieteikšanās plūsmas #

White-label portāli parasti izmanto OAuth authorization code:

1. Dalībnieks noklikšķina Sign in zīmola vietnē.
2. Pārlūks pāradresē uz DistantRace /oauth/authorize/ ar tavas organizācijas UUID.
3. DistantRace parāda tematizētu pieteikšanās lapu (e-pasta kods, piekļuves atslēga vai SAML — atkarībā no kluba konfigurācijas).
4. Pēc autentifikācijas pārlūks atgriežas tavā portālā ar kodu, kas apmaināms pret piekļuves un atsvaidzināšanas marķieriem.
5. Portāls izsauc /api/v1/ ar lietotāja marķieri personiskām darbībām (pievienoties izaicinājumam, sinhronizēt treniņus, atjaunināt profilu).

E-pasta uzaicinājumu saites var automātiski pieteikt dalībniekus caur redeem-email-token API galapunktu, kad portāls konfigurēts ar organizācijas marķieri.

SAML SSO ir pieejams uzņēmumu klubiem. Dalībnieki ievada darba e-pastu; DistantRace novirza uz pareizo IdP pēc domēna. Skati Uzņēmuma SAML un white-label pieteikšanās.

API akreditācijas dati (pārskats) #

White-label integrācijas izmanto divus akreditācijas datu veidus:

Akreditācijas dati	Piešķīrums / veids	Tipisks lietojums
Org token	Ilgdzīvojošs bearer marķieris (organizācijas administratora lietotājs)	Publiski izaicinājumu/pasākumu saraksti, galvenie attēli, pievienošanās kodu validācija, e-pasta marķieru izmantošana
User OAuth client	Authorization code (+ atsvaidzināšanas marķieris)	Dalībnieka pieteikšanās, pievienošanās pasākumiem, treniņi, profils, norēķini

Abus izveido un rotē DistantRace iesaistīšanas laikā. Pāradresācijas URI jāatbilst tava portāla /auth/callback ceļam katrā vidē (testa *.wl.distantrace.com un ražošanas pielāgotais domēns).

OAuth authorize URL #

Dalībnieka pieteikšanās sākas /oauth/authorize/ ar:

• client_id — tava lietotāja OAuth lietotne
• redirect_uri — reģistrēts atzvans tavā portālā
• response_type=code
• org=<club-uuid> — piesaista pieteikšanās lapu tavai organizācijai un izvēlas tematizēto veidni

Pēc tam, kad dalībnieks autentificējas (e-pasta kods, piekļuves atslēga vai SAML), DistantRace pāradresē uz tavu atzvanu ar autorizācijas kodu. Apmaini to servera pusē vai SPA pret piekļuves un atsvaidzināšanas marķieriem.

Pievienošanās kodi un uzaicinājumu e-pasti #

Solis	API
Validē kodu pirms norēķinu rādīšanas	GET /api/v1/event/joincode/{code}/validate/ (org token)
Izmanto e-pasta maģisko saiti	POST /api/v1/event/joincode/redeem-email-token/ ar { "token": "…" }
Izveido kodus no sava aizmugures biroja	POST /api/v1/event/joincode/ (administratora lietotāja marķieris — nevis publiskais org token)

Maģiskās saites izmantošana var automātiski izveidot kontu no pievienošanās koda iepriekš aizpildītajiem datiem, atgriezt OAuth marķierus un automātiski iesaistīt dalībnieku piesaistītajā izaicinājumā, kad tas ir konfigurēts.

Pilna galapunktu karte: Publiskā API pārskats.

E-pasts un paziņojumi #

Kad SendGrid ir savienots:

• Pieteikšanās koda e-pasti izmanto tavas organizācijas transakciju veidni un sūtītāja adresi.
• Reģistrācijas un mārketinga veidnes izmanto to pašu integrāciju.

White-label klubi var apspiest automātisko Daily Overview e-pastu soļu izaicinājumiem organizācijas līmenī (daily_email_disabled) vai atsevišķam izaicinājumam.

Mobilā lietotne #

Standarta DistantRace mobilā lietotne joprojām ir pieejama. Dalībnieki var pievienot sporta lietotnes un sinhronizēt soļus caur lietotni, pat ja viņi reģistrējas zīmola tīmekļa portālā. Lietotne nav white-label; konta dati tiek koplietoti starp distantrace.com, mobilo lietotni un zīmola portālu.

Organizatora piekļuve #

Organizatori un darbinieki turpina izmantot pārvaldības skatu vietnē distantrace.com:

• URL šablons: /console/<org-code>/
• Divfaktoru autentifikācija ir nepieciešama
• SAML var izmantot darbinieku pieteikšanai uzņēmumu klubos, bet pārvaldības skata piekļuve ir atsevišķa no dalībnieku portāla OAuth plūsmas

Skati Kā piekļūt organizatora pārvaldības skatam.

Saistīti #

• Uzņēmuma SAML un white-label pieteikšanās — dalībnieka pieteikšanās
• Kluba zīmols un galvenie attēli
• Iegultie domēni iframe elementiem
• Publiskā API pārskats
• SendGrid