> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# صفحات تسجيل الدخول المخصّصة: العلامة التجارية والنطاق المخصص

> خصّص صفحات تسجيل الدخول المستضافة من Didit ورسائل بريدها بعلامتك التجارية: نصوص بخمس لغات، وروابط الشروط والخصوصية، ونطاق تسجيل دخول خاص بك.

وتستخدم صفحات تسجيل الدخول المستضافة في Didit Authentication ورسائل تسجيل الدخول الإلكترونية نفس العلامة التجارية المستخدمة في سير عمل التحقق الخاص بك.
يمكنك ضبط نصوص الصفحة والروابط القانونية الخاصة بـ Authentication، ويمكنك أيضاً نقل تسجيل الدخول إلى نطاقك الخاص، مثل `auth.example.com`.

أدِر ذلك في Business Console ضمن **Authentication > Branding and emails**، حيث تعرض الصفحة معاينة مباشرة لصفحة تسجيل الدخول المستضافة في الوضعين الفاتح والداكن.

![صفحة Branding and emails في Didit Business Console لتطبيق في البيئة التجريبية، وتعرض العلامة التجارية من Customization ونصوص الصفحة ومعاينة الصفحة المستضافة](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

Authentication > Branding and emails، مع معاينة الصفحة المستضافة.

## علامتك التجارية

يُستمد الشعار ولون العلامة التجارية والخلفية ونصف قطر الزوايا والخط من إعدادات **Customization** في تطبيقك داخل وحدة التحكم، وتتبعها الصفحات المستضافة ورسائل البريد الإلكتروني.
اختر **Edit in Customization** لتغييرها: يؤدي أي تعديل إلى تحديث مسار التحقق وصفحات تسجيل الدخول معاً.

* تتبع الصفحات الوضع الفاتح أو الوضع الداكن على جهاز الشخص، ويُكيَّف لون العلامة التجارية ليناسب الخلفيات الداكنة.
* تعرض الصفحات اسم تطبيقك.
* في الخطة Free، تعرض الصفحات المستضافة شارة **Secured by Didit**.

![صفحة تسجيل الدخول المستضافة من Didit لتطبيق في البيئة التجريبية بالوضعين الفاتح والداكن، مع زر مفتاح المرور وحقلي البريد الإلكتروني وكلمة المرور](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

تتبع صفحة تسجيل الدخول المستضافة الوضع الفاتح أو الوضع الداكن على جهاز الشخص.

## نصوص الصفحات والروابط القانونية

| الحقل | الحد | مكان الظهور |
| - | - | - |
| **عنوان تسجيل الدخول** | 120 حرفاً | عنوان صفحة تسجيل الدخول. |
| **العنوان الفرعي** | 160 حرفاً | السطر الذي يظهر أسفل العنوان. |
| **عنوان التسجيل** | 120 حرفاً | عنوان صفحة إنشاء الحساب. |
| **رابط شروط الخدمة** | 500 حرف | رابط يظهر في الصفحات. عند تعيينه، يطلب نموذج إنشاء الحساب من الشخص الموافقة على شروطك. |
| **رابط سياسة الخصوصية** | 500 حرف | رابط يظهر في الصفحات، بجوار شروط الخدمة. |

تُترجم الصفحات المستضافة إلى الإنجليزية والإسبانية والفرنسية والألمانية واليابانية، وتختار اللغة من متصفح الشخص، أو من `ui_locales` في رابط تسجيل الدخول.
اضبط نصوصك الخاصة لكل لغة. تحتفظ اللغة التي لا يتوفر لها نص منك بالنص الافتراضي المترجم من Didit.

عبر API، يضبط `PATCH branding/` في [واجهة API لإدارة المصادقة](https://docs.didit.me/ar/authentication/set-up-by-api.md) الحقول نفسها:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}branding/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": {
      "en": {"sign_in_title": "Welcome back", "subtitle": "Sign in to manage your account.", "sign_up_title": "Open your account"},
      "es": {"sign_in_title": "Hola de nuevo"}
    },
    "terms_url": "https://example.com/legal/terms",
    "privacy_url": "https://example.com/legal/privacy"
  }'
```

النص الذي ترسله فارغاً يعود إلى النص الافتراضي.

## رسائل تسجيل الدخول

تعرض واجهة رسائل البريد الإلكتروني في **Branding and emails** رسائل تسجيل الدخول الخاصة بتطبيقك، مع معاينة لكل رسالة وزر **Send a test**:

| البريد الإلكتروني | وقت الإرسال |
| - | - |
| رمز البريد الإلكتروني | يسجّل شخص ما الدخول أو يُنشئ حسابًا باستخدام رمز بريد إلكتروني. |
| الرابط السحري | يطلب شخص ما رابط تسجيل دخول. |
| إعادة تعيين كلمة المرور | يبدأ شخص ما عملية [استعادة كلمة المرور](https://docs.didit.me/ar/authentication/sign-in-methods.md#نسيان-كلمة-المرور-وإعادة-تعيينها). |
| تسجيل الدخول من جهاز جديد | يسجّل شخص ما الدخول من جهاز جديد. |
| الدعوة | تدعو شخصًا للتسجيل، وذلك مع سياسة التسجيل `invited`. |
| دعوة المؤسسة | تدعو شخصًا إلى إحدى [مؤسساتك](https://docs.didit.me/ar/authentication/organizations.md#الدعوات). |
| تمت الموافقة على الوكيل، وانتهى وصول الوكيل | يحصل [وكيل الذكاء الاصطناعي](https://docs.didit.me/ar/authentication/agent-access.md) الخاص بشخص ما على الوصول أو يفقده. |

يُعرض لكل رسالة بريد إلكتروني حالة **On** أو **Off** لتطبيقك.
تُرسل الرسائل من نطاق البريد الإلكتروني المُتحقَّق منه عند إعداده في Customization، وإلا فمن `Didit <no-reply@didit.me>`.

## النطاق المخصص

افتراضياً، يُسجّل تطبيقك دخول المستخدمين عبر `https://<slug>.auth.didit.me`.
ينقل النطاق المخصص الصفحات المستضافة وواجهة برمجة التطبيقات الخاصة بوقت التشغيل ومُصدِر الرموز إلى نطاق فرعي تملكه، مثل `auth.example.com`.
النطاقات المخصصة مخصصة لتطبيقات الإنتاج: تطبيق البيئة التجريبية يُسجّل الدخول دائماً عبر نطاق Didit الخاص به.

> [!WARNING]
>
> ترتبط مفاتيح المرور بالنطاق الذي يسجّل المستخدمون الدخول عليه.
> تفعيل نطاق مخصص يعني أن مفاتيح المرور الموجودة يجب تسجيلها من جديد، لذا أضف نطاقك قبل أن يبدأ الناس بإضافة مفاتيح المرور.

### الإعداد

1. ضمن **Custom domain**، أدخل **Your domain**، مثلاً `auth.example.com`، ثم اختر **Add domain**. استخدم نطاقاً فرعياً، فلا يمكن وضع سجل CNAME في جذر نطاقك.
2. أنشئ سجل DNS الذي تعرضه وحدة التحكم: سجل `CNAME` من نطاقك إلى مضيف Didit لتطبيقك.
3. اختر **Check DNS now**. قد يستغرق ظهور السجل الجديد ما يصل إلى ساعة. بعد أن يجده Didit، يُصدر شهادة لنطاقك تتجدد تلقائياً.
4. عندما يظهر النطاق بحالة **Verified**، اختر **Use this domain** ليصبح أصل تسجيل الدخول لتطبيقك.

| الحالة | المعنى |
| - | - |
| في انتظار DNS | لم يجد Didit سجل `CNAME` بعد. |
| إصدار الشهادة | السجل موجود، وجارٍ إصدار الشهادة. |
| Verified | نطاقك يقدّم الصفحات المستضافة. لا يصبح أصل تسجيل الدخول إلا بعد تفعيله. |
| نشط | نطاقك هو أصل تسجيل الدخول ومُصدِر الرموز. |
| غير موجود | فشل الفحص. أصلح السجل ثم أعد الفحص. |

عبر واجهة API، يضيف `PUT domain/` النطاق باستخدام `{"domain": "auth.example.com"}`، ويتحقق `POST domain/verify/` منه، ويفعّله `POST domain/activate/`، ويحذفه `DELETE domain/`.

### ما الذي يتغير عند تفعيله

* **المُصدِر.** تحمل الرموز الجديدة نطاقك في `iss`، وينتقل الاكتشاف وJWKS إليه. حدّث المُصدِر الذي يتحقق منه خادمك الخلفي، أو اقبل المُصدِرَين معاً حتى تنتهي صلاحية الرموز القديمة. راجع [الرموز وJWKS](https://docs.didit.me/ar/authentication/tokens-and-jwks.md).
* **المفتاح القابل للنشر.** يحمل المفتاح معلومات المُصدِر، لذا يتغير. انسخ المفتاح الجديد من **Authentication > Developers** إلى تطبيقك.
* **الجلسات والرموز** تحت النطاق القديم تنتهي خلال 5 دقائق.
* **يجب تسجيل مفاتيح المرور من جديد** على النطاق الجديد.
* **روابط إعادة التوجيه والإعدادات والمستخدمون الذين سجّلوا** تبقى كما هي.

احفظ المفتاح القابل للنشر في إعداد واحد في تطبيقك، ليصبح التبديل تغييراً واحداً.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.