سيتم إيقاف استخدام Workplace from Meta. سيكون بإمكانك متابعة استخدام Workplace حتى 31 أغسطس 2025. تفضل بزيارة مركز المساعدة للتعرف على المزيد.
بصفتك مسؤول نظام Workplace، يمكنك التحكم في الإمكانات المقدمة لكل دمج عن طريق إنشاء التطبيقات ومنحها أذونات محددة. يمكن تسمية كل تطبيق لعرض الخدمة التي يمكّنها. تتميز التطبيقات برموز وصول وأذونات فريدة للتحكم في المعلومات المسموح بقراءتها أو كتابتها من خلال هذا التطبيق.
يتناول هذا الدليل نموذج التطبيق والإذن بمزيد من التفاصيل.
يمكن منح كل تطبيق Workplace مجموعة الخاصة من الأذونات للتحكم في مستوى الوظائف المتوفرة له في Graph API وAPI إدارة الحساب.
عند إنشاء تطبيق ومنح الأذونات، يتم تطبيق تلك الأذونات على كل حساب في المجتمع الخاص بك. لا يحتاج أصحاب الحسابات إلى منح أذونات إضافية إلى التطبيق من أجل الاستفادة من الوظائف. يختلف ذلك عن نموذج الإذن في فيسبوك، حيث يمنح كل مستخدم بشكل فردي الأذونات إلى التطبيق عند تسجيل الدخول.
فيما يلي قائمة كاملة بأذونات التطبيقات المتوفرة لعمليات الدمج، بالإضافة إلى نظرة عامة حول كيفية استخدامها.
الإذن | الوصف |
---|---|
قراءة محتوى المجموعةيتيح قراءة المنشورات والتعليقات في المجموعات المحددة. read_group | استخدم هذا الإذن عند إنشاء دمج يعمل على استدعاء المحتوى بالكامل من المجموعات المحددة. إذا كان الدمج سيعمل كبرنامج تلقائي في مجموعة، فاستخدم إذن البرنامج التلقائي لعملية الذكر بدلاً من ذلك. |
إدارة محتوى المجموعةيتيح إدارة المنشورات والتعليقات في المجموعات المحددة. write_group | استخدم هذا الإذن عند إنشاء دمج يعمل على نشر المحتوى في المجموعات، مثل تقرير أسبوعي من جانب خدمة داخلية أو برنامج تلقائي لإرسال إشعار بحالة الخدمة. |
قراءة صفحة يوميات المستخدمإمكانية عرض المنشورات التي نشرها أعضاء المجموعات على صفحة اليوميات read_user_feed | استخدم هذا الإذن عند إنشاء دمج يعمل على:
|
إدارة صفحة يوميات المستخدميتيح النشر والتعليق على صفحة اليوميات لدى أي عضو بالمجموعة write_user_feed | استخدم هذا الإذن لتمكين الدمج وإنشاء منشور أو تعديله في صفحة اليوميات التابع لأحد أعضاء المجموعة. |
البرنامج التلقائي لعملية الذكرحيثما يتم الذكر في المنشور، يمكن عرض المنشور والرد على التعليقات. bot_mention | استخدم هذا الإذن لإنشاء البرامج التلقائية في مجموعات Workplace. |
إدارة المجموعاتإنشاء المجموعات المحددة والأعضاء أو تعديلها أو إزالتها. manage_group | استخدم هذا الإذن عند إنشاء دمج يعمل على إنشاء المجموعات تلقائيًا وملء الأعضاء في المجموعة استنادًا إلى بنية المخطط التنظيمي أو مجموعات المشروع. إذا تم تحديد نطاق دمج هذا الإذن لمجموعات محددة، فلن يُسمح بإنشاء مجموعات جديدة. |
إدارة الحساباتيمكنك إدخال الحسابات أو تحديثها أو إلغاء تنشيطها عبر API إدارة الحساب. manage_accounts | استخدم هذا الإذن لأي عملية دمج مع خدمة توفير الحساب، مثل موفري بيانات تعريف الهوية أو أداة مزامنة Active Directory أو عميل API إدارة الحساب المخصص. عند تمكين هذا الإذن، سيتوفر لديك خيار تمكين الإذن "دعوة الأشخاص تلقائيًا إلى Workplace بمجرد إضافتهم باستخدام هذا الدمج". |
إدارة الشاراتيتيح منح الشارات إلى الأشخاص في مجتمع Workplace. manage_badges | استخدم هذا الإذن لتمكين الدمج من إجراء ما يلي:
|
قراءة البريد الإلكتروني للمستخدميتيح عرض عنوان بريد إلكتروني لعضو ما في المجموعة. read_user_email | يسمح لك هذا الإذن بالحصول على حساب البريد الإلكتروني المرتبط بحساب مستخدم Workplace. |
قراءة الملف الشخصي على Workplaceإمكانية وصول للقراءة فقط إلى معلومات الدليل لدى الأشخاص. read_user_work_profile | يسمح للتطبيق بالحصول على أذونات department وdivision وorganization وprimary_address وprimary_phone وtitle وgender. |
قراءة المخطط التنظيميإمكانية الوصول للقراءة فقط إلى معلومات المديرين والمرؤوسين لدى الأشخاص. read_user_org_chart | يسمح للتطبيق بالحصول على معلومات المديرين والمرؤوسين لدى الأشخاص. |
مراسلة أي عضوإمكانية إرسال رسائل الدردشة وتلقيها من أي عضو في المجتمع. message | استخدم هذا الإذن لإنشاء البرامج التلقائية في Work Chat. |
قراءة كل الرسائلإمكانية قراءة رسائل الدردشة من جانب أي عضو في المجتمع. read_all_messages | استخدم هذا الإذن لتمكين دمج الامتثال الذي سيتحقق من استخدام Workplace Chat. |
حذف رسائل الدردشةdelete_messages | استخدم هذا الإذن لتمكين التطبيق من حذف رسائل الدردشة من محادثات الشخص، مثل تنفيذ سياسة الاحتفاظ. |
قراءة سجلات الأمانإمكانية الوصول إلى تفاصيل أحداث الأمان، بما في ذلك محاولات تسجيل الدخول وطلبات إعادة تعيين كلمة السر. receive_security_logs | استخدم هذا الإذن لتمكين دمج الامتثال الذي سيتحقق من استخدام Workplace Chat. |
تسجيل الخروجإمكانية تسجيل خروج الأعضاء من كل الجلسات النشطة logout | استخدام هذا الإذن لتسجيل خروج المستخدم من Workplace |
إنشاء معاينات الرابطتوفير معاينات وافية للروابط التي تمت مشاركتها في Workplace. link_unfurling | بإمكان التطبيقات التي يتوفر لديها هذا الإذن إنشاء معاينات تمت مصادقتها للروابط التي يتم مشاركتها في Workplace. |
إدارة الملفات الشخصية في Workplaceيمكنك قراءة الملفات الشخصية وتحديثها في Workplace. manage_profiles | تجمع التطبيقات التي يتوفر لديها هذا الإذن بين أذونات القراءة read_user_work_profile وread_User_org_chart. كما تتمكن التطبيقات التي يتوفر لديها هذا الإذن تحديث معلومات الحساب (مثل: الاسم والقسم والإدارة واللقب والمؤسسة والهواتف) |
توفير حسابات المستخدمينإمكانية توفير الحسابات في Workplace. provision_accounts | بإمكان التطبيقات التي يتوفر لديها هذا الإذن توفير حسابات Workplace (غير المطالب بها) وإلغاء تنشيطها وحذفها. يسمح أيضًا هذا الإذن للتطبيق بتنفيذ التحديثات في حقول active وemail وname وhire_date وinvited member. |
قراءة عضوية المجموعةإمكانية إدراج أعضاء المجموعة وإدراج المجموعات التي ينتمي إليها المستخدم list_group_members | بإمكان التطبيقات التي يتوفر لديها هذا الإذن الاستعلام عن قائمة الأعضاء في مجموعة معينة. علاوةً على ذلك، من الممكن إدراج المجموعات التي يكون المستخدم عضوًا فيها. |
إدارة محتوى مكتبة المعرفةإمكانية إنشاء معلومات الشركة المهمة وتعديلها وحذفها في مكتبة المعرفة manage_knowledge_library | بإمكان التطبيقات التي يتوفر لديها هذا الإذن إنشاء المحتوى وتعديله ضمن مكتبة المعرفة. استخدم هذا الإذن لتمكين الدمج من إجراء ما يلي:
|
قراءة محتوى مكتبة المعرفةقراءة معلومات الشركة المهمة في مكتبة المعرفة read_knowledge_library | بإمكان التطبيقات التي يتوفر لديها هذا الإذن الوصول إلى المحتوى في مكتبة المعرفة. استخدم هذا الإذن لتمكين الدمج من إجراء ما يلي:
|
تصدير بيانات الموظفينيمكن تصدير قائمة الموظفين الحاليين وبيانات نشاطهم بتنسيق CSV. export_employee_data | بإمكان التطبيقات التي يتوفر لديها هذا الإذن جدولة عملية تصدير بيانات تعمل على إنشاء ملف CSV يتضمن كل مستخدمي Workplace. كما يتضمن ملف CSV أيضًا بيانات حول المستخدم بالإضافة إلى معلومات حول آخر استخدام لميزات Workplace. |
البرنامج التلقائي للدردشة الجماعيةتمكين البرامج التلقائية للتفاعل في دردشة جماعية. bot_group_chat | ستعمل التطبيقات التي يتوفر لديها الإذن على تمكين البرامج التلقائية من التفاعل مع الأعضاء في دردشة جماعية. استخدم هذا الإذن لتمكين الدمج وإنشاء دردشة جماعية تتضمن العديد من الأشخاص أو إدارتها. يعتمد هذا الإذن على الإذن |
إدارة الاستبياناتإمكانية إنشاء تكوين الاستبيان وتحديثه وحذفه وقراءته manage_surveys | بإمكان التطبيقات التي يتوفر لديها هذا الإذن إنشاء تكوين الاستبيان وتحديثه وحذفه وقراءته. |
قراءة الاستبياناتإمكانية قراءة تكوين الاستبيانات واستلام تحديثات webhook المتعلقة بالاستبيانات read_surveys | بإمكان التطبيقات التي يتوفر لديها هذا الإذن قراءة تكوين الاستبيانات واستلام تحديثات webhook المتعلقة بالاستبيانات. |
قراءة الاستبياناتإمكانية قراءة تكوين الاستبيانات واستلام تحديثات webhook المتعلقة بالاستبيانات read_surveys | بإمكان التطبيقات التي يتوفر لديها هذا الإذن قراءة تكوين الاستبيانات واستلام تحديثات webhook المتعلقة بالاستبيانات. |
قراءة مجموعات الأشخاصإمكانية قراءة مجموعات الأشخاص read_people_sets | بإمكان التطبيقات التي يتوفر لديها هذا الإذن عرض تكوين مجموعة الأشخاص الديناميكية والاشتراك في التحديثات المتعلقة بمجموعات الأشخاص |
إدارة مجموعات الأشخاصإمكانية إدارة مجموعات الأشخاص manage_people_sets | بإمكان التطبيقات التي يتوفر لديها هذا الإذن إنشاء مجموعات الأشخاص وتحديثها وحذفها في مجتمع Workplace |
قراءة المنشورات المهمةإمكانية قراءة المنشورات المهمة read_important_posts | يسمح للدمج بقراءة المعلومات حول عمليات ترويج المنشور المهم، سواء إعلانات الترويج النشطة حاليًا أو منتهية الصلاحية. |
إدارة المنشورات المهمةإمكانية إدارة المنشورات المهمة manage_important_posts | يتيح للدمج تحديد منشورات المجموعة باعتبارها مهمة، لتظهر في أعلى الموجز ويسمح بإيقاف عملية ترويج المنشور المهم مبكرًا. |
إزالة معلومات الملف الشخصيإمكانية إزالة المعلومات الشخصية للمستخدم الذي تم إلغاء تنشيطه. remove_profile_information | يسمح للدمج بإزالة حقول الملف الشخصي مثل الاسم وصورة الملف الشخصي لدى المستخدمين الذين تم إلغاء تنشيطهم على Workplace. |
بالنسبة إلى بعض الأذونات، من الممكن تقييد عملية الدمج بحيث يتم تمكينها على مجموعات محددة. يتيح لك ذلك تحديد نطاق وصول الدمج إلى المحتوى الذي تريد عرضه فقط.
على سبيل المثال، يمكنك السماح لدمج نشر التنبيهات بالنشر فقط في مجموعة الفريق الخاصة أو تمكين دمج تطبيق الموظفين لقراءة المحتوى فقط في مجموعات مفتوحة محددة.
لتحديد الأذونات على مستوى المجموعة في الدمج المخصص، استخدم لوحة وصول المجموعة في مربع الحوار "تعديل الدمج".
تنطبق الأذونات على مستوى المجموعة على الأذونات التالية:
يمكنك تكوين دمج بحيث يمكن تطبيق الأذونات على مستوى المجموعة إما على كل المجموعات أو مجموعات محددة كما اختار مسؤول النظام أو السماح لمسؤولي المجموعات بالتمكين للمجموعات.
عند تمكين السماح لمسؤولي المجموعات بالتمكين للمجموعات، ستظهر لمسؤول المجموعة علامة تبويب عمليات الدمج جديدة ضمن شاشة إدارة المجموعة والتي تسمح لهم بتمكين الدمج في المجموعة.
عند إنشاء تطبيق جديد في Workplace، يتم إنشاء رمز وصول لاستخدامه مع Graph API أو API إدارة الحساب أو أحداث Webhooks.
لن يتم عرض رمز الوصول هذا إلا لمرة واحدة، لذلك يجب تخزين رمز الوصول بأمان لاستخدامه لاحقًا في الرمز.
لا تنتهي صلاحية رموز تطبيق Workplace أبدًا، ولا تحتاج إلى التحديث ما لم تتم إعادة تعيينها يدويًا. إذا قمت بتعديل الأذونات المتوفرة لتطبيق معين، فسيظل الرمز الموجود يعمل ولن تحتاج إلى إنشاء رمز جديد.
إذا احتجت إلى إبطال رمز ما، فيمكنك إعادة تعيين الرمز عبر الزر إعادة تعيين رمز الوصول في مربع الحوار تعديل التطبيق. سيتم إنشاء رمز جديد وعرضه، وسيتم إبطال الرمز الموجود على الفور.
توفر رموز الوصول تحكمًا واسع النطاق. حيث تمنح الوصول إلى بيانات الشركة على Workplace. عند إنشاء تطبيق، احرص على منح أقل حد من الأذونات المطلوبة لإكمال ميزات الدمج، ولا تمنح أي أذونات غير ضرورية.
عند تخزين الرموز أو إضافتها إلى مستودعات الرموز، يجب توخي الحذر الشديد لضمان عدم مشاركتها مع الأشخاص الخطأ.
لا تضع رموز وصول الإنتاج في مستودعات الرموز العامة.
يجب ألا تحاول تخزين بيانات اعتماد API واستخدامها إلا في بيئة الخادم الخاصة ويجب ضمان عدم نسخ هذه القيم أو نقلها في مكان آخر، على سبيل المثال، إلى تطبيقات الهواتف المحمولة أو عملاء متصفح الويب.
لإضافة طبقة أمان إضافية لعمليات الدمج، يجب إضافة قائمة بيضاء لعنوان IP، والتي ستقيد استخدام الرمز ليقتصر على الخوادم التي تمت إضافتها إلى القائمة البيضاء لعناوين IP فقط.
إذا لم يعمل الدمج المخصص على إجراء أي استدعاءات باستخدام إذن معين لمدة 30 يومًا، فستتم إزالة ذلك الإذن. بعد حدوث ذلك لمرة واحدة في الدمج المخصص، سيتوفر خيار يتيح إيقاف عملية الإزالة هذه.
إذا تم تعيين اشتراك webhook صالح، فسيتم احتساب أحداث webhooks التي تم إرسالها كاستخدام للإذن ذي الصلة.
لا تنتهي صلاحية رموز الوصول في Workplace. يمكن أن تتطلب عمليات الدمج المخصصة إثبات المفتاح السري لوضع طبقة أمان إضافية. يضمن تمكين خيار "طلب إثبات المفتاح السري للتطبيق" أنه لن يتم إجراء استدعاءات API أبدًا إلا من خلال الرمز من جانب الخادم، وسيتم طلب إثبات المفتاح السري للتطبيق تنتهي صلاحيته بالإضافة إلى رمز وصول عند إجراء استدعاءات API.
لإنشاء إثبات المفتاح السري للتطبيق تنتهي صلاحيته، ستحتاج إلى ربط الرمز بطابع زمني بتنسيق unix، مفصول بعلامة الأنبوب |
، وإنشاء تشفير SHA-256 للسلسلة التي تم ربطها، باستخدام المفتاح السري للتطبيق كمفتاح. فيما يلي مثال في PHP:
$appsecret_proof = hash_hmac('sha256', $access_token.'|'.time(), $app_secret);
سترجع بعض أنظمة التشغيل ولغات البرمجة طابعًا زمنيًا في صورة رقم عشري. تأكد من تحويل القيمة إلى عدد صحيح قبل حساب إثبات المفتاح السري للتطبيق. تعمل بعض لغات البرمجة على إنشاء التجزئة في صورة كائن مشفر. تأكد من عرض التجزئة في صورة كائن سداسي عشري.
لإجراء استدعاءات API من خلال إثبات المفتاح السري للتطبيق، يمكنك إدخال التجزئة التي تم إنشاؤها عبر المعلمة appsecret_proof
، بالإضافة إلى تعيين appsecret_time
على الطابع الزمني المستخدم عند تجزئة المفتاح السري للتطبيق، مع رمز الوصول.
GET https://graph.facebook.com/v2.9/community/groups? &access_token={access-token} &appsecret_proof={appsecret_proof} &appsecret_time={appsecret_time}
سيتم اعتبار إثباتات المفتاح السري التطبيق التي تحتوي على طابع زمني منتهية الصلاحية بعد 5 دقائق، لذلك يوصى بإنشاء إثبات جديد ساري عند إجراء أي استدعاء في Graph API.
Postman هي أداة شائعة الاستخدام للتعامل مع واجهات API على الويب. قد تجد أنه من المناسب استكشاف Workplace API باستخدام Postman، لكن معلمة $appsecret_proof
تمثل تعقيدًا، نظرًا إلى أنه يجب احتساب هذه القيمة وتنتهي صلاحيتها بعد خمس دقائق، ستصبح العملية أسهل في حال قام Postman بإنشاء القيمة في وقت الطلب. في الواقع، يمكن لـ Postman إجراء ذلك باستخدام البرامج النصية للطلبات المسبقة وميزات المعلمات. يمكن استخدام هذا البرنامج النصي كنقطة بداية:
// Add to Postman's Pre-request Script Tab var access_token = "replace-me"; var app_secret = "replace-me"; var time = (new Date().getTime()/1000|0); postman.setEnvironmentVariable("access_token", access_token) postman.setEnvironmentVariable("appsecret_time", time); postman.setEnvironmentVariable("appsecret_proof", CryptoJS.HmacSHA256(access_token + '|' + time, app_secret));