---
title: إعداد العلامة البيضاء والمؤسسات
description: النطاقات المخصصة، البوابات ذات العلامات التجارية، SAML SSO، والوصول إلى
  API للأندية المؤسسية
order: 86
source_hash: 2cf29b121add
---

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

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

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

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

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

| القدرة | تجربة المشارك | المنظم / المنصة |
|------------|------------------------|----------------------|
| **نطاق مخصص** | تصفح وسجل في عنوان URL لناديك (مثل `events.yourcompany.com`) | يتم توفير DNS + TLS بواسطة DistantRace؛ يتم التحقق من النطاق عبر [تضمين النطاقات](embed-domains-for-iframes.md) |
| **بوابة ذات علامة تجارية** | اسم النادي، الشعار، الألوان، وواجهة مستخدم محلية | يتم تكوين العلامة التجارية لـ SPA عند النشر؛ لا يزال محتوى الحدث يأتي من DistantRace |
| **تسجيل دخول ذو طابع خاص** | تتطابق صفحات تسجيل الدخول والحساب مع علامتك التجارية أثناء OAuth | قوالب `domain_theme` على مضيف المصادقة DistantRace |
| **تسجيل دخول المشاركين عبر OAuth** | تسجيل الدخول عبر بوابتك؛ تستمر الجلسة في المتصفح | تطبيق OAuth2 برمز التفويض مخصص لمؤسستك |
| **رمز API الخاص بالمؤسسة** | قوائم عامة (الأحداث، التحديات، اللوائح) بدون تسجيل دخول | رمز قراءة طويل الأمد للواجهة الخلفية للموقع ذو العلامة التجارية |
| **API للصور البطل** | لافتات دوارة على الصفحة الرئيسية للبوابة | [علامة النادي التجارية وصور البطل](club-branding-and-hero-images.md) — متاحة عند تمكين `is_whitelabel` |
| **SAML / SSO للمؤسسات** | تسجيل الدخول باستخدام البريد الإلكتروني للعمل عبر Microsoft Entra ID أو مزود هوية آخر | تعيين مزود الهوية لكل نطاق؛ الاكتشاف في `/saml2/discovery/` — انظر [SAML للمؤسسات وتسجيل الدخول بعلامة بيضاء](../joining-events/enterprise-saml-and-whitelabel-login.md) |
| **بريد إلكتروني ذو علامة تجارية** | رموز تسجيل الدخول والبريد الإلكتروني للمعاملات من مرسلك | تكامل [SendGrid](../integrations/sendgrid.md) على النادي |
| **رموز الانضمام والدعوات** | استرداد الرموز وروابط الدعوة عبر البريد الإلكتروني على الموقع ذو العلامة التجارية | نفس رموز الانضمام مثل distantrace.com؛ التسجيل التلقائي عبر رابط سحري عبر API |
| **اتصالات تطبيقات الرياضة** | ربط Garmin، Strava، مصادر الخطوات، إلخ. | تدفقات الاتصال عبر OAuth تعمل على مضيف المصادقة DistantRace القياسي، ثم تعود إلى بوابتك |
| **REST API** | إجراءات كاملة للمشاركين بعد تسجيل الدخول (الانضمام، مزامنة التدريبات، الملف الشخصي) | نفس سطح `/api/v1/` مثل تطبيق الجوال — [نظرة عامة على API العامة](../more-tools/public-api-overview.md) |
| **وحدة التحكم الخاصة بالمدير** | غير متاح — يستخدم المنظمون distantrace.com | غير متغير؛ لا تزال [المصادقة الثنائية](../joining-events/two-factor-authentication.md) مطلوبة |

::: note نطاق المنصة مقابل البوابة
بوابة المشاركين ذات العلامة البيضاء هي واجهة أمامية مركزة فوق API DistantRace. يعتمد ما يتم عرضه من شاشات (التحديات فقط، المسابقات مع الدفع، لوائح الفريق، إلخ.) على النشر. يتم تكوين جميع أنواع الأحداث والإعدادات الأساسية في وحدة التحكم الخاصة بالمدير.
:::

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

```mermaid
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 على البنية التحتية للعلامة البيضاء |

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

| المهمة | أين |
|------|-------|
| الأحداث، التذاكر، رموز الانضمام | وحدة التحكم الخاصة بالمدير — مثل أي نادي |
| صور البطل للدوار في البوابة | التسويق → **صور البطل** (للأندية ذات العلامة البيضاء فقط) |
| تضمين / نطاقات مخصصة | النادي → **تضمين النطاقات** — [تضمين النطاقات للإطارات](embed-domains-for-iframes.md) |
| مرسل البريد الإلكتروني ذو العلامة التجارية | النادي → التكاملات → [SendGrid](../integrations/sendgrid.md) |
| شعار النادي | النادي → الإعدادات |
| تعطيل رسائل البريد الإلكتروني اليومية | إعداد على مستوى النادي أو لكل تحدي (للأندية ذات العلامة البيضاء) |

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

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

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

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

يتوفر **SAML SSO** للأندية المؤسسية. يدخل المشاركون بريدًا إلكترونيًا للعمل؛ يقوم DistantRace بتوجيههم إلى مزود الهوية الصحيح حسب النطاق. انظر [SAML للمؤسسات وتسجيل الدخول بعلامة بيضاء](../joining-events/enterprise-saml-and-whitelabel-login.md).

## بيانات اعتماد 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 العامة](../more-tools/public-api-overview.md).

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

عند الاتصال بـ [SendGrid](../integrations/sendgrid.md):

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

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

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

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

## وصول المنظم

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

- نمط URL: `/console/<org-code>/`
- [المصادقة الثنائية](../joining-events/two-factor-authentication.md) مطلوبة
- يمكن استخدام SAML لتسجيل دخول الموظفين في الأندية المؤسسية، ولكن الوصول إلى وحدة التحكم منفصل عن تدفق OAuth لبوابة المشاركين

انظر [كيفية الوصول إلى وحدة التحكم الخاصة بالمنظم](access-the-organizer-console.md).

## ذات صلة

- [SAML للمؤسسات وتسجيل الدخول بعلامة بيضاء](../joining-events/enterprise-saml-and-whitelabel-login.md) — تسجيل دخول المشاركين
- [علامة النادي التجارية وصور البطل](club-branding-and-hero-images.md)
- [تضمين النطاقات للإطارات](embed-domains-for-iframes.md)
- [نظرة عامة على API العامة](../more-tools/public-api-overview.md)
- [SendGrid](../integrations/sendgrid.md)