Configurazione whitelabel e aziendale

Alcuni club utilizzano DistantRace in modalità whitelabel: un portale per i partecipanti con marchio su un dominio personalizzato, collegato alla stessa console organizzativa e ai dati degli eventi su DistantRace.

Whitelabel è un'offerta gestita dalla piattaforma. DistantRace abilita il flag del club, le credenziali OAuth, le pagine di accesso a tema, l'hosting su dominio personalizzato e i provider di identità SAML. Gli organizzatori continuano a creare eventi e gestire i partecipanti nella manager console come di consueto.

Contatta il supporto DistantRace per discutere del whitelabel per la tua organizzazione.

Cosa abilita il whitelabel #

Come si integra #

flowchart LR
  subgraph portal [Portale partecipante con marchio]
    SPA[SPA dominio personalizzato]
  end
  subgraph drace [Piattaforma DistantRace]
    API["/api/v1/"]
    Auth[OAuth + accesso a tema]
    Console[Manager console]
    SAML[Scoperta SAML]
  end
  SPA -->|token org — dati pubblici| API
  SPA -->|token utente — dopo accesso| API
  SPA -->|reindirizzamento| Auth
  Auth --> SAML
  Console --> API

1. Portale partecipante — un'app web sul tuo dominio. Carica dati pubblici degli eventi con un token API limitato all'organizzazione e invia i partecipanti a DistantRace OAuth per l'accesso.
2. Autenticazione DistantRace — gestisce codici di accesso, OAuth, SAML e connessioni app sportive. I modelli a tema si applicano quando la richiesta OAuth include il contesto della tua organizzazione.
3. Manager console — gli organizzatori creano sfide, competizioni, biglietti e marketing su distantrace.com. Le modifiche appaiono sul portale con marchio tramite l'API.

Configurazione (gestita dalla piattaforma) #

DistantRace gestisce tipicamente:

Cosa configurano gli organizzatori #

Flussi di accesso del partecipante #

I portali whitelabel utilizzano comunemente il codice di autorizzazione OAuth:

1. Il partecipante clicca su Accedi sul sito con marchio.
2. Il browser reindirizza a DistantRace /oauth/authorize/ con l'UUID della tua organizzazione.
3. DistantRace mostra una pagina di accesso a tema (codice email, passkey o SAML — a seconda della configurazione del club).
4. Dopo l'autenticazione, il browser ritorna al tuo portale con un codice scambiato per token di accesso e aggiornamento.
5. Il portale chiama /api/v1/ con il token utente per azioni personali (unisciti alla sfida, sincronizza allenamenti, aggiorna profilo).

I link di invito email possono effettuare l'accesso automatico dei partecipanti tramite l'endpoint API redeem-email-token quando il portale è configurato con un token organizzativo.

Il SAML SSO è disponibile per i club aziendali. I partecipanti inseriscono un'email di lavoro; DistantRace instrada al corretto IdP per dominio. Vedi SAML aziendale e accesso whitelabel.

Credenziali API (panoramica) #

Le integrazioni whitelabel utilizzano due tipi di credenziali:

Entrambi sono creati e ruotati da DistantRace durante l'onboarding. Gli URI di reindirizzamento devono corrispondere al percorso /auth/callback del tuo portale in ogni ambiente (staging *.wl.distantrace.com e dominio personalizzato di produzione).

URL di autorizzazione OAuth #

L'accesso del partecipante inizia su /oauth/authorize/ con:

• client_id — la tua applicazione OAuth utente
• redirect_uri — callback registrato sul tuo portale
• response_type=code
• org=<club-uuid> — lega la pagina di accesso alla tua organizzazione e seleziona il modello a tema

Dopo che il partecipante si autentica (codice email, passkey o SAML), DistantRace reindirizza al tuo callback con un codice di autorizzazione. Scambialo lato server o nella SPA per token di accesso e aggiornamento.

Codici di accesso e email di invito #

Il riscatto del link magico può creare automaticamente un account dai dati precompilati del codice di accesso, restituire token OAuth e iscrivere automaticamente il partecipante in una sfida collegata quando configurato.

Mappa completa degli endpoint: Panoramica API pubblica.

Email e notifiche #

Quando SendGrid è connesso:

• Le email di codice di accesso utilizzano il modello transazionale e l'indirizzo del mittente della tua organizzazione.
• I modelli di registrazione e marketing seguono la stessa integrazione.

I club whitelabel possono sopprimere l'email automatica Panoramica giornaliera per le sfide di passi a livello di organizzazione (daily_email_disabled) o per singola sfida.

App mobile #

L'app mobile standard DistantRace rimane disponibile. I partecipanti possono connettere app sportive e sincronizzare i passi tramite l'app anche quando si registrano su un portale web con marchio. L'app non è whitelabel; i dati dell'account sono condivisi tra distantrace.com, l'app mobile e il portale con marchio.

Accesso organizzatore #

Gli organizzatori e il personale continuano a utilizzare la manager console su distantrace.com:

• Modello URL: /console/<org-code>/
• Autenticazione a due fattori è richiesta
• SAML può essere utilizzato per l'accesso del personale nei club aziendali, ma l'accesso alla console è separato dal flusso OAuth del portale partecipante

Vedi Come accedere alla console organizzativa.

Correlati #

• SAML aziendale e accesso whitelabel — accesso partecipante
• Branding del club e immagini eroe
• Domini incorporati per iframe
• Panoramica API pubblica
• SendGrid