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

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

"permissions"

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

"optional_permissions"

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

"content_scripts.matches"

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

"host_permissions"

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

"optional_host_permissions"

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

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

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

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

البيان

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

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
• إعادة توجيه الطلبات وعناوين الاستجابة وتعديلها باستخدام واجهة برمجة التطبيقات chrome.declarativeNetRequest

الأذونات التي تحتوي على تحذيرات

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

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

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

منح الإذن بالوصول

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

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

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

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

   

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

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

   

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

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