Connexion SAML d'entreprise et marque blanche
Connexion SAML d'entreprise et marque blanche
Certains clubs fonctionnent sur un déploiement DistantRace en marque blanche — un site web personnalisé sur un domaine spécifique avec une authentification unique d'entreprise (SSO) via SAML (généralement Microsoft Entra ID / Azure AD), ou une connexion basée sur OAuth via DistantRace.
À qui cela s'applique #
- Clubs d'entreprise ou fédérations avec la marque blanche activée
- Participants censés utiliser un domaine email professionnel (pour SAML)
- Organisations qui redirigent la connexion via un portail personnalisé au lieu de distantrace.com
Les utilisateurs standard de distantrace.com utilisent les Options de connexion (email, Google, Apple, clé d'accès).
Portail de participants personnalisé #
Sur un site en marque blanche, vous :
- Ouvrez l'URL personnalisée de votre club (pas distantrace.com).
- Parcourez les défis et événements publiés sans vous connecter.
- Cliquez sur Se connecter lorsque vous souhaitez rejoindre, synchroniser des entraînements ou gérer votre profil.
La connexion redirige vers DistantRace OAuth avec l'UUID de votre organisation dans l'URL d'autorisation. Les pages de connexion utilisent les modèles thématisés de votre club (logo, couleurs, texte) lorsque le club a un domain_theme non par défaut. Après authentification, vous revenez sur le site personnalisé, déjà connecté.
DistantRace résout la personnalisation à partir de :
- Indicateurs de session définis lors d'une connexion thématisée sur votre portail
- Domaine intégré vérifié — l'hôte dans l'URL de votre portail ou le lien
nextOAuth est associé à votre club via Domaines intégrés
Ce que le portail affiche — classements, résultats d'équipe, paiement des compétitions, historique des entraînements — dépend de la configuration du portail de votre club. Les règles et l'inscription aux événements proviennent toujours des paramètres DistantRace de l'organisateur.
Aperçu pour les organisateurs : Configuration marque blanche et entreprise.
SAML / SSO d'entreprise #
Pour les clubs avec SAML configuré :
- Ouvrez l'URL personnalisée du club ou un lien direct vers un événement.
- Cliquez sur Se connecter avec un compte professionnel / connexion organisationnelle (ou commencez à partir d'un point d'entrée compatible SAML).
- Entrez votre email professionnel si demandé — DistantRace vous redirige vers le bon fournisseur d'identité par domaine email (
/saml2/discovery/). - Complétez l'authentification sur le portail Microsoft de votre entreprise (ou IdP configuré).
- Revenez à DistantRace connecté — inscrivez-vous aux événements comme d'habitude.
Si votre domaine n'est pas configuré, vous voyez une erreur vous demandant de contacter votre administrateur informatique.
Plusieurs fournisseurs d'identité #
Lorsque plusieurs fournisseurs SAML existent, la page de découverte associe votre domaine email au bon IdP avant de rediriger vers /saml2/login/?idp=….
Si un seul IdP est configuré, la découverte saute le formulaire et vous envoie directement à la connexion.
Erreurs de découverte #
| Message | Signification |
|---|---|
| Entrez un email professionnel valide | Adresse manquante ou mal formée |
| Nous n'avons pas configuré l'authentification unique pour ce domaine | Votre équipe informatique n'a pas enregistré ce domaine email avec DistantRace |
Contactez votre administrateur de club ou informatique si votre domaine devrait être pris en charge.
Autres méthodes de connexion en marque blanche #
Selon la configuration du club, les pages de connexion thématisées peuvent également proposer :
| Méthode | Remarques |
|---|---|
| Code de connexion par email | Code à usage unique envoyé à votre boîte de réception ; utilise l'expéditeur SendGrid de votre club lorsqu'il est configuré |
| Clé d'accès (WebAuthn) | Connexion sans mot de passe si vous avez enregistré une clé d'accès lors d'une visite précédente |
| OAuth (code d'autorisation) | Flux par défaut pour les portails web personnalisés — le navigateur redirige via DistantRace et revient |
Les connexions aux applications sportives (Garmin, Strava, sources de pas) s'ouvrent sur l'hôte d'authentification DistantRace canonique pour les redirections des fournisseurs OAuth. Un jeton de retour social signé dans l'URL vous ramène au portail personnalisé avec le même thème, même si l'OAuth du fournisseur fonctionne sur distantrace.com.
Personnalisation en marque blanche #
Les clubs en marque blanche peuvent afficher :
- Logo et couleurs du club sur les pages de connexion et de compte
- Images personnalisées sur le portail public
- Emails transactionnels personnalisés (codes de connexion, invitations) via SendGrid
La configuration des organisateurs pour les domaines, SAML et l'hébergement du portail est gérée par la plateforme — contactez DistantRace pour activer la marque blanche pour votre organisation.
Organisateurs dans les clubs en marque blanche #
L'accès à la console de gestion nécessite toujours l'authentification à deux facteurs. SSO ou OAuth gère la connexion des participants sur le site personnalisé ; 2FA est une étape de sécurité distincte pour les vues /console/ sur distantrace.com.
Accès API #
Les organisations en marque blanche peuvent utiliser l'API REST avec des identifiants à portée organisationnelle — voir Aperçu de l'API publique.