---
title: Accesso SAML aziendale e whitelabel
description: Accedi a un portale del club con marchio tramite SSO, OAuth o codici
  di accesso via email
order: 57
source_hash: e9db77099340
slug: 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](sign-in-options.md) (email, Google, Apple, chiave di accesso).

## Portale dei partecipanti con marchio

Su un sito whitelabel, in genere:

1. Apri l'**URL con marchio del tuo club** (non distantrace.com).
2. Sfoglia le sfide e gli eventi pubblicati senza effettuare l'accesso.
3. 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:

1. **Flag di sessione** impostati durante un accesso tematizzato sul tuo portale
2. **Dominio incorporato verificato** — l'host nel tuo URL del portale o nel link `next` di OAuth mappa il tuo club tramite [Domini incorporati](../running-events/embed-domains-for-iframes.md)

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](../running-events/whitelabel-and-enterprise-setup.md).

## SAML / SSO aziendale

Per i club con SAML configurato:

1. Apri l'URL con marchio del club o un link diretto all'evento.
2. Clicca su **Accedi con account di lavoro** / accesso organizzativo (o inizia da un punto di ingresso compatibile con SAML).
3. Inserisci la tua **email di lavoro** se richiesto — DistantRace ti indirizza al provider di identità corretto in base al dominio email (`/saml2/discovery/`).
4. Completa l'autenticazione sul portale Microsoft della tua azienda (o IdP configurato).
5. 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](../integrations/sendgrid.md) 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](two-factor-authentication.md). 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](../more-tools/public-api-overview.md).

## Correlati

- [Impostazione whitelabel e aziendale](../running-events/whitelabel-and-enterprise-setup.md)
- [Branding del club e immagini eroiche](../running-events/club-branding-and-hero-images.md)
- [Opzioni di accesso](sign-in-options.md)
- [Link di invito via email](email-invitation-links.md)