# تهيئة تسجيل الدخول الموحد عبر Feishu لـ Verdent Team (/ar/docs/account-billing/configure-feishu-sso)

> ربط Feishu بـ Verdent Team لتسجيل دخول مؤسسي مركزي



تدعم Verdent Team تسجيل الدخول الموحد (SSO) عبر Feishu. بعد التهيئة، يمكن للأعضاء الذين لديهم نطاق بريد إلكتروني مؤسسي معتمد التحقق من هويتهم باستخدام حساب Feishu الخاص بالشركة.

يتيح Feishu SSO استخدام نظام الهوية المؤسسي الحالي، ويقلل الحاجة إلى بيانات اعتماد منفصلة، ويمنح Team Owner مكانًا واحدًا لإدارة الوصول.

<Note>
  هذا الدليل موجّه إلى Team Owners في Verdent Team. يمكن فقط لـ Team Owner الوصول إلى إعدادات Team وإدارة SSO.
</Note>

## كيف يعمل Feishu SSO [#كيف-يعمل-feishu-sso]

ينشئ Team Owner تطبيقًا مؤسسيًا مخصصًا في Feishu Open Platform، ثم يضيف بيانات اعتماد التطبيق ونطاقات البريد الإلكتروني المؤسسية إلى Verdent Team.

عندما يُدخل عضو بريدًا مؤسسيًا مطابقًا في صفحة تسجيل الدخول إلى Verdent، يتم توجيهه إلى Feishu للتفويض، وتتحقق Verdent من البريد الذي يعيده Feishu.

<Warning>
  يجب أن يكون لدى الأعضاء بريد إلكتروني مؤسسي في دليل Feishu، وإلا فلن يتمكنوا من تسجيل الدخول عبر Feishu SSO.
</Warning>

## قبل البدء [#قبل-البدء]

ستحتاج إلى:

* حساب مسؤول مؤسسي في Feishu يمكنه إنشاء تطبيقات مخصصة
* صلاحية Owner في Verdent Team
* نطاق البريد الإلكتروني المؤسسي، مثل `yourcompany.com`

تستغرق التهيئة عادةً نحو 5 دقائق.

## فتح إعدادات SSO [#فتح-إعدادات-sso]

1. سجّل الدخول إلى Verdent وانتقل إلى Team الذي تريد تهيئته.
2. افتح **Settings** في لوحة Team.
3. اختر **SSO**.
4. انقر على **Connect SSO**.

أبقِ Verdent وFeishu Open Platform مفتوحين أثناء التهيئة.

## تهيئة تطبيق Feishu [#تهيئة-تطبيق-feishu]

