إعداد العلامة البيضاء والمؤسسات

تقوم بعض الأندية بتشغيل DistantRace على نشر العلامة البيضاء: بوابة مشاركين ذات علامة تجارية على نطاق مخصص، متصلة بنفس وحدة التحكم الخاصة بالمنظم وبيانات الأحداث على DistantRace.

العلامة البيضاء هي عرض يدار بواسطة المنصة. يقوم DistantRace بتمكين علم النادي، بيانات اعتماد OAuth، صفحات تسجيل الدخول ذات الطابع الخاص، استضافة النطاق المخصص، ومزودي الهوية SAML. يواصل المنظمون إنشاء الأحداث وإدارة المشاركين في وحدة التحكم الخاصة بالمدير كالمعتاد.

اتصل بدعم DistantRace لمناقشة العلامة البيضاء لمؤسستك.

ما الذي تتيحه العلامة البيضاء #

القدرة	تجربة المشارك	المنظم / المنصة
نطاق مخصص	تصفح وسجل في عنوان URL لناديك (مثل events.yourcompany.com)	يتم توفير DNS + TLS بواسطة DistantRace؛ يتم التحقق من النطاق عبر تضمين النطاقات
بوابة ذات علامة تجارية	اسم النادي، الشعار، الألوان، وواجهة مستخدم محلية	يتم تكوين العلامة التجارية لـ SPA عند النشر؛ لا يزال محتوى الحدث يأتي من DistantRace
تسجيل دخول ذو طابع خاص	تتطابق صفحات تسجيل الدخول والحساب مع علامتك التجارية أثناء OAuth	قوالب domain_theme على مضيف المصادقة DistantRace
تسجيل دخول المشاركين عبر OAuth	تسجيل الدخول عبر بوابتك؛ تستمر الجلسة في المتصفح	تطبيق OAuth2 برمز التفويض مخصص لمؤسستك
رمز API الخاص بالمؤسسة	قوائم عامة (الأحداث، التحديات، اللوائح) بدون تسجيل دخول	رمز قراءة طويل الأمد للواجهة الخلفية للموقع ذو العلامة التجارية
API للصور البطل	لافتات دوارة على الصفحة الرئيسية للبوابة	علامة النادي التجارية وصور البطل — متاحة عند تمكين is_whitelabel
SAML / SSO للمؤسسات	تسجيل الدخول باستخدام البريد الإلكتروني للعمل عبر Microsoft Entra ID أو مزود هوية آخر	تعيين مزود الهوية لكل نطاق؛ الاكتشاف في /saml2/discovery/ — انظر SAML للمؤسسات وتسجيل الدخول بعلامة بيضاء
بريد إلكتروني ذو علامة تجارية	رموز تسجيل الدخول والبريد الإلكتروني للمعاملات من مرسلك	تكامل SendGrid على النادي
رموز الانضمام والدعوات	استرداد الرموز وروابط الدعوة عبر البريد الإلكتروني على الموقع ذو العلامة التجارية	نفس رموز الانضمام مثل distantrace.com؛ التسجيل التلقائي عبر رابط سحري عبر API
اتصالات تطبيقات الرياضة	ربط Garmin، Strava، مصادر الخطوات، إلخ.	تدفقات الاتصال عبر OAuth تعمل على مضيف المصادقة DistantRace القياسي، ثم تعود إلى بوابتك
REST API	إجراءات كاملة للمشاركين بعد تسجيل الدخول (الانضمام، مزامنة التدريبات، الملف الشخصي)	نفس سطح /api/v1/ مثل تطبيق الجوال — نظرة عامة على API العامة
وحدة التحكم الخاصة بالمدير	غير متاح — يستخدم المنظمون distantrace.com	غير متغير؛ لا تزال المصادقة الثنائية مطلوبة

كيف يتناسب كل شيء معًا #

flowchart LR
  subgraph portal [بوابة المشاركين ذات العلامة التجارية]
    SPA[نطاق مخصص SPA]
  end
  subgraph drace [منصة DistantRace]
    API["/api/v1/"]
    Auth[OAuth + تسجيل الدخول ذو الطابع الخاص]
    Console[وحدة التحكم الخاصة بالمدير]
    SAML[اكتشاف SAML]
  end
  SPA -->|رمز المؤسسة — بيانات عامة| API
  SPA -->|رمز المستخدم — بعد تسجيل الدخول| API
  SPA -->|إعادة توجيه| Auth
  Auth --> SAML
  Console --> API

