Opsætning af whitelabel og virksomhedsløsninger

Nogle klubber bruger DistantRace som en whitelabel-løsning: en brandet deltagerportal på et brugerdefineret domæne, som er forbundet med den samme arrangørkonsol og de samme eventdata i DistantRace.

Whitelabel er et platformsadministreret tilbud. DistantRace aktiverer klubflaget, OAuth-legitimationsoplysninger, tematiserede loginsider, hosting på det brugerdefinerede domæne og SAML-identitetsudbydere. Arrangører fortsætter som normalt med at oprette events og administrere deltagere i managerkonsollen.

Kontakt DistantRace-support for at drøfte en whitelabel-løsning til din organisation.

Hvad whitelabel muliggør #

Sådan hænger det sammen #

flowchart LR
  subgraph portal [Brandet deltagerportal]
    SPA[SPA på brugerdefineret domæne]
  end
  subgraph drace [DistantRace-platform]
    API["/api/v1/"]
    Auth[OAuth + tematiseret login]
    Console[Managerkonsol]
    SAML[SAML-registrering]
  end
  SPA -->|organisationstoken — offentlige data| API
  SPA -->|brugertoken — efter login| API
  SPA -->|viderestilling| Auth
  Auth --> SAML
  Console --> API

1. Deltagerportal — en webapp på jeres domæne. Den indlæser offentlige eventdata med et API-token, der er afgrænset til organisationen, og sender deltagere til DistantRace OAuth for login.
2. DistantRace-autentificering — håndterer loginkoder, OAuth, SAML og forbindelser til sportsapps. De tematiserede skabeloner anvendes, når OAuth-anmodningen indeholder jeres organisationskontekst.
3. Managerkonsol — arrangører opretter udfordringer, konkurrencer, billetter og marketing på distantrace.com. Ændringer vises i den brandede portal gennem API'et.

Opsætning (administreret af platformen) #

DistantRace håndterer typisk:

Hvad arrangørerne selv konfigurerer #

Forløb for deltagerlogin #

Whitelabel-portaler bruger normalt OAuth-autorisationskode:

1. Deltageren klikker på Sign in på den brandede hjemmeside.
2. Browseren viderestiller til DistantRace /oauth/authorize/ med jeres organisations UUID.
3. DistantRace viser en tematiseret loginside (e-mailkode, adgangsnøgle eller SAML — afhængigt af klubbens konfiguration).
4. Efter godkendelsen vender browseren tilbage til jeres portal med en kode, der udveksles til adgangs- og opdateringstokens.
5. Portalen kalder /api/v1/ med brugertokenet til personlige handlinger (tilmelding til udfordringer, synkronisering af træningspas og opdatering af profil).

Invitationslinks i e-mails kan automatisk logge deltagere ind via API-endepunktet redeem-email-token, når portalen er konfigureret med et organisationstoken.

SAML SSO er tilgængelig for virksomhedsklubber. Deltagerne indtaster en arbejds-e-mail, og DistantRace sender dem til den korrekte IdP ud fra domænet. Se SAML til virksomheder og whitelabel-login.

API-legitimationsoplysninger (oversigt) #

Whitelabel-integrationer bruger to typer legitimationsoplysninger:

DistantRace opretter og roterer begge under onboardingen. Omdirigerings-URI'er skal matche portalens sti /auth/callback i hvert miljø (testmiljøet *.wl.distantrace.com og det brugerdefinerede produktionsdomæne).

URL til OAuth-godkendelse #

Deltagerlogin starter på /oauth/authorize/ med:

• client_id — jeres OAuth-applikation til brugere
• redirect_uri — registreret callback på jeres portal
• response_type=code
• org=<club-uuid> — knytter loginssiden til jeres organisation og vælger den tematiserede skabelon

Når deltageren er godkendt (e-mailkode, adgangsnøgle eller SAML), viderestiller DistantRace til jeres callback med en autorisationskode. Udveksl den på serversiden eller i SPA'en til adgangs- og opdateringstokens.

Tilmeldingskoder og invitationsmails #

Indløsning af et magic link kan automatisk oprette en konto ud fra forudfyldte data fra tilmeldingskoden, returnere OAuth-tokens og automatisk tilmelde deltageren til en tilknyttet udfordring, når det er konfigureret.

Komplet oversigt over endepunkter: Oversigt over det offentlige API.

Skærmbilleder med udfordringsresultater #

Whitelabel-portaler kan bygge udfordringsranglister og detaljerede resultatvisninger ud fra API-svar, der er tilpasset den aktuelle anmoder. Start med result-settings/ for at finde de konfigurerede kolonner og valgfrie visninger, og indlæs derefter varmekort, deltagerstatistik, aktivitetstidslinjer og tilladt sensoranalyse efter behov.

Resultat-API'erne håndhæver arrangørens privatlivsindstillinger og returnerer placeringsnormaliserede ruteformer til aktivitetsminiaturer i stedet for absolutte GPS-spor. Se API til udfordringsresultater for rækkefølgen af endepunkter, pagineringsparametre, oversigt over nyttedata og adgangsregler.

E-mail og notifikationer #

Når SendGrid er forbundet:

• E-mails med loginkode bruger jeres organisations transaktionsskabelon og afsenderadresse.
• Registrerings- og marketingskabeloner følger den samme integration.

Whitelabel-klubber kan deaktivere den automatiske e-mail Daily Overview for skridtudfordringer på organisationsniveau (daily_email_disabled) eller pr. udfordring.

Mobilapp #

Den almindelige DistantRace-mobilapp er fortsat tilgængelig. Deltagerne kan forbinde sportsapps og synkronisere skridt gennem appen, selv om de registrerer sig på en brandet webportal. Appen er ikke en whitelabel-app; kontodata deles mellem distantrace.com, mobilappen og den brandede portal.

Arrangøradgang #

Arrangører og medarbejdere fortsætter med at bruge managerkonsollen på distantrace.com:

• URL-mønster: /console/<org-code>/
• Tofaktorgodkendelse er påkrævet
• SAML kan bruges til medarbejderlogin i virksomhedsklubber, men konsoladgangen er adskilt fra OAuth-forløbet i deltagerportalen

Se Sådan får du adgang til arrangørkonsollen.

Relateret #

• SAML til virksomheder og whitelabel-login — deltagerlogin
• Klubbranding og hero-billeder
• Domæner til indlejring i iframes
• Oversigt over det offentlige API
• API til udfordringsresultater
• SendGrid