<Steps>
  <Step title="إنشاء تطبيق مؤسسي مخصص">
    افتح [Feishu Open Platform](https://open.feishu.cn/app)، وادخل إلى **Developer Console**، ثم انقر على **Create custom enterprise app**. أدخل اسمًا وارفع أيقونة وأنشئ التطبيق.
  </Step>

  <Step title="الحصول على بيانات اعتماد التطبيق">
    افتح **Credentials & Basic Info** وحدد App ID وApp Secret:

    | بيانات Feishu  | حقل Verdent SSO |
    | -------------- | --------------- |
    | **App ID**     | `Client ID`     |
    | **App Secret** | `Client Secret` |

    <Warning>
      تعامل مع App Secret ككلمة مرور. إذا أعدت ضبطه في Feishu، فحدّث 

      `Client Secret`

       في Verdent.
    </Warning>
  </Step>

  <Step title="إضافة رابط إعادة التوجيه">
    افتح **Development Configuration → Security Settings** وأضف **Redirect URL** التالي:

    ```text
    https://login.verdent.ai/passport/sso/callback
    ```

    <Warning>
      يجب أن يتطابق الرابط تمامًا: استخدم 

      `https`

      ، ولا تضف 

      `/`

       في النهاية، واحذف المسافات المحيطة. تؤدي القيمة غير الصحيحة إلى خطأ Feishu رقم 

      `20029`

      .
    </Warning>
  </Step>

  <Step title="منح الأذونات">
    افتح **Development Configuration → Permissions** وامنح:

    | الإذن                           | النطاق                        |
    | ------------------------------- | ----------------------------- |
    | قراءة معلومات المستخدم الأساسية | `contact:user.base:readonly`  |
    | قراءة معلومات بريد المستخدم     | `contact:user.email:readonly` |

    تستخدم Verdent هذه الأذونات لتحديد الأعضاء بالاسم والبريد المؤسسي.
  </Step>

  <Step title="نشر التطبيق">
    افتح **Version Management & Release**، وأنشئ إصدارًا وانشره. لا يمكن للأعضاء استخدام التطبيق إلا بعد نشره.
  </Step>
</Steps>

## إكمال الربط في Verdent [#إكمال-الربط-في-verdent]

عُد إلى تهيئة Feishu SSO في Verdent وأدخل:

| حقل Verdent     | القيمة                         |
| --------------- | ------------------------------ |
| `Client ID`     | Feishu App ID                  |
| `Client Secret` | Feishu App Secret              |
| `Email domain`  | نطاق البريد الإلكتروني المؤسسي |

يمكنك إضافة ما يصل إلى 5 نطاقات مؤسسية. لا تُدعم النطاقات العامة مثل Gmail.

احفظ التهيئة وتأكد من تفعيل Feishu SSO في بطاقة التهيئة. يمكنك تعطيله مؤقتًا دون حذف الربط.

<Note>
  تتحقق Verdent من بيانات الاعتماد عند الحفظ، لكنها لا تتحقق من رابط إعادة التوجيه في Feishu.
</Note>

## تجربة تسجيل دخول الأعضاء [#تجربة-تسجيل-دخول-الأعضاء]

بعد التفعيل، يُدخل الأعضاء بريدًا من نطاق مهيأ، ويؤكدون استخدام SSO، ويفوضون الوصول في Feishu، ثم يعودون إلى Verdent. إذا اختلف البريد المُدخل عن البريد الذي يعيده Feishu، تطلب Verdent التأكيد وتستخدم بريد Feishu للمصادقة.

## اختبار التهيئة وإدارتها [#اختبار-التهيئة-وإدارتها]

قبل التعميم، اختبر SSO مع عضو عادي لديه بريد مؤسسي في حساب Feishu. سجّل الخروج، واستخدم ذلك البريد، وأكمل تفويض Feishu، وتأكد من الوصول إلى Verdent Team.

من **Team → Settings → SSO**، يمكن لـ Team Owner عرض النطاقات والحالة، وتفعيل SSO أو تعطيله، وتحديث بيانات الاعتماد، وإعادة تهيئة الاتصال أو حذفه.

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

<AccordionGroup>
  <Accordion title="خطأ Feishu رقم 20029: رابط إعادة توجيه غير صالح">
    في **Development Configuration → Security Settings**، تأكد من إضافة `https://login.verdent.ai/passport/sso/callback`
    كما هو تمامًا.
  </Accordion>

  <Accordion title="Client ID أو Client Secret غير صالح">
    انسخ App ID وApp Secret مجددًا من **Credentials & Basic Info**. إذا أُعيد ضبط Secret، فاستخدم أحدث قيمة.
  </Accordion>

  <Accordion title="التطبيق غير متاح أثناء تسجيل الدخول">
    تأكد من نشر إصدار ضمن **Version Management & Release**.
  </Accordion>

  <Accordion title="البريد الإلكتروني فارغ بعد تسجيل الدخول">
    أضف بريدًا مؤسسيًا إلى ملف العضو في دليل Feishu، ثم أعد المحاولة.
  </Accordion>

  <Accordion title="لا يتم توجيه العضو إلى Feishu SSO">
    تأكد من مطابقة البريد لنطاق مهيأ ومن تفعيل Feishu SSO في Verdent.
  </Accordion>
</AccordionGroup>