1. بوابة المشاركين — تطبيق ويب على نطاقك. يقوم بتحميل بيانات الحدث العامة باستخدام رمز API مخصص للمؤسسة ويرسل المشاركين إلى DistantRace OAuth لتسجيل الدخول.
2. مصادقة DistantRace — تتعامل مع رموز تسجيل الدخول، OAuth، SAML، واتصالات تطبيقات الرياضة. يتم تطبيق القوالب ذات الطابع الخاص عندما يتضمن طلب OAuth سياق مؤسستك.
3. وحدة التحكم الخاصة بالمدير — ينشئ المنظمون التحديات، المسابقات، التذاكر، والتسويق على distantrace.com. تظهر التغييرات على البوابة ذات العلامة التجارية عبر API.

الإعداد (يدار بواسطة المنصة) #

عادةً ما يتولى DistantRace:

العنصر	التفاصيل
علم النادي is_whitelabel	يفتح إدارة صور البطل وAPI صور البطل
تطبيقات OAuth	عميل المستخدم (رمز التفويض) لتسجيل دخول المشاركين؛ رمز المؤسسة للقوائم العامة
domain_theme	يختار قوالب تسجيل الدخول/التسجيل ذات العلامة التجارية على مضيف المصادقة
استضافة النطاق المخصص	شهادة TLS، دخول، واسم مضيف اختبار اختياري *.wl.distantrace.com (يتطابق مع سبيكة domain_theme الخاصة بك)
مزودي الهوية SAML	سجلات SAMLIdentityProvider المعينة لنطاقات البريد الإلكتروني
نشر البوابة	بناء SPA ذو العلامة التجارية، وكيل التخزين المؤقت، وCI/CD على البنية التحتية للعلامة البيضاء

ما يقوم المنظمون بتكوينه بأنفسهم #

المهمة	أين
الأحداث، التذاكر، رموز الانضمام	وحدة التحكم الخاصة بالمدير — مثل أي نادي
صور البطل للدوار في البوابة	التسويق → صور البطل (للأندية ذات العلامة البيضاء فقط)
تضمين / نطاقات مخصصة	النادي → تضمين النطاقات — تضمين النطاقات للإطارات
مرسل البريد الإلكتروني ذو العلامة التجارية	النادي → التكاملات → SendGrid
شعار النادي	النادي → الإعدادات
تعطيل رسائل البريد الإلكتروني اليومية	إعداد على مستوى النادي أو لكل تحدي (للأندية ذات العلامة البيضاء)

تدفقات تسجيل دخول المشاركين #

تستخدم بوابات العلامة البيضاء عادةً رمز تفويض OAuth:

1. ينقر المشارك على تسجيل الدخول في الموقع ذو العلامة التجارية.
2. يعيد المتصفح التوجيه إلى DistantRace /oauth/authorize/ مع UUID الخاص بمؤسستك.
3. يعرض DistantRace صفحة تسجيل دخول ذات طابع خاص (رمز البريد الإلكتروني، مفتاح المرور، أو SAML — اعتمادًا على تكوين النادي).
4. بعد المصادقة، يعود المتصفح إلى بوابتك برمز يتم تبادله مقابل رموز الوصول والتحديث.
5. يستدعي البوابة /api/v1/ برمز المستخدم للإجراءات الشخصية (الانضمام إلى التحدي، مزامنة التدريبات، تحديث الملف الشخصي).

يمكن أن تقوم روابط الدعوة عبر البريد الإلكتروني بتسجيل المشاركين تلقائيًا عبر نقطة نهاية API redeem-email-token عندما يتم تكوين البوابة برمز المؤسسة.

يتوفر SAML SSO للأندية المؤسسية. يدخل المشاركون بريدًا إلكترونيًا للعمل؛ يقوم DistantRace بتوجيههم إلى مزود الهوية الصحيح حسب النطاق. انظر SAML للمؤسسات وتسجيل الدخول بعلامة بيضاء.

بيانات اعتماد API (نظرة عامة) #

تستخدم تكاملات العلامة البيضاء نوعين من بيانات الاعتماد:

