> ## 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.

# SAML SSO

> تكوين تسجيل الدخول الموحد SAML 2.0 لمؤسستك.

تدعم Truthlocks تسجيل الدخول الموحد الأصلي SAML 2.0 حتى يتمكن فريقك من المصادقة من خلال موفر الهوية (IdP) الحالي الخاص بك. عند تكوين SAML، يتم توجيه المستخدمين تلقائيًا إلى موفر الهوية الخاص بك أثناء تسجيل الدخول.

> [!NOTE]
>
> يتوفر SAML SSO في خطة **Business** وما فوق.

## كيف يعمل

**1. تكوين IdP الخاص بك**

سجل Truthlocks كمزود خدمة (SP) في موفر الهوية الخاص بك.
تحتاج إلى معرف كيان موفر الخدمة (SP Entity ID) وعنوان URL لخدمة استهلاك التأكيد (ACS) من
شاشة الإعداد.

**2. إضافة اتصال في Truthlocks**

في وحدة التحكم، انتقل إلى **الإعدادات > SSO** وأنشئ اتصال SAML جديدًا.
أدخل عنوان URL لبيانات تعريف IdP الخاصة بك أو قدم يدويًا معرف كيان IdP، وعنوان URL لتسجيل الدخول الأحادي (SSO)،
وشهادة التوقيع.

**3. يسجل المستخدمون الدخول عبر موفر الهوية**

بمجرد التفعيل، يتم إعادة توجيه المستخدمين الذين يزورون صفحة تسجيل الدخول إلى وحدة التحكم إلى
IdP. بعد المصادقة، يتم إعادتهم إلى Truthlocks بجلسة.

## تفاصيل مزود الخدمة

قدم هذه القيم إلى IdP الخاص بك عند تسجيل Truthlocks:

| الحقل | القيمة |
| - | - |
| معرف كيان SP | `urn:truthlocks:TENANT_ID` |
| عنوان URL لـ ACS | `https://console.truthlocks.com/api/auth/saml/acs` |
| تنسيق NameID | `urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress` |
| الربط | HTTP-POST |

## حقول تكوين IdP

عند إنشاء اتصال SAML في وحدة التحكم، يمكنك تكوين موفر الهوية الخاص بك بطريقتين:

### الخيار أ: عنوان URL للبيانات الوصفية

قدم عنوان URL لبيانات تعريف IdP الخاص بك وتقوم Truthlocks تلقائيًا بجلب معرف الكيان، وعنوان URL لتسجيل الدخول الموحد، وشهادة التوقيع.

### الخيار ب: التكوين اليدوي

| الحقل | الوصف |
| - | - |
| معرف كيان IdP | المعرف الفريد لموفر الهوية الخاص بك |
| عنوان URL لتسجيل الدخول الموحد (SSO) لموفر الهوية (IdP) | عنوان URL الذي يرسل إليه Truthlocks طلبات مصادقة SAML |
| شهادة IdP | شهادة توقيع X.509 من موفر الهوية الخاص بك (تنسيق PEM) |

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

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_type": "SAML",
    "idp_metadata_url": "https://idp.example.com/metadata",
    "role_mapping_mode": "GROUPS"
  }'
```

إذا كنت تفضل التكوين اليدوي، فاحذف `idp_metadata_url` وقدم `idp_entity_id` و `idp_sso_url` و `idp_certificate` بدلاً من ذلك.

## تعيين الأدوار

تقوم Truthlocks بربط تأكيدات مجموعات موفري الهوية (IdP) بالأدوار الداخلية أثناء تسجيل الدخول. يتوفر وضعان:

| الوضع | السلوك |
| - | - |
| `STATIC` | يتلقى جميع مستخدمي SAML دورًا افتراضيًا ثابتًا (على سبيل المثال، `viewer`) |
| `GROUPS` | يتم تعيين أسماء مجموعات IdP لأدوار Truthlocks (`admin`، `editor`، `auditor`) تلقائيًا |

عيّن الوضع عند إنشاء أو تحديث اتصال SSO.

## توفير المستخدمين

عندما يقوم مستخدم بالمصادقة عبر SAML للمرة الأولى، يقوم Truthlocks تلقائيًا بإنشاء حسابه باستخدام سمات من تأكيد SAML (البريد الإلكتروني، الاسم الأول، الاسم الأخير). يُسمى هذا التوفير في الوقت المناسب (JIT).

لمزامنة المستخدمين بالجملة وإلغاء توفيرهم، استخدم [SCIM provisioning](https://docs.truthlocks.com/ar/security/scim.md).

## تفاصيل الجلسة

* تستمر الجلسات **12 ساعة** بعد تسجيل الدخول عبر SAML.
* ملفات تعريف الارتباط للجلسة هي `HttpOnly` و `SameSite=Lax`.
* يتم تطبيق تسامح انحراف زمني قدره دقيقتين عند التحقق من تأكيدات SAML.

## اختبار الاتصال

بعد إنشاء اتصال SAML، اختبره قبل التمكين لجميع المستخدمين:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections/<connection_id>/test \
  -H "Authorization: Bearer <admin_token>"
```

يتحقق هذا من أن Truthlocks يمكنه الوصول إلى IdP الخاص بك وتحليل البيانات الوصفية بشكل صحيح.

## تعطيل تسجيل الدخول الموحد (SSO)

للعودة إلى المصادقة القياسية بالبريد الإلكتروني/كلمة المرور:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections/<connection_id>/disable \
  -H "Authorization: Bearer <admin_token>"
```

## ذات صلة

* [توفير SCIM](https://docs.truthlocks.com/ar/security/scim.md) — أتمتة مزامنة المستخدم والمجموعة من IdP الخاص بك.
* [RBAC والأذونات](https://docs.truthlocks.com/ar/security/rbac.md) — فهم الأدوار التي يتم تعيين مستخدمي SAML لها.
* [المصادقة](https://docs.truthlocks.com/ar/security/auth.md) — طرق مصادقة مفتاح API و JWT.


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