نظرة عامة
يمكن لمسؤولي مساحة العمل المشتركة استخدام ضوابط SharePoint للسماح بمجموعات المواقع المعتمدة، وحظر مجموعات مواقع محددة، واستثناء الملفات المدعومة التي تحمل تسميات حساسية محددة من Microsoft Purview.
يمكن أن تحتوي مجموعة مواقع SharePoint، التي تُسمى أيضًا SPSite، على عدة مواقع. تنطبق قاعدة المجموعة على المجموعة بأكملها، مع مراعاة أذونات Microsoft الحالية لكل مستخدم. ولا تمنح المستخدم حق الوصول إلى محتوى لا يمكنه الوصول إليه في Microsoft 365.
تنطبق قيود المواقع على عمليات البحث والتصفح واسترجاع الملفات والقراءة والكتابة المدعومة في SharePoint. تُدار إمكانية الوصول إلى OneDrive بشكل منفصل.
اختر وضع الوصول الذي يتوافق مع سياستك:
المواقع المسموح بها: عندما تكون قائمة السماح غير فارغة، لا يمكن للمستخدمين الوصول عبر التطبيق إلا إلى مجموعات المواقع المدرجة فيها.
المواقع المحظورة: يمكن للمستخدمين الوصول إلى مجموعات المواقع غير المدرجة في قائمة الحظر، وفقًا لأذوناتهم في Microsoft.
لا يمكن أن تحتوي على إدخالات إلا قائمة واحدة في كل مرة. لا تؤدي قائمة السماح الفارغة إلى حظر جميع المواقع. عندما تكون القائمتان فارغتين، تُزال قيود مواقع SharePoint؛ وتظل أذونات Microsoft والضوابط الأخرى التي تم إعدادها سارية.
التوفر
يجب تفعيل الضوابط وواجهة API لإدارة مساحة العمل المشتركة حتى تتمكن من استخدامها في مساحتك. تشمل الضوابط المتاحة قوائم السماح بمجموعات المواقع، وقوائم حظر مجموعات المواقع، واستيراد المواقع من ملفات CSV، والاستثناءات حسب تسميات الحساسية.
تنطبق القواعد على مجموعات المواقع بأكملها. لا تشمل ضوابط مجموعات المواقع هذه تحديد النطاق على مستوى موقع فردي أو مجلد أو ملف بعينه، ولا فرض أذونات Microsoft Sites.Selected.
قبل البدء
حدد مجموعات المواقع التي تريد مؤسستك السماح بها أو حظرها.
احصل على معرّف GUID لكل مجموعة. يحتوي معرّف الموقع الكامل في Microsoft Graph على معرّف GUID للمجموعة في موضع القيمة الوسطى. تستخدم واجهة API للإدارة معرّفات GUID للمجموعات؛ ويمكن لأداة استيراد CSV في واجهة المستخدم أيضًا استخراجها من معرّفات المواقع ثلاثية الأجزاء في Graph.
فعّل أذونات Microsoft التي يتطلبها تطبيق SharePoint في كلٍّ من إعدادات الأذونات في ChatGPT وMicrosoft Entra، بما في ذلك
Sites.Read.AllوFiles.Read.All. تُصفّي هذه الضوابط الوصول من جانب OpenAI؛ ولا تحل محل أذونات Microsoft المفوّضة.لإعداد الاستثناءات حسب تسميات الحساسية، اطلب من مسؤول Microsoft 365 أو Purview معرّف GUID الثابت لكل تسمية لا تطبّق التشفير.
للإدارة عبر واجهة API، احصل على معرّف UUID لمساحة العمل المشتركة ومفتاح إدارة مساحة العمل المشتركة في ChatGPT، ورمز Microsoft Graph إذا كنت بحاجة إلى استخراج المعرّفات من عناوين URL لمواقع SharePoint. لكلٍّ من بيانات الاعتماد هذين غرض مختلف.
حول دليل الأمثلة البرمجية من OpenAI
دليل الأمثلة البرمجية من OpenAI هو مجموعة من أمثلة الشيفرات والأدلة التي تتيحها OpenAI للعامة. تستند هذه المقالة إلى دليل الوصول إلى مواقع SharePoint والبرنامج النصي للإدارة بلغة Python الواردَين فيه، وكلاهما مستضاف على GitHub. يمكنك فتح هذه الروابط في متصفحك لقراءة الملفات. لتشغيل البرنامج النصي، نزّله واتّبع تعليمات الإعداد والأوامر الواردة في الدليل.
في هذه المقالة، يُقصد بعبارة «دليل الأمثلة البرمجية» دليل SharePoint المذكور، وبعبارة «أداة دليل الأمثلة البرمجية» برنامج Python النصي المشار إليه بالرابط. استخدم هذه المراجع للاطّلاع على أمثلة الأوامر وإدارة قوائم السماح عبر واجهة API.
إعداد بيانات الاعتماد للإدارة عبر واجهة API
ملاحظة: يجب أن تكون مسؤولًا عن مساحة عمل مشتركة لتتمكن من إنشاء مفاتيح الإدارة. اقرأ المزيد.
إنشاء مفتاح إدارة لمساحة العمل المشتركة في ChatGPT
افتح وحدة تحكم إدارة ChatGPT وحدد مساحة العمل المشتركة المقصودة.
انتقل إلى بيانات الاعتماد واختر مفاتيح الإدارة.
أنشئ مفتاحًا بأذونات مقيّدة، واضبط التطبيقات على الكتابة.
احفظ المفتاح في مكان آمن. يتيح هذا المفتاح قراءة سياسة SharePoint الخاصة بمساحة العمل المشتركة وتغييرها.
الإذن المطلوب هو chatgpt.enterprise.apps.write. لاحظ أن مفتاح منصّة الـ API ورمز Microsoft Graph لا يمكن أن يحل أيٌّ منهما محل مفتاح إدارة مساحة العمل المشتركة في ChatGPT.
لمزيد من المعلومات، راجع: إدارة مفاتيح الإدارة في علامة تبويب بيانات الاعتماد. للاطّلاع على متغيرات البيئة لبيانات اعتماد البرنامج النصي ومثال على الإدخال الآمن، راجع تعليمات بيانات الاعتماد في دليل الأمثلة البرمجية.
الحصول على رمز Microsoft Graph
استخدم آلية المصادقة لدى Microsoft المعتمدة في مؤسستك. لإجراء بحث تفاعلي، إذا كانت مؤسستك تسمح باستخدام Graph Explorer:
افتح Microsoft Graph Explorer وسجّل الدخول بحساب عمل في المستأجر الذي يحتوي على مواقع SharePoint.
حدد الأذونات اللازمة لقراءة المواقع، وهي عادةً
Sites.Read.All، باستخدام تعديل الأذونات أو الموافقة على الأذونات. اطلب من مسؤول Microsoft الموافقة على الوصول إذا كانت مؤسستك تشترط ذلك.افتح علامة تبويب رمز الوصول وانسخ الرمز لاستخدامه مع Microsoft Graph.
للاطّلاع على تعليمات Microsoft، راجع استخدام Graph Explorer.
يُستخدم رمز Graph لاستخراج المعرّفات من عناوين URL لمواقع SharePoint. ويُستخدم مفتاح إدارة ChatGPT لقراءة سياسة ChatGPT أو تحديثها. لا تحتاج أداة دليل الأمثلة البرمجية إلى رمز Graph إلا للأوامر التي تستخرج المعرّفات من عناوين URL؛ أما قراءة قائمة سماح حالية أو إفراغها فلا يتطلب سوى مفتاح إدارة ChatGPT.
لا تضع أيًّا من بيانات الاعتماد هذين في نظام التحكم في إصدارات الشيفرة أو المستندات المشتركة أو لقطات الشاشة أو السجلات.
العثور على معرّف GUID لمجموعة مواقع
استخدام عنوان URL لموقع SharePoint
افتح موقع SharePoint بعد تسجيل الدخول إلى Microsoft بحساب يمكنه الوصول إليه.
أضف
/_api/site/idإلى نهاية عنوان URL للموقع. على سبيل المثال، استخدمhttps://contoso.sharepoint.com/sites/Finance/_api/site/id.انسخ معرّف GUID الوارد في الاستجابة.
ملاحظة: النطاقات والمعرّفات الواردة في أمثلة هذه المقالة هي قيم نائبة.
استخدام Microsoft Graph
يُرجع Microsoft Graph معرّف موقع يتكوّن من ثلاثة أجزاء تفصل بينها فواصل: اسم المضيف، ومعرّف GUID لمجموعة المواقع، ومعرّف GUID للموقع. استخدم القيمة الوسطى لقاعدة مجموعة المواقع. قد تشير عناوين URL مختلفة للمواقع إلى معرّف GUID لمجموعة واحدة.
للاطّلاع على أمثلة البحث والمعرّفات، راجع فهم معرّفات مواقع SharePoint. لاستخراج المعرّفات من عدة عناوين URL دون تغيير سياسة ChatGPT، استخدم تعليمات الفحص في دليل الأمثلة البرمجية والبرنامج النصي للإدارة بلغة Python.
لمعرفة متطلبات البحث لدى Microsoft، راجع الحصول على موقع SharePoint باستخدام المسار.
إدارة مجموعات المواقع المسموح بها والمحظورة
استخدام ضوابط مساحة العمل المشتركة
افتح ضوابط السلامة والأمان لتطبيق SharePoint في مساحة العمل المشتركة.
ضمن وضع الوصول، اختر المواقع المسموح بها أو المواقع المحظورة.
أضف مجموعات المواقع إلى القائمة المحددة. يمكنك أيضًا استخدام ميزة رفع ملف CSV الموضّحة أدناه.
راجع التغييرات واختر حفظ.
تحقق من السياسة المحفوظة واختبر الإعدادات.
تظهر المواقع المضافة عبر واجهة API للإدارة في ضوابط مساحة العمل المشتركة. وتتوفر المواقع المضافة في واجهة المستخدم أيضًا عبر واجهة API. يمكنك إضافة الإدخالات أو إزالتها عبر أيٍّ من الواجهتين؛ فطريقة إضافة الموقع لا تُلزمك بإدارته بالطريقة نفسها.
التبديل بين المواقع المسموح بها والمحظورة
لا يمكن أن تحتوي على إدخالات إلا قائمة واحدة في كل مرة. قبل إضافة إدخالات في الوضع الآخر، أفرغ القائمة الحالية واحفظ هذا التغيير. ثم اختر الوضع الآخر، وأضف المجموعات المقصودة، واحفظ مرة أخرى.
يؤدي إفراغ القائمة النشطة إلى تغيير الوصول فور حفظ التغيير. يؤدي إفراغ قائمة السماح إلى إزالة قيد الوصول إلى المواقع الذي تفرضه؛ ويؤدي إفراغ قائمة الحظر إلى إزالة الحظر الذي تفرضه. خطّط للانتقال بالتنسيق مع المسؤولين الآخرين، لأن الفترة بين إفراغ إحدى القائمتين وحفظ الأخرى قد تتيح وصولًا ستقيّده سياستك النهائية.
رفع مجموعات المواقع من ملف CSV
يدعم رفع ملفات CSV مجموعات المواقع فقط. لاستثناء ملفات حسب تسمية الحساسية، أضف معرّفات GUID للتسميات ضمن تسميات الحساسية المستثناة بدون تشفير.
افتح ضوابط السلامة والأمان واختر وضع الوصول المقصود.
جهّز ملف CSV يحتوي على معرّفات GUID لمجموعات المواقع أو معرّفات المواقع ثلاثية الأجزاء من Microsoft Graph. استخدم تنسيقًا واحدًا للمعرّفات في الملف بأكمله.
اختر رفع ملف CSV وحدد الملف.
راجع نتيجة الاستيراد والقائمة المحددة. عالج أي أخطاء أو تحذيرات تخص الصفوف قبل المتابعة.
اختر حفظ لتطبيق التغييرات، ثم تحقق من القائمة المحفوظة.
متطلبات ملفات CSV وآلية عمل الاستيراد:
الحد الأقصى لحجم الملف: 1 ميغابايت.
عناوين الأعمدة اختيارية.
استخدم معرّف GUID لمجموعة واحدة في كل صف، أو معرّفات المواقع ثلاثية الأجزاء من Graph. يمكن وضع المعرّف ثلاثي الأجزاء بين علامتَي اقتباس في حقل واحد أو توزيع أجزائه على ثلاثة أعمدة.
تُحوَّل معرّفات Graph ثلاثية الأجزاء إلى معرّفات GUID للمجموعات. لا يؤدي استيراد معرّف ثلاثي الأجزاء إلى إنشاء قاعدة تخص موقعًا بعينه.
تُضاف العناصر المستوردة إلى القائمة المحددة مع الاحتفاظ بالإدخالات الحالية. تُزال تكرارات المجموعات؛ ويعرض عدد العناصر المستوردة المجموعات المضافة حديثًا.
تُرفض التنسيقات المختلطة والصفوف ذات التنسيق غير الصحيح. يؤدي رفع ملف لا يحتوي إلا على عناوين URL للمواقع إلى عرض تحذير دون إضافة مواقع. استخرج أولًا معرّفات GUID للمجموعات من عناوين URL.
يغيّر الرفع مسودة القائمة فقط. ولا يُحدّث الوصول في مساحة العمل المشتركة حتى تختار حفظ.
تُستخدم ميزة رفع ملف CSV الموضّحة هنا لإدارة مجموعات المواقع. اضبط الاستثناءات حسب تسميات الحساسية بشكل منفصل.
إذا كان لديك ملف CSV يحتوي على عناوين URL لمواقع SharePoint، فيمكنك استخدام سير عمل CSV في أداة دليل الأمثلة البرمجية لاستخراج معرّفاتها وإدارة قائمة سماح عبر واجهة API. يختلف إدخال site_url أو url في الأداة، من حيث التنسيق وسير العمل، عن رفع المعرّفات في واجهة المستخدم.
فهم حدود السياسة والطلبات
الحد الافتراضي للسياسة هو 10,000 مجموعة مواقع. تتطلب الحدود الأعلى لسياسة مساحة العمل المشتركة، التي تصل إلى 120,000 مجموعة مواقع، تفعيلًا من OpenAI؛ تواصل مع فريق OpenAI المسؤول عن مؤسستك قبل التخطيط لنشر أوسع نطاقًا.
تقبل عمليات التعديل الفردية عبر واجهة API والبرنامج النصي الحالي في دليل الأمثلة البرمجية ما يصل إلى 10,000 معرّف GUID للمجموعات في كل طلب. لا تؤدي زيادة حد سياسة مساحة العمل المشتركة إلى رفع هذا الحد الخاص بكل طلب. احسب مجموعات المواقع الفريدة، لا عناوين URL المصدرية: فقد تشير عدة عناوين URL إلى المجموعة نفسها.
استخدام واجهة API لإدارة مساحة العمل المشتركة
استخدم معرّف UUID لمساحة العمل المشتركة ومفتاح إدارة مساحة العمل المشتركة في ChatGPT مع https://api.chatgpt.com.
للاطّلاع على أوامر قائمة السماح وأمثلة الطلبات التي تُحدَّث باستمرار، استخدم دليل الأمثلة البرمجية:
معاينة مجموعات المواقع وإضافتها. تحافظ عمليات الإضافة على المجموعات المسموح بها حاليًا.
راجع السياسة الحالية قبل إجراء تغييرات، ثم اقرأها مجددًا واختبر الوصول الناتج. تؤدي إزالة آخر مجموعة مسموح بها أو إفراغ قائمة السماح إلى إزالة قيد الوصول إلى المواقع الذي تفرضه القائمة. لا ترسل طلب إضافة فارغًا إلا إذا كنت تقصد إزالة القيود التي تفرضها قائمة السماح.
تدير أداة دليل الأمثلة البرمجية المتاحة للعامة حاليًا قوائم السماح فقط. ولا تدير قوائم الحظر أو الاستثناءات حسب تسميات الحساسية. استخدم ضوابط مساحة العمل المشتركة الموضّحة أعلاه لتنفيذ تلك المهام.
استثناء الملفات التي تحمل تسميات حساسية
العثور على معرّف GUID للتسمية
اطلب من مسؤول Microsoft 365 أو Purview معرّف GUID الثابت للتسمية المقصودة. استخدم معرّف GUID، وليس اسم العرض الخاص بالتسمية.
يمكن للمسؤول عرض قائمة التسميات عبر Microsoft Graph. يحتاج الرمز إلى الإذن المناسب، إما SensitivityLabel.Read أو SensitivityLabels.Read.All. طابق اسم التسمية المقصودة مع معرّفها، وتحقق من إعدادات الحماية الخاصة بها.
للاطّلاع على المتطلبات والأمثلة، راجع عرض قائمة تسميات الحساسية وخصائص تسمية الحساسية. أذونات التسميات هذه منفصلة عن إذن قراءة المواقع المستخدم لاستخراج المعرّفات من عناوين URL لمواقع SharePoint.
إضافة استثناءات حسب التسميات
افتح ضوابط السلامة والأمان لتطبيق SharePoint.
أدخل معرّف GUID لكل تسمية لا تطبّق التشفير ضمن تسميات الحساسية المستثناة بدون تشفير.
احفظ الإعدادات واختبر ملفًا مدعومًا يحمل التسمية المستثناة.
تُستثنى الملفات التي تحمل تسميات مدعومة مطابقة من نتائج تطبيق SharePoint. أما الملفات التي تحمل تسميات تطبّق التشفير، فهي مستثناة أصلًا بشكل افتراضي.
اختبار الإعدادات
استخدم ملفات وحسابات اختبار معتمدة من مؤسستك. قبل الاختبار، تأكد من أن حساب Microsoft نفسه يمكنه الوصول إلى كل ملف مباشرةً في SharePoint.
في وضع المواقع المسموح بها مع قائمة غير فارغة، اختبر ملفًا في مجموعة مسموح بها وملفًا في مجموعة غير مدرجة. ينبغي أن يكون الوصول عبر التطبيق متاحًا للمجموعة المسموح بها فقط.
في وضع المواقع المحظورة، اختبر ملفًا في مجموعة محظورة وملفًا في مجموعة غير محظورة. ينبغي ألا تكون المجموعة المحظورة متاحة؛ أما المجموعة غير المحظورة فتظل خاضعة لأذونات Microsoft والضوابط الأخرى.
اختبر ملف اختبار مدعومًا يحمل تسمية حساسية مستثناة. ينبغي ألا يظهر في نتائج التطبيق.
بعد إجراء تغيير عبر واجهة API، قارن القائمة المحفوظة في واجهة المستخدم بالسياسة التي تُرجعها واجهة API.
بعد رفع ملف CSV، احفظ التغييرات وأعِد فتح الضوابط للتأكد من الاحتفاظ بالمجموعات المقصودة.
إذا اختلفت النتائج عن السياسة المقصودة، فتحقق من مساحة العمل المشتركة ووضع الوصول المحدد والقائمة المحفوظة ومعرّفات GUID للمجموعات والتسميات ونوع الملف المدعوم وأذونات المستخدم في Microsoft. لا تُفرغ قائمة بغرض استكشاف الأخطاء وإصلاحها إلا إذا كنت تقصد إجراء التغيير الناتج في الوصول.
للحصول على مساعدة بشأن غياب بعض الضوابط أو إتاحة وصول غير متوقع، راجع: التواصل مع دعم OpenAI. لا تُدرج مفاتيح الإدارة أو رموز Microsoft Graph في طلب الدعم.
فهم القيود
تشمل قاعدة المجموعة مجموعة المواقع بأكملها. ولا يمكنها حصر الوصول في موقع فرعي أو مجلد أو ملف معيّن.
لا تقيّد القيود المفروضة على مواقع SharePoint الوصول إلى OneDrive تلقائيًا.
لا تُطبَّق التصفية حسب تسميات الحساسية إلا عندما يتيح Microsoft Graph البيانات الوصفية للتسميات المدعومة، بما في ذلك مستندات Office وملفات PDF وMP4 المدعومة.
تُعامَل أنواع الملفات التي لا تدعم تسميات الحساسية، مثل ملفات TXT وCSV، على أنها بلا تسميات. ويظل الوصول إليها متاحًا إذا كانت الأذونات والضوابط الأخرى تسمح بذلك. هذا القيد المتعلق بنوع الملف منفصل عن رفع ملف CSV لضبط الوصول إلى المواقع.
لا يتيح رفع ملف CSV ولا أداة الأمثلة المتاحة للعامة ضبط الاستثناءات حسب تسميات الحساسية. لا توثّق هذه المقالة واجهة API لإدارة التسميات بشكل مجمّع.
لا يغني حفظ السياسة أو نجاح استجابة واجهة API عن اختبار الوصول باستخدام الحساب المقصود.
استخدام أداة الإدارة بلغة Python
تتوفر الشيفرة الكاملة للمثال وأوامره، مع تحديثها باستمرار، في دليل الأمثلة البرمجية من OpenAI:
استخدم Python 3.10 أو إصدارًا أحدث. تستخدم الأداة مكتبة Python القياسية. اقرأ الدليل قبل تشغيل الأداة، واستخدم التشغيل التجريبي لمراجعة التغييرات دون تطبيقها.
تقرأ الأداة الحالية بيانات الاعتماد من متغيرات البيئة؛ اتّبع تعليمات الإدخال الآمن الواردة في الدليل. تتطلب الأداة تأكيدًا صريحًا لإفراغ قائمة السماح. يمكن تنفيذ عملية إزالة دون هذا التأكيد، لذا راجعها أولًا باستخدام التشغيل التجريبي.
لمعرفة سلوك إعادة المحاولة ومفاتيح منع تكرار التنفيذ الاختيارية، راجع إعادة محاولة تحديث السياسة بأمان. استخدم مفاتيح منع تكرار التنفيذ فقط إذا كانت مساحة العمل المشتركة تدعمها، وافحص السياسة الحالية بعد أي فشل غير واضح النتيجة.
لا تفعّل الأداة ميزات مساحة العمل المشتركة ولا تتحقق من تطبيق السياسة فعليًا. تستخدم اختبارات الأداة دون اتصال استدعاءات محاكاة لكلٍّ من Microsoft Graph وواجهة API لإدارة ChatGPT.
لا تُنفَّذ التغييرات التي تتطلب عدة طلبات كوحدة واحدة غير قابلة للتجزئة. إذا فشلت عملية إزالة عدة مجموعات في أثناء التنفيذ، فقد تكون عمليات الإزالة السابقة قد نجحت بالفعل. اقرأ السياسة الحالية قبل إعادة المحاولة.
الأسئلة الشائعة
هل تحل ضوابط المواقع محل أذونات Microsoft؟
لا. يظل التطبيق يستخدم أذونات Microsoft الخاصة بكل مستخدم. تطبّق OpenAI تصفية المواقع وفق الإعدادات المحددة قبل عرض الاستجابات على المستخدم والنموذج.
هل تحظر قائمة السماح الفارغة جميع المواقع؟
لا. لا تعني قائمة السماح الفارغة «حظر الجميع». وإذا كانت قائمة الحظر تحتوي على إدخالات، فتظل تلك المجموعات محظورة. عندما لا تحتوي أيٌّ من القائمتين على إدخالات، تتحدد إمكانية الوصول وفق أذونات المستخدمين في Microsoft والضوابط الأخرى التي تم إعدادها.
هل تُسجَّل التغييرات التي تُجرى عبر واجهة API للإدارة؟
تُسجَّل تغييرات السياسة التي تُجرى عبر واجهة API للإدارة في سجلات التدقيق والامتثال لمساحة العمل المشتركة.