Accesso SAML aziendale e whitelabel
Accesso SAML aziendale e whitelabel
Alcuni club operano su un'implementazione whitelabel di DistantRace — un sito web con marchio su un dominio personalizzato con single sign-on (SSO) aziendale tramite SAML (comunemente Microsoft Entra ID / Azure AD), o accesso basato su OAuth tramite DistantRace.
A chi si applica #
- Club aziendali o federativi con whitelabel abilitato
- Partecipanti che devono utilizzare un dominio di email di lavoro (per SAML)
- Organizzazioni che indirizzano l'accesso tramite un portale con marchio invece di distantrace.com
Gli utenti standard di distantrace.com utilizzano Opzioni di accesso (email, Google, Apple, chiave di accesso).
Portale dei partecipanti con marchio #
Su un sito whitelabel, in genere:
- Apri l'URL con marchio del tuo club (non distantrace.com).
- Sfoglia le sfide e gli eventi pubblicati senza effettuare l'accesso.
- Clicca su Accedi quando vuoi partecipare, sincronizzare gli allenamenti o gestire il tuo profilo.
L'accesso reindirizza a DistantRace OAuth con l'UUID della tua organizzazione nell'URL di autorizzazione. Le pagine di accesso utilizzano i modelli tematizzati del tuo club (logo, colori, testo) quando il club ha un domain_theme non predefinito. Dopo l'autenticazione, torni al sito con marchio, già connesso.
DistantRace risolve il branding da:
- Flag di sessione impostati durante un accesso tematizzato sul tuo portale
- Dominio incorporato verificato — l'host nel tuo URL del portale o nel link
nextdi OAuth mappa il tuo club tramite Domini incorporati
Cosa mostra il portale — classifiche, risultati delle squadre, checkout delle competizioni, cronologia degli allenamenti — dipende da come è configurato il portale del tuo club. Le regole degli eventi e la registrazione provengono comunque dalle impostazioni di DistantRace dell'organizzatore.
Panoramica per gli organizzatori: Impostazione whitelabel e aziendale.
SAML / SSO aziendale #
Per i club con SAML configurato:
- Apri l'URL con marchio del club o un link diretto all'evento.
- Clicca su Accedi con account di lavoro / accesso organizzativo (o inizia da un punto di ingresso compatibile con SAML).
- Inserisci la tua email di lavoro se richiesto — DistantRace ti indirizza al provider di identità corretto in base al dominio email (
/saml2/discovery/). - Completa l'autenticazione sul portale Microsoft della tua azienda (o IdP configurato).
- Torna a DistantRace connesso — registrati agli eventi come di consueto.
Se il tuo dominio non è configurato, vedrai un errore che ti chiede di contattare il tuo amministratore IT.
Più provider di identità #
Quando esistono diversi provider SAML, la pagina di scoperta abbina il tuo dominio email al giusto IdP prima di reindirizzare a /saml2/login/?idp=….
Se è configurato un solo IdP, la scoperta salta il modulo e ti invia direttamente al login.
Errori di scoperta #
| Messaggio | Significato |
|---|---|
| Inserisci un'email di lavoro valida | Indirizzo mancante o malformato |
| Non abbiamo configurato il Single Sign-On per questo dominio | Il tuo team IT non ha registrato quel dominio email con DistantRace |
Contatta l'amministratore del tuo club o l'IT se il tuo dominio dovrebbe essere supportato.
Altri metodi di accesso su whitelabel #
A seconda della configurazione del club, le pagine di accesso tematizzate possono anche offrire:
| Metodo | Note |
|---|---|
| Codice di accesso via email | Codice monouso inviato alla tua casella di posta; utilizza il mittente SendGrid del tuo club quando configurato |
| Chiave di accesso (WebAuthn) | Accesso senza password se hai registrato una chiave di accesso in una visita precedente |
| OAuth (codice di autorizzazione) | Flusso predefinito per portali web con marchio — il browser reindirizza tramite DistantRace e ritorna |
Le connessioni delle app sportive (Garmin, Strava, fonti di passi) si aprono sull'host di autenticazione canonico di DistantRace per i reindirizzamenti del provider OAuth. Un token di ritorno sociale firmato nell'URL ti riporta al portale con marchio con lo stesso tema, anche se l'OAuth del provider funziona su distantrace.com.
Branding whitelabel #
I club whitelabel possono mostrare:
- Logo e colori del club sulle pagine di accesso e account
- Immagini eroiche personalizzate sul portale pubblico
- Email transazionali con marchio (codici di accesso, inviti) tramite SendGrid
L'impostazione degli organizzatori per domini, SAML e hosting del portale è gestita dalla piattaforma — contatta DistantRace per abilitare il whitelabel per la tua organizzazione.
Organizzatori nei club whitelabel #
L'accesso alla console di gestione richiede ancora Autenticazione a due fattori. SSO o OAuth gestiscono l'accesso dei partecipanti sul sito con marchio; 2FA è un passaggio di sicurezza separato per le viste /console/ su distantrace.com.
Accesso API #
Le organizzazioni whitelabel possono utilizzare l'API REST con credenziali a livello di organizzazione — vedi Panoramica API pubblica.