بيان الأذونات

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

"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 والعنوان وfavIconUrl) وإجراء طلبات بحث عنها باستخدام واجهة برمجة التطبيقات chrome.tabs
• إدخال نص برمجي للمحتوى آليًا
• يمكنك تتبُّع طلبات الشبكة والتحكّم فيها من خلال chrome.webRequest API.
• الوصول إلى ملفات تعريف الارتباط باستخدام chrome.cookies API
• يمكنك إعادة توجيه الطلبات وعناوين الردود وتعديلها باستخدام chrome.declarativeNetRequest API.

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

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

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

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

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

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

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

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

2. اختَر إدارة الإضافة.

   

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

   

لمعرفة ما إذا كان المستخدم قد سمح بالوصول إلى الحساب، يمكنك الاتصال بـ extension.isAllowedIncognitoAccess() أو extension.isAllowedFileSchemeAccess()