Configuration en marque blanche et pour les entreprises

Certains clubs utilisent DistantRace en déploiement marque blanche : un portail de participants de marque sur un domaine personnalisé, connecté à la même console d'organisateur et aux données d'événements sur DistantRace.

La marque blanche est une offre gérée par la plateforme. DistantRace active le drapeau du club, les identifiants OAuth, les pages de connexion thématiques, l'hébergement de domaine personnalisé et les fournisseurs d'identité SAML. Les organisateurs continuent de créer des événements et de gérer les participants dans la console de gestion comme d'habitude.

Contactez le support de DistantRace pour discuter de la marque blanche pour votre organisation.

Ce que permet la marque blanche #

Comment cela s'articule #

flowchart LR
  subgraph portal [Portail de participants de marque]
    SPA[Domaine personnalisé SPA]
  end
  subgraph drace [Plateforme DistantRace]
    API["/api/v1/"]
    Auth[OAuth + connexion thématique]
    Console[Console de gestion]
    SAML[Découverte SAML]
  end
  SPA -->|jeton org — données publiques| API
  SPA -->|jeton utilisateur — après connexion| API
  SPA -->|redirection| Auth
  Auth --> SAML
  Console --> API

1. Portail des participants — une application web sur votre domaine. Elle charge les données publiques des événements avec un jeton API limité à l'organisation et envoie les participants à l'OAuth de DistantRace pour la connexion.
2. Authentification DistantRace — gère les codes de connexion, OAuth, SAML et les connexions d'applications sportives. Les modèles thématiques s'appliquent lorsque la requête OAuth inclut le contexte de votre organisation.
3. Console de gestion — les organisateurs créent des défis, des compétitions, des billets et du marketing sur distantrace.com. Les modifications apparaissent sur le portail de marque via l'API.

Configuration (gérée par la plateforme) #

DistantRace gère généralement :

Ce que les organisateurs configurent eux-mêmes #

Flux de connexion des participants #

Les portails en marque blanche utilisent couramment le code d'autorisation OAuth :

1. Le participant clique sur Se connecter sur le site de marque.
2. Le navigateur redirige vers DistantRace /oauth/authorize/ avec l'UUID de votre organisation.
3. DistantRace affiche une page de connexion thématique (code email, clé d'accès ou SAML — selon la configuration du club).
4. Après authentification, le navigateur retourne à votre portail avec un code échangé contre des jetons d'accès et de rafraîchissement.
5. Le portail appelle /api/v1/ avec le jeton utilisateur pour des actions personnelles (rejoindre un défi, synchroniser les entraînements, mettre à jour le profil).

Les liens d'invitation par email peuvent connecter automatiquement les participants via le point de terminaison API redeem-email-token lorsque le portail est configuré avec un jeton d'organisation.

Le SSO SAML est disponible pour les clubs d'entreprise. Les participants saisissent un email professionnel ; DistantRace dirige vers le bon IdP par domaine. Voir SAML d'entreprise et connexion en marque blanche.

Identifiants API (aperçu) #

Les intégrations en marque blanche utilisent deux types d'identifiants :

Les deux sont créés et tournés par DistantRace lors de l'intégration. Les URI de redirection doivent correspondre au chemin /auth/callback de votre portail dans chaque environnement (mise en scène *.wl.distantrace.com et domaine personnalisé de production).

URL d'autorisation OAuth #

La connexion du participant commence à /oauth/authorize/ avec :

• client_id — votre application utilisateur OAuth
• redirect_uri — rappel enregistré sur votre portail
• response_type=code
• org=<club-uuid> — lie la page de connexion à votre organisation et sélectionne le modèle thématique

Après l'authentification du participant (code email, clé d'accès ou SAML), DistantRace redirige vers votre rappel avec un code d'autorisation. Échangez-le côté serveur ou dans le SPA contre des jetons d'accès et de rafraîchissement.

Codes d'adhésion et emails d'invitation #

L'échange de lien magique peut créer automatiquement un compte à partir des données pré-remplies du code d'adhésion, retourner des jetons OAuth et inscrire automatiquement le participant dans un défi lié lorsqu'il est configuré.

Carte complète des points de terminaison : Aperçu de l'API publique.

Email et notifications #

Lorsque SendGrid est connecté :

• Les emails de code de connexion utilisent le modèle transactionnel et l'adresse de l'expéditeur de votre organisation.
• Les modèles d'inscription et de marketing suivent la même intégration.

Les clubs en marque blanche peuvent supprimer l'email automatisé Daily Overview pour les défis de pas au niveau de l'organisation (daily_email_disabled) ou par défi.

Application mobile #

L'application mobile DistantRace standard reste disponible. Les participants peuvent connecter des applications sportives et synchroniser les pas via l'application même lorsqu'ils s'inscrivent sur un portail web de marque. L'application n'est pas en marque blanche ; les données de compte sont partagées entre distantrace.com, l'application mobile et le portail de marque.

Accès des organisateurs #

Les organisateurs et le personnel continuent d'utiliser la console de gestion sur distantrace.com :

• Modèle d'URL : /console/<org-code>/
• Authentification à deux facteurs est requise
• SAML peut être utilisé pour la connexion du personnel dans les clubs d'entreprise, mais l'accès à la console est séparé du flux OAuth du portail des participants

Voir Comment accéder à la console de gestion.

Connexes #

• SAML d'entreprise et connexion en marque blanche — connexion du participant
• Branding du club et images héroïques
• Domaines intégrés pour iframes
• Aperçu de l'API publique
• SendGrid