مزامنة الأشخاص من Microsoft Entra ID
سجّل تطبيقًا في Microsoft Entra ID ويقرأ Polzy دليلك وفق جدول زمني: ينضم الأعضاء بقسمهم ومكتبهم ومديرهم، وتتوقف الحسابات المعطّلة عن تلقي الاستبيانات.
في هذه الصفحة
اربط Microsoft Entra ID كمصدر للأشخاص وسيقرأ Polzy المستخدمين في دليلك عبر Microsoft Graph وفق جدول زمني. ينضم المستخدمون الجدد كأعضاء في مساحة العمل هذه مع مسمّاهم الوظيفي وقسمهم ومكتبهم ومديرهم، وتنتقل التغييرات مع المزامنة التالية، وتتوقف الحسابات التي تعطّلها أو تحذفها عن تلقي الاستبيانات.
مزامنة الأشخاص متاحة في خطة Team وما فوقها، ولا يستطيع ربط مصدر إلا مسؤولو مساحة العمل. يقرأ Polzy دليلك فقط: لا يغيّر أي مستخدم في Entra ID أبدًا.
مزامنة أم SCIM أم تسجيل دخول موحّد؟
يتصل Polzy بـ Microsoft Entra ID بثلاث طرق، لثلاث مهام مختلفة:
- مزامنة الدليل (هذه المقالة). يقرأ Polzy المستخدمين من Entra ID إلى مساحة عمل واحدة وفق جدول زمني، مع السمات التي تجمّع النتائج حسبها — القسم والمكتب والمسمى الوظيفي والمدير. متاحة في Team وما فوقها، ويُعدّها مسؤول مساحة العمل.
- التزويد عبر SCIM. يرسل Entra ID الأعضاء إلى مؤسستك لحظة تغيّرهم، ويضعهم في مساحات العمل حسب مجموعاتهم. متاح في Enterprise، ويُعدّه المالك — راجع SCIM.
- تسجيل الدخول الموحّد. يسجّل الأشخاص الدخول إلى Polzy بحساب Microsoft بدلًا من كلمة مرور. هو يحدّد كيف يسجّل الناس الدخول، لا من ينتمي إلى مساحة العمل. متاح في Enterprise، ويُعدّه المالك — راجع تسجيل الدخول الموحّد.
يعمل تسجيل الدخول الموحّد مع أي من الطريقتين الأخريين. أما مزامنة الدليل وSCIM فلا يمكن تشغيلهما في المؤسسة نفسها: ما دام لديها رمز SCIM، لا تستطيع أي مساحة عمل ربط مصدر للأشخاص.
قبل أن تبدأ
تحتاج إلى:
- أن تكون مسؤولًا في مساحة عمل Polzy، على خطة Team أو أعلى، مع تفعيل مزامنة الأشخاص من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
- دور في Microsoft Entra ID يسمح بتسجيل التطبيقات، وشخص يستطيع منح موافقة المسؤول، مثل Cloud Application Administrator.
- أن تكون الحقول التي تريد تجميع النتائج حسبها، مثل القسم أو المكتب، مضافة في Polzy.
تتزامن مساحة العمل من مصدر واحد في كل مرة. إذا كان هناك مصدر آخر مربوط، فافصله أولًا.
تسجيل تطبيق في Microsoft Entra ID
- في مركز إدارة Microsoft Entra، انتقل إلى Entra ID → App registrations واختر New registration.
- سمِّ التطبيق Polzy، واختر Single tenant only ضمن Supported account types، ثم اختر Register. لا حاجة إلى عنوان إعادة توجيه.
- في صفحة Overview للتطبيق، انسخ Application (client) ID وDirectory (tenant) ID.
- افتح API permissions، واختر Add a permission → Microsoft Graph → Application permissions، وحدّد
User.Read.All، ثم اختر Add permissions. - اختر Grant admin consent for مؤسستك، وأكّد. تتحول حالة الإذن إلى ممنوح.
- افتح Certificates & secrets → Client secrets → New client secret. أدخل وصفًا ومدة صلاحية، ثم اختر Add.
- انسخ Value الخاصة بالسرّ فورًا — لا Secret ID. لن تعرضها Microsoft مرة أخرى.
تدوم الأسرار سنتين على الأكثر. ضع تذكيرًا في تقويمك قبل انتهاء صلاحية سرّك ببضعة أسابيع: فعند انتهائها تتوقف المزامنة إلى أن تلصق سرًّا جديدًا. راجع Microsoft: Register an application وMicrosoft: Add an application permission and grant admin consent وMicrosoft: Add a client secret.
ربط Entra ID في Polzy
- افتح جهات الاتصال ← المزامنة والحقول.
- ضمن المصادر المتاحة، ابحث عن Microsoft Entra ID واختر ربط. تُفتح لوحة من ثلاث خطوات: الاتصال وإعدادات المزامنة وربط الحقول.
- الصق Tenant ID (معرّف الدليل) وApplication (Client) ID وقيمة Client Secret.
- اختر اختبار الاتصال. تعني رسالة تبدأ بـ Successfully connected to Entra ID أن Polzy استطاع قراءة دليلك.
- اختر التالي، وراجع إعدادات المزامنة (انظر أدناه)، ثم اختر التالي مرة أخرى.
- في ربط الحقول، أبقِ الربط الافتراضي أو فعّل تخطيط الحقول المخصص (انظر أدناه)، ثم اختر ربط.
يُخزَّن السرّ مشفّرًا ولا يُستخدم إلا لقراءة دليلك. يتحقق Polzy منه مجددًا حين تختار ربط: فإن رفضته Microsoft، لا يُحفظ شيء.
إعدادات المزامنة
| الإعداد | ماذا يفعل | الافتراضي |
|---|---|---|
| تكرار المزامنة | عدد مرات قراءة Polzy لـ Entra ID: كل 15 دقيقة، أو كل 30 دقيقة، أو كل ساعة، أو كل 4 ساعات، أو يوميًا. | كل ساعة |
| تعطيل المستخدمين المحذوفين | من جلبه Polzy من Entra ID ولم يعد يظهر فيه يُعطَّل في المزامنة التالية. | مفعّل |
| إرسال رسائل دعوة عبر البريد الإلكتروني | يتلقى الأعضاء الجدد دعوة لتسجيل الدخول إلى Polzy. | مفعّل |
| الدور الافتراضي للمستخدمين الجدد | الدور الذي يحصل عليه الأعضاء الجدد: مُشاهد أو محرّر أو مسؤول. ينطبق فقط على من تنشئهم المزامنة. | مُشاهد |
| استعلام التصفية (اختياري) | يقرأ فقط المستخدمين المطابقين لعامل تصفية Microsoft Graph، مثل department eq 'Sales'. إذا كان فارغًا، يقرأ Polzy كل أعضاء دليلك ويستبعد الضيوف. | فارغ |
| حفظ البيانات الخام لأغراض تصحيح الأخطاء | يحتفظ بنسخة من كل مستخدم كما أرسلته Microsoft بجانب الشخص في Polzy. أبقه معطّلًا ما لم تكن تتحقق من مشكلة في الربط: فهو يخزّن بيانات شخصية أكثر مما تحتاج. | معطّل |
عامل التصفية الذي تكتبه يحلّ محل العامل الذي يستبعد الضيوف. لمواصلة استبعادهم، أضفه بنفسك: userType eq 'Member' and department eq 'Sales'. يرسل Polzy عامل التصفية كما هو، فاستخدم عوامل التصفية البسيطة التي يقبلها Microsoft Graph على المستخدمين دون استعلامات متقدمة، مثل eq وin وstartswith. راجع Microsoft: Use the $filter query parameter.
ربط الحقول
يملأ الربط الافتراضي:
| حقل Polzy | من Entra ID |
|---|---|
| البريد الإلكتروني | userPrincipalName |
| الاسم الأول، اسم العائلة | givenName، surname |
| المسمى الوظيفي، القسم | jobTitle، department |
| المكتب | officeLocation |
| رقم الهاتف | mobilePhone |
| الرقم الوظيفي | employeeId |
| حالة النشاط | accountEnabled |
| المدير | قيمة userPrincipalName للمدير |
إذا كان موظفوك يسجّلون الدخول باسم ليس هو بريدهم الإلكتروني، ففعّل تخطيط الحقول المخصص واربط البريد الإلكتروني بـ mail بدلًا منه. لكل صف أيضًا قيمة في إذا كان فارغًا، استخدم، تُكتب حين لا يكون لدى Entra ID شيء لذلك الشخص — أما القيمة التي يرسلها فلا تُستبدل أبدًا. يقرأ Polzy هذه السمات لكل مستخدم: userPrincipalName وmail وgivenName وsurname وdisplayName وjobTitle وdepartment وofficeLocation وmobilePhone وemployeeId وaccountEnabled والمدير.
أمور تجدر معرفتها:
- لا تُملأ إلا حقول مساحة عملك. لا يُحفظ القسم أو المكتب إلا إذا كان في مساحة عملك حقل بهذا الاسم. أضف حقلًا عبر إضافة حقل في المزامنة والحقول، ثم اربطه.
- المجموعات. لمقارنة النتائج حسب حقل، اجعله حقلًا من نوع قائمة وفعّل المجموعات بجانبه في جدول ربط الحقول. تُطابَق القيم القادمة من Entra ID مع خيارات الحقل.
- أمثلة حقيقية. بعد الربط، اختر الإعدادات في المزامنة والحقول وافتح ربط الحقول من جديد: تأتي القائمة حينها من خمسة مستخدمين حقيقيين، لكل منهم مثال.
- المديرون. يُربط المدير إذا كان موجودًا في Polzy أيضًا. وإن لم يكن موجودًا بعد، يُنشأ الربط في مزامنة لاحقة. يحتاج المديرون إلى تفعيل التسلسل الإداري في مساحة العمل.
المعاينة وتشغيل المزامنة الأولى
- في المزامنة والحقول، اختر معاينة مزامنة ضمن سجل المزامنة. يحسب Polzy ما ستضيفه المزامنة وتحدّثه وتعطّله دون أن يغيّر شيئًا، ويفتح السجل حيث تظهر النتيجة بوصف معاينة.
- راجع المعاينة. إذا كان سيصل أشخاص غير المقصودين، فعدّل استعلام التصفية من الإعدادات وعاين مرة أخرى.
- اختر مزامنة الآن. تظهر النتيجة في سجل المزامنة.
يُطابَق الأشخاص بمعرّف الكائن في Entra ID، ثم بالبريد الإلكتروني، فمن دعوته يدويًا من قبل يُحدَّث بدلًا من أن يُضاف مرتين.
الجدول وسجل المزامنة
بعد المزامنة الأولى يعمل Polzy تلقائيًا بالتكرار الذي اخترته، بفارق دقائق قليلة. وحين تطلب Microsoft من Polzy التمهّل، ينتظر المدة المطلوبة ثم يتابع. يعرض سجل المزامنة آخر خمسة تشغيلات — نجحت أو جزئية (تُخطّي بعض الأشخاص أو فشلوا) أو فشلت أو معاينة — ويفتح السجل الكامل كل تشغيل مع كل تغيير أجراه.
إذا فشلت مزامنة، يعيد Polzy المحاولة لاحقًا وينتظر أطول في كل مرة. بعد ثلاث حالات فشل متتالية، أو فورًا إذا رفضت Microsoft بيانات الاعتماد — سرّ منتهي الصلاحية أو موافقة مسحوبة — يظهر على المصدر يحتاج إلى انتباه ويُبلَّغ المسؤولون. يعود مزامنة الآن إلى العمل حين يصبح المصدر متصلًا: الصق سرًّا جديدًا في الإعدادات واحفظ.
عندما يغادر أحدهم
- حساب معطّل. المستخدم المعطّل حسابه في Entra ID يُعطَّل في المزامنة التالية. لا يتلقى الأشخاص المعطَّلون استبيانات ولا يشغلون مقعدًا، وتبقى إجاباتهم السابقة محفوظة.
- محذوف أو خارج عامل التصفية. مع تفعيل تعطيل المستخدمين المحذوفين، يُعطَّل أيضًا من لم يعد يظهر فيما يقرأه Polzy — لأنه حُذف أو لم يعد يطابق عامل التصفية.
- محظور في Polzy. من حظره مسؤول في Polzy يبقى محظورًا، مهما قال Entra ID.
لا تحذف المزامنة أحدًا أبدًا.
استكشاف الأخطاء وإصلاحها
| ما تراه | السبب | ما تفعله |
|---|---|---|
| Invalid Tenant ID format أو Invalid Client ID format | القيمة ليست معرّفًا بالصيغة xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. | انسخ Directory (tenant) ID وApplication (client) ID من صفحة Overview للتطبيق. |
| Microsoft refused these credentials: … | السرّ غير صحيح أو منتهي الصلاحية — أو نسخت Secret ID بدلًا من Value. | أنشئ سرّ عميل جديدًا والصق قيمته Value في الإعدادات. |
| Microsoft refused these credentials. Check the app registration and its admin consent. | الإذن User.Read.All غير موجود، أو لم تُمنح موافقة المسؤول أو سُحبت. | أضف الإذن واختر Grant admin consent for مؤسستك. |
| يصل ضيوف إلى Polzy | حلّ استعلام التصفية الذي كتبته محل العامل الذي يستبعد الضيوف. | أضف userType eq 'Member' and في بداية عامل التصفية. |
| لم يتم استيراد N شخص: لا توجد مقاعد متبقية في الخطة. | يشغل كل عضو مقعدًا، والخطة ممتلئة. | ضيّق عامل التصفية، أو حرّر مقاعد، أو غيّر الخطة، ثم اختر مزامنة الآن. |
| تزوّد هذه المؤسسة الأشخاص عبر SCIM. ألغِ رمز SCIM من الإعدادات ← الأمان قبل توصيل مصدر للأشخاص. | لا يمكن تشغيل SCIM ومصدر للأشخاص في المؤسسة نفسها. | استخدم SCIM بدلًا من ذلك، أو اطلب من المالك إلغاء رمز SCIM أولًا. |
معلومات مفيدة
- أعضاء لا جهات اتصال. كل من يأتي من Entra ID عضو: يستطيع تسجيل الدخول ويشغل مقعدًا. المزامنة التي تتجاوز مقاعدك تستورد من يتسع لهم، وتتوقف عندهم، وتُبلغ المسؤولين — راجع الاستخدام والحدود.
- لا تحديثات فورية. تصل التغييرات مع المزامنة المجدولة التالية، أو حين تختار مزامنة الآن. وإن أردت التغييرات لحظة حدوثها، فاستخدم SCIM.
- قطع الاتصال أو الإزالة. من الإعدادات، يوقف قطع الاتصال المزامنة ويحتفظ بالإعدادات والسجل لتعيد الربط لاحقًا، بينما تحذف إزالة الاتصال. في الحالتين يبقى الأشخاص الذين تمت مزامنتهم في Polzy ولا يعودون يُحدَّثون.
- تحتاج إلى مساعدة؟ يشرح رابط اسأل Polzy في لوحة الربط أين تجد كل قيمة في مركز إدارة Microsoft Entra.
روابط مفيدة
- Microsoft: Register an application — تسجيل التطبيق، وأين تجد معرّفاته.
- Microsoft: Add an application permission and grant admin consent — الإذن
User.Read.Allوزر الموافقة. - Microsoft: Add a client secret — إنشاء السرّ ونسخ قيمته.
- Microsoft: Find your tenant ID — إن احتجت إلى معرّف المستأجر مرة أخرى.
- Microsoft: Use the $filter query parameter — كتابة استعلام تصفية.
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.