अनुमतियों का एलान करना

ज़्यादातर एक्सटेंशन एपीआई और सुविधाओं का इस्तेमाल करने के लिए, आपको मेनिफ़ेस्ट की अनुमति वाले फ़ील्ड में अपने एक्सटेंशन के इंटेंट का एलान करना होगा. एक्सटेंशन, अनुमतियों की इन कैटगरी का अनुरोध कर सकते हैं. इन कैटगरी के बारे में, उनसे जुड़ी मेनिफ़ेस्ट कुंजियों का इस्तेमाल करके बताया जाता है:

"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
}

होस्ट की अनुमतियां

होस्ट की अनुमतियों की मदद से, एक्सटेंशन, यूआरएल के मिलते-जुलते पैटर्न के साथ इंटरैक्ट कर सकते हैं. कुछ Chrome API को अपनी एपीआई अनुमतियों के साथ-साथ होस्ट की अनुमतियों की भी ज़रूरत होती है. इनकी जानकारी हर रेफ़रंस पेज पर दी जाती है. यहां कुछ उदाहरण दिए गए हैं:

• एक्सटेंशन सर्विस वर्कर और एक्सटेंशन पेजों से fetch() अनुरोध करें.
• chrome.tabs एपीआई का इस्तेमाल करके, संवेदनशील टैब प्रॉपर्टी (यूआरएल, टाइटल, और favIconUrl) पढ़ें और उनके बारे में क्वेरी करें.
• कॉन्टेंट स्क्रिप्ट को प्रोग्राम के हिसाब से इंजेक्ट करें.
• chrome.webRequest एपीआई की मदद से, नेटवर्क अनुरोधों को मॉनिटर और कंट्रोल करें.
• chrome.cookies एपीआई की मदद से कुकी ऐक्सेस करें.
• chrome.declarativeNetRequest एपीआई का इस्तेमाल करके, अनुरोध और रिस्पॉन्स हेडर को रीडायरेक्ट करें और उनमें बदलाव करें.

चेतावनियों वाली अनुमतियां

जब कोई एक्सटेंशन कई अनुमतियों का अनुरोध करता है और उनमें से कई अनुमतियां दिखती हैं ऐप्लिकेशन इंस्टॉल करते समय मिली चेतावनियों के बारे में, उपयोगकर्ता को चेतावनियों की सूची दिखेगी, जैसा कि इस उदाहरण में दिखाया गया है:

जब उपयोगकर्ताओं को सीमित चेतावनियों वाले एक्सटेंशन या अनुमतियों के बारे में ज़्यादा जानकारी दी जाती है, तो उन पर भरोसा करने की संभावना ज़्यादा होती है बहुत आसान है. अलार्म से बचने के लिए, वैकल्पिक अनुमतियां या कोई कम असरदार एपीआई लागू करें चेतावनियां. चेतावनियों से जुड़े सबसे सही तरीके जानने के लिए, अनुमति से जुड़ी चेतावनियों के दिशा-निर्देश देखें. खास चेतावनियां उन अनुमतियों के साथ मौजूद होती हैं जिन पर वे अनुमतियों की पहचान सूची.

"host_permissions" और "content_scripts.matches" में मिलान पैटर्न जोड़ना या बदलना के फ़ील्ड में भी चेतावनी मिलेगी. इस बारे में ज़्यादा जानने के लिए, यह देखें अनुमतियां अपडेट की जा रही हैं.

ऐक्सेस करने की अनुमति दें

अगर आपके एक्सटेंशन को file:// यूआरएल पर चलाना है या गुप्त मोड में काम करना है, तो उपयोगकर्ताओं को इसके ज़्यादा जानकारी वाले पेज पर जाकर, एक्सटेंशन का ऐक्सेस देना होगा. अपने एक्सटेंशन मैनेज करें में जाकर, ज़्यादा जानकारी वाला पेज खोलने के निर्देश देखे जा सकते हैं.

फ़ाइल के यूआरएल और गुप्त पेजों को ऐक्सेस करने की अनुमति दें

1. Chrome में एक्सटेंशन आइकॉन पर राइट क्लिक करें.

2. एक्सटेंशन मैनेज करें चुनें.

   

3. फ़ाइल के यूआरएल या गुप्त मोड का ऐक्सेस चालू करने के लिए, नीचे की ओर स्क्रोल करें.

   

यह पता लगाने के लिए कि उपयोगकर्ता ने ऐक्सेस दिया है या नहीं, extension.isAllowedIncognitoAccess() पर कॉल करें या extension.isAllowedFileSchemeAccess().