بيانات الاعتماد	المنحة / النوع	الاستخدام النموذجي
رمز المؤسسة	رمز حامل طويل الأمد (مستخدم مسؤول المؤسسة)	قوائم التحديات/الأحداث العامة، صور البطل، التحقق من رموز الانضمام، استرداد رموز البريد الإلكتروني
عميل OAuth للمستخدم	رمز التفويض (+ رمز التحديث)	تسجيل دخول المشاركين، الانضمام إلى الأحداث، التدريبات، الملف الشخصي، الدفع

يتم إنشاء كلاهما وتدويرهما بواسطة DistantRace أثناء الإعداد. يجب أن تتطابق عناوين URI لإعادة التوجيه مع مسار /auth/callback الخاص ببوابتك في كل بيئة (اختبار *.wl.distantrace.com والنطاق المخصص للإنتاج).

عنوان URL لتفويض OAuth #

يبدأ تسجيل دخول المشاركين في /oauth/authorize/ مع:

• client_id — تطبيق OAuth الخاص بمستخدمك
• redirect_uri — رد مسجل في بوابتك
• response_type=code
• org=<club-uuid> — يربط صفحة تسجيل الدخول بمؤسستك ويختار القالب ذو الطابع الخاص

بعد أن يقوم المشارك بالمصادقة (رمز البريد الإلكتروني، مفتاح المرور، أو SAML)، يقوم DistantRace بإعادة التوجيه إلى ردك مع رمز تفويض. قم بتبادله على الجانب الخادم أو في SPA مقابل رموز الوصول والتحديث.

رموز الانضمام ورسائل الدعوة #

الخطوة	API
تحقق من رمز قبل عرض الدفع	GET /api/v1/event/joincode/{code}/validate/ (رمز المؤسسة)
استرداد رابط البريد الإلكتروني السحري	POST /api/v1/event/joincode/redeem-email-token/ مع { "token": "…" }
إنشاء رموز من مكتبك الخلفي	POST /api/v1/event/joincode/ (رمز مستخدم المسؤول — ليس رمز المؤسسة العامة)

يمكن أن يؤدي استرداد الرابط السحري إلى إنشاء حساب تلقائيًا من بيانات الملء المسبق لرمز الانضمام، وإرجاع رموز OAuth، وتسجيل المشارك تلقائيًا في التحدي المرتبط عند تكوينه.

خريطة نقطة النهاية الكاملة: نظرة عامة على API العامة.

البريد الإلكتروني والإشعارات #

عند الاتصال بـ SendGrid:

• تستخدم رسائل رمز تسجيل الدخول البريد الإلكتروني قالب المعاملات وعنوان المرسل الخاص بمنظمتك.
• تتبع قوالب التسجيل والتسويق نفس التكامل.

يمكن للأندية ذات العلامة البيضاء قمع البريد الإلكتروني الآلي نظرة عامة يومية لتحديات الخطوات على مستوى المنظمة (daily_email_disabled) أو لكل تحدي.

تطبيق الجوال #

لا يزال تطبيق DistantRace للجوال القياسي متاحًا. يمكن للمشاركين ربط تطبيقات الرياضة ومزامنة الخطوات عبر التطبيق حتى عند التسجيل على بوابة ويب ذات علامة تجارية. التطبيق ليس بعلامة بيضاء؛ يتم مشاركة بيانات الحساب عبر distantrace.com، وتطبيق الجوال، والبوابة ذات العلامة التجارية.

وصول المنظم #

يواصل المنظمون والموظفون استخدام وحدة التحكم الخاصة بالمدير على distantrace.com:

• نمط URL: /console/<org-code>/
• المصادقة الثنائية مطلوبة
• يمكن استخدام SAML لتسجيل دخول الموظفين في الأندية المؤسسية، ولكن الوصول إلى وحدة التحكم منفصل عن تدفق OAuth لبوابة المشاركين

انظر كيفية الوصول إلى وحدة التحكم الخاصة بالمنظم.

ذات صلة #

• SAML للمؤسسات وتسجيل الدخول بعلامة بيضاء — تسجيل دخول المشاركين
• علامة النادي التجارية وصور البطل
• تضمين النطاقات للإطارات
• نظرة عامة على API العامة
• SendGrid