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

# نطاقات مخصصة

> قم بإعداد عناوين URL ذات العلامات التجارية لبوابة التحقق ووحدة التحكم الخاصة بك باستخدام تكوين المجال المخصص والتحقق من DNS.

تتيح لك النطاقات المخصصة عرض بوابة التحقق وواجهة التحكم الخاصة بـ Truthlocks من نطاقك الخاص. بدلاً من `verify.truthlocks.com`، يرى المستخدمون لديك `verify.yourdomain.com`.

> [!NOTE]
>
> النطاقات المخصصة متاحة في جميع الخطط. انتقل إلى **الإعدادات > النطاقات**
> في وحدة التحكم للبدء.

## أنواع النطاقات

تدعم Truthlocks نوعين من النطاقات المخصصة:

| النوع | الغرض | مثال |
| :- | :- | :- |
| **التحقق** | بوابة تحقق عامة حيث يقوم المستلمون والمدققون بالتحقق من الشهادات | `verify.yourdomain.com` |
| **Console** | وحدة تحكم إدارية لفريقك | `console.yourdomain.com` |

يمكنك تكوين أحد النوعين أو كليهما حسب احتياجاتك.

## إعداد نطاق مخصص

**1. فتح إعدادات النطاق**

انتقل إلى **الإعدادات > النطاقات** في وحدة التحكم.

**2. إضافة نطاق**

انقر على **إضافة نطاق**، وحدد نوع النطاق (التحقق أو Console)، و
أدخل اسم المضيف الذي تريد استخدامه (على سبيل المثال، `verify.yourdomain.com`).

**3. إضافة سجل DNS**

تنشئ Truthlocks رمز تحقق فريدًا لنطاقك. أضف TXT
سجل إلى تكوين DNS الخاص بك:

| الحقل | القيمة |
| :- | :- |
| **النوع** | `TXT` |
| **الاسم** | `_truthlocks-verify` |
| **القيمة** | رمز التحقق المعروض في وحدة التحكم |

انسخ الرمز المميز باستخدام زر **نسخ** بجانبه.

**4. التحقق من النطاق**

بعد إضافة سجل DNS، انقر فوق **التحقق من سجل DNS** في وحدة التحكم.
تتحقق Truthlocks من سجل TXT وتحدث حالة النطاق.

> [!TIP]
>
> يمكن أن يستغرق انتشار DNS ما يصل إلى 48 ساعة، على الرغم من أن معظم المزودين ينشرون
> في غضون دقائق. إذا فشل التحقق، انتظر بضع دقائق وحاول مرة أخرى.

## حالات النطاق

يتقدم كل نطاق عبر ثلاث حالات:

| الحالة | المعنى |
| :- | :- |
| **معلق** | تمت إضافة النطاق ولكن لم يتم التحقق من سجل DNS بعد. |
| **تم التحقق** | تم العثور على سجل DNS TXT والتحقق منه. يصبح النطاق نشطًا تلقائيًا. |
| **نشط** | النطاق مباشر ويخدم حركة المرور لمستأجرك. |

## إدارة النطاقات عبر واجهة برمجة التطبيقات

يمكنك إضافة المجالات المخصصة وإدراجها والتحقق منها برمجيًا.

### قائمة النطاقات

```http Request theme={null}
GET /v1/settings/domains
X-API-Key: tl_live_...
```

```json Response theme={null}
{
  "domains": [
    {
      "id": "dom_abc123",
      "tenant_id": "tn_xyz789",
      "type": "VERIFY",
      "hostname": "verify.acme.com",
      "status": "ACTIVE",
      "verification_token": "tl-verify-abc123def456",
      "verified_at": "2026-03-25T14:30:00Z",
      "created_at": "2026-03-25T14:00:00Z"
    }
  ]
}
```

### إضافة نطاق

```http Request theme={null}
POST /v1/settings/domains
X-API-Key: tl_live_...
Content-Type: application/json

{
  "type": "VERIFY",
  "hostname": "verify.acme.com"
}
```

يقبل الحقل `type` `VERIFY` لنطاقات التحقق أو `CONSOLE` لنطاقات وحدة التحكم. تتضمن الاستجابة `verification_token` التي تحتاجها لإعداد DNS.

### التحقق من نطاق

```http Request theme={null}
POST /v1/settings/domains/{domain_id}/verify
X-API-Key: tl_live_...
```

يعرض كائن النطاق المحدث. إذا لم يتم العثور على سجل DNS، تظل الحالة `PENDING`.

## مثال: إعداد كامل

```bash theme={null}
# 1. Add the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type": "VERIFY", "hostname": "verify.acme.com"}'

# 2. Add the TXT record to your DNS (using your DNS provider)
# Name:  _truthlocks-verify
# Value: <verification_token from response>

# 3. Verify the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains/dom_abc123/verify \
  -H "X-API-Key: tl_live_..."
```

## استكشاف الأخطاء وإصلاحها

### التحقق يستمر في الفشل

1. تأكد من أن اسم سجل TXT هو بالضبط `_truthlocks-verify` (بعض المزودين يضيفون النطاق تلقائيًا — تحقق من وجود تكرارات مثل `_truthlocks-verify.yourdomain.com.yourdomain.com`).
2. انتظر انتشار DNS. استخدم `dig TXT _truthlocks-verify.yourdomain.com` لتأكيد أن السجل مرئي.
3. تأكد من أن قيمة TXT تطابق الرمز المميز المعروض في وحدة التحكم تمامًا، بدون مسافات إضافية.

### النطاق تم التحقق منه ولكنه غير نشط

تنتقل النطاقات التي تم التحقق منها إلى حالة نشطة تلقائيًا. إذا لم يتم تحديث الحالة، فقم بتحديث الصفحة أو إعادة الجلب عبر واجهة برمجة التطبيقات.

## ذات صلة

> [card] [علامة تجارية مخصصة](https://docs.truthlocks.com/guides/enterprise-branding.md)
>
> تحميل الشعارات وتعيين ألوان العلامة التجارية لصفحات التحقق ورسائل البريد الإلكتروني.

> [card] [تسليم البريد الإلكتروني](https://docs.truthlocks.com/security/email-delivery.md)
>
> تكوين مرسلي البريد الإلكتروني المخصصين وخوادم SMTP.


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