Whitelabel i konfiguracja dla przedsiębiorstw

Niektóre kluby korzystają z DistantRace w ramach wdrożenia whitelabel: markowy portal uczestników na niestandardowej domenie, połączony z tą samą konsolą organizatora i danymi wydarzeń na DistantRace.

Whitelabel to oferta zarządzana przez platformę. DistantRace aktywuje flagę klubu, poświadczenia OAuth, tematyczne strony logowania, hosting na niestandardowej domenie oraz dostawców tożsamości SAML. Organizatorzy nadal tworzą wydarzenia i zarządzają uczestnikami w konsoli menedżera jak zwykle.

Skontaktuj się z działem wsparcia DistantRace, aby omówić możliwość wdrożenia whitelabel dla swojej organizacji.

Co umożliwia whitelabel #

Jak to działa razem #

flowchart LR
  subgraph portal [Portal uczestnika z marką]
    SPA[SPA na niestandardowej domenie]
  end
  subgraph drace [Platforma DistantRace]
    API["/api/v1/"]
    Auth[OAuth + tematyczne logowanie]
    Console[Konsola menedżera]
    SAML[Odkrywanie SAML]
  end
  SPA -->|token organizacji — dane publiczne| API
  SPA -->|token użytkownika — po zalogowaniu| API
  SPA -->|przekierowanie| Auth
  Auth --> SAML
  Console --> API

1. Portal uczestnika — aplikacja webowa na Twojej domenie. Ładuje publiczne dane wydarzeń z tokenem API przypisanym do organizacji i wysyła uczestników do DistantRace OAuth w celu logowania.
2. Autoryzacja DistantRace — obsługuje kody logowania, OAuth, SAML i połączenia z aplikacjami sportowymi. Tematyczne szablony są stosowane, gdy żądanie OAuth zawiera kontekst Twojej organizacji.
3. Konsola menedżera — organizatorzy tworzą wyzwania, zawody, bilety i marketing na distantrace.com. Zmiany pojawiają się na portalu z marką przez API.

Konfiguracja (zarządzana przez platformę) #

DistantRace zazwyczaj obsługuje:

Co organizatorzy konfigurują sami #

Przepływy logowania uczestników #

Portale whitelabel zazwyczaj używają kodu autoryzacyjnego OAuth:

1. Uczestnik klika Zaloguj się na stronie z marką.
2. Przeglądarka przekierowuje do DistantRace /oauth/authorize/ z UUID Twojej organizacji.
3. DistantRace wyświetla tematyczną stronę logowania (kod e-mail, klucz dostępu lub SAML — w zależności od konfiguracji klubu).
4. Po uwierzytelnieniu przeglądarka wraca do Twojego portalu z kodem wymienianym na tokeny dostępu i odświeżania.
5. Portal wywołuje /api/v1/ z tokenem użytkownika do działań osobistych (dołączanie do wyzwań, synchronizacja treningów, aktualizacja profilu).

Linki zaproszeń e-mail mogą automatycznie logować uczestników przez punkt końcowy API redeem-email-token, gdy portal jest skonfigurowany z tokenem organizacji.

SAML SSO jest dostępny dla klubów przedsiębiorstw. Uczestnicy wprowadzają służbowy e-mail; DistantRace kieruje do odpowiedniego IdP według domeny. Zobacz SAML dla przedsiębiorstw i logowanie whitelabel.

Poświadczenia API (przegląd) #

Integracje whitelabel używają dwóch typów poświadczeń:

Oba są tworzone i rotowane przez DistantRace podczas wdrożenia. URI przekierowania muszą odpowiadać ścieżce /auth/callback Twojego portalu w każdej z lokalizacji (testowa *.wl.distantrace.com i produkcyjna niestandardowa domena).

URL autoryzacji OAuth #

Logowanie uczestnika rozpoczyna się od /oauth/authorize/ z:

• client_id — Twoja aplikacja OAuth użytkownika
• redirect_uri — zarejestrowany callback na Twoim portalu
• response_type=code
• org=<club-uuid> — wiąże stronę logowania z Twoją organizacją i wybiera tematyczny szablon

Po uwierzytelnieniu uczestnika (kod e-mail, klucz dostępu lub SAML), DistantRace przekierowuje do Twojego callbacku z kodem autoryzacyjnym. Wymień go po stronie serwera lub w SPA na tokeny dostępu i odświeżania.

Kody dołączenia i zaproszenia e-mail #

Wykorzystanie magicznego linku może automatycznie utworzyć konto z danych wstępnie wypełnionych kodem dołączenia, zwrócić tokeny OAuth i automatycznie zapisać uczestnika w przypisanym wyzwaniu, gdy jest skonfigurowane.

Pełna mapa punktów końcowych: Przegląd publicznego API.

E-mail i powiadomienia #

Gdy SendGrid jest połączony:

• E-maile z kodem logowania używają transakcyjnego szablonu i adresu nadawcy Twojej organizacji.
• Szablony rejestracyjne i marketingowe korzystają z tej samej integracji.

Kluby whitelabel mogą wyłączyć automatyczne e-maile Daily Overview dla wyzwań krokowych na poziomie organizacji (daily_email_disabled) lub dla poszczególnych wyzwań.

Aplikacja mobilna #

Standardowa aplikacja mobilna DistantRace pozostaje dostępna. Uczestnicy mogą łączyć aplikacje sportowe i synchronizować kroki przez aplikację, nawet jeśli rejestrują się na markowym portalu internetowym. Aplikacja nie jest oznaczona marką; dane konta są współdzielone między distantrace.com, aplikacją mobilną i portalem z marką.

Dostęp organizatora #

Organizatorzy i personel nadal korzystają z konsoli menedżera na distantrace.com:

• Wzór URL: /console/<org-code>/
• Wymagana dwuskładnikowa autoryzacja
• SAML może być używany do logowania personelu w klubach przedsiębiorstw, ale dostęp do konsoli jest oddzielny od przepływu OAuth portalu uczestnika

Zobacz Jak uzyskać dostęp do konsoli organizatora.

Powiązane #

• SAML dla przedsiębiorstw i logowanie whitelabel — logowanie uczestnika
• Branding klubu i obrazy główne
• Osadzone domeny dla iframe
• Przegląd publicznego API
• SendGrid