تهيئة تسجيل الدخول الموحد عبر Feishu لـ Verdent Team

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

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

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

كيف يعمل Feishu SSO

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

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

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

قبل البدء

ستحتاج إلى:

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

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

فتح إعدادات SSO

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

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

تهيئة تطبيق Feishu

إنشاء تطبيق مؤسسي مخصص

افتح Feishu Open Platform، وادخل إلى Developer Console، ثم انقر على Create custom enterprise app. أدخل اسمًا وارفع أيقونة وأنشئ التطبيق.

الحصول على بيانات اعتماد التطبيق

افتح Credentials & Basic Info وحدد App ID وApp Secret:

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

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

إضافة رابط إعادة التوجيه

افتح Development Configuration → Security Settings وأضف Redirect URL التالي:

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

يجب أن يتطابق الرابط تمامًا: استخدم https، ولا تضف / في النهاية، واحذف المسافات المحيطة. تؤدي القيمة غير الصحيحة إلى خطأ Feishu رقم 20029.

منح الأذونات

افتح Development Configuration → Permissions وامنح:

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

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

نشر التطبيق

افتح Version Management & Release، وأنشئ إصدارًا وانشره. لا يمكن للأعضاء استخدام التطبيق إلا بعد نشره.

إكمال الربط في Verdent

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

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

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

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

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

Client ID أو Client Secret غير صالح

انسخ App ID وApp Secret مجددًا من Credentials & Basic Info. إذا أُعيد ضبط Secret، فاستخدم أحدث قيمة.

التطبيق غير متاح أثناء تسجيل الدخول

تأكد من نشر إصدار ضمن Version Management & Release.

البريد الإلكتروني فارغ بعد تسجيل الدخول

أضف بريدًا مؤسسيًا إلى ملف العضو في دليل Feishu، ثم أعد المحاولة.

لا يتم توجيه العضو إلى Feishu SSO

تأكد من مطابقة البريد لنطاق مهيأ ومن تفعيل Feishu SSO في Verdent.

View as Markdown