الإفصاح عن الأذونات

لاستخدام معظم واجهات برمجة التطبيقات والميزات الخاصة بالإضافات، عليك الإفصاح عن الغرض من الإضافة في حقول الأذونات للبيان. يمكن أن تطلب الإضافات فئات الأذونات التالية، والتي يتم تحديدها باستخدام مفاتيح البيان المعنيّة:

"permissions"

يحتوي على عناصر من قائمة سلاسل معروفة. قد تؤدي التغييرات إلى ظهور تحذير.

"optional_permissions"

يمنحها المستخدم في وقت التشغيل بدلاً من وقت التثبيت.

"content_scripts.matches"

يحتوي على أنماط مطابقة واحدة أو أكثر تسمح لبرامج النصوص الخاصة بالمحتوى بإدخالها في مضيف واحد أو أكثر. قد تؤدي التغييرات إلى ظهور تحذير.

"host_permissions"

يحتوي على أنماط مطابقة واحدة أو أكثر تتيح الوصول إلى مضيف واحد أو أكثر. قد تؤدي التغييرات إلى ظهور تحذير.

"optional_host_permissions"

يمنحها المستخدم في وقت التشغيل بدلاً من وقت التثبيت.

تساعد الأذونات في الحدّ من الضرر في حال تعرّض إضافتك لبرامج ضارة. يتم عرض بعض تحذيرات الأذونات للمستخدمين للحصول على موافقتهم قبل التثبيت أو أثناء التشغيل، كما هو موضّح بالتفصيل في الأذونات التي تتضمّن تحذيرات.

ننصحك باستخدام الأذونات الاختيارية حيثما تسمح وظائف الإضافة بذلك، وذلك لمنح المستخدمين إمكانية التحكّم بشكل مدروس في الوصول إلى الموارد والبيانات.

إذا كانت إحدى واجهات برمجة التطبيقات تتطلّب إذنًا، توضّح مستنداتها كيفية الإفصاح عنه. للاطّلاع على مثال، يُرجى الرجوع إلى Storage API.

البيان

في ما يلي مثال على قسم الأذونات في ملف بيان:

manifest.json:

{
  "name": "Permissions Extension",
  ...
  "permissions": [
    "activeTab",
    "contextMenus",
    "storage"
  ],
  "optional_permissions": [
    "topSites",
  ],
  "host_permissions": [
    "https://www.developer.chrome.com/*"
  ],
  "optional_host_permissions":[
    "https://*/*",
    "http://*/*"
  ],
  ...
  "manifest_version": 3
}

أذونات المضيف

تسمح أذونات المضيف للإضافات بالتفاعل مع أنماط المطابقة الخاصة بعنوان URL. تتطلّب بعض واجهات برمجة تطبيقات Chrome أذونات المضيف بالإضافة إلى أذونات واجهة برمجة التطبيقات الخاصة بها، والتي يتم توثيقها في كل صفحة مرجعية. وإليك بعض الأمثلة:

• إجراء طلبات fetch() من مشغّل خدمات الإضافة وصفحات الإضافة
• قراءة خصائص علامات التبويب الحسّاسة (url وtitle وfavIconUrl) وإرسال طلبات بحث عنها باستخدام واجهة برمجة التطبيقات chrome.tabs
• إدخال نص برمجي للمحتوى آليًا
• يمكنك مراقبة طلبات الشبكة والتحكّم فيها باستخدام واجهة برمجة التطبيقات chrome.webRequest.
• يمكنك الوصول إلى ملفات تعريف الارتباط باستخدام واجهة برمجة التطبيقات chrome.cookies.
• إعادة توجيه الطلبات وتعديلها وتعديل عناوين الاستجابة باستخدام واجهة برمجة التطبيقات chrome.declarativeNetRequest

الأذونات التي تتضمّن تحذيرات

عندما تطلب إضافة أذونات متعددة، ويؤدي العديد منها إلى عرض تحذيرات عند التثبيت، ستظهر للمستخدم قائمة بالتحذيرات، كما في المثال التالي:

من المرجّح أن يثق المستخدمون بإضافة لا تعرض تحذيرات كثيرة أو عندما يتم توضيح الأذونات لهم. ننصحك بتنفيذ أذونات اختيارية أو واجهة برمجة تطبيقات أقل فعالية لتجنُّب ظهور تحذيرات مقلقة. للاطّلاع على أفضل الممارسات المتعلّقة بالتحذيرات، يُرجى الاطّلاع على إرشادات تحذيرات الأذونات. يتم إدراج تحذيرات معيّنة مع الأذونات التي تنطبق عليها في قائمة المراجع الأذونات.

ستؤدي إضافة أنماط مطابقة أو تغييرها في الحقلَين "host_permissions" و"content_scripts.matches" في ملف البيان إلى ظهور تحذير أيضًا. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل الأذونات.

السماح بالوصول

إذا كانت إضافتك بحاجة إلى التشغيل على عناوين URL في file:// أو العمل في وضع التصفّح المتخفي، يجب أن يمنح المستخدمون الإضافة إذن الوصول على صفحة التفاصيل الخاصة بها. يمكنك العثور على تعليمات حول فتح صفحة التفاصيل ضمن إدارة الإضافات.

السماح بالوصول إلى عناوين URL للملفات وصفحات التصفّح المتخفي

1. انقر بزر الماوس الأيمن على رمز الإضافة في Chrome.

2. انقر على إدارة الإضافة.

   

   قائمة الإضافات

3. انتقِل للأسفل للسماح بالوصول إلى عناوين URL للملفات أو "وضع التصفّح المتخفي".

   

   تم تفعيل إمكانية الوصول إلى عناوين URL للملفات ووضع التصفّح المتخفي.

للتأكّد مما إذا كان المستخدم قد سمح بالوصول، يمكنك استدعاء extension.isAllowedIncognitoAccess() أو extension.isAllowedFileSchemeAccess().