כדי להשתמש ברוב התכונות של Chrome.* ממשקי API, התוסף או האפליקציה צריכים להצהיר על הכוונה שלהם בשדה 'permissions' בmanifest. כל הרשאה יכולה להיות מחרוזת מתוך רשימה מוגדרת של מחרוזות מוכרות (כמו 'geolocation') או דפוס התאמה שמעניק גישה למארח אחד או יותר. ההרשאות עוזרות להגביל את הנזק אם התוסף או האפליקציה נחשפו לתוכנה זדונית. חלק מההרשאות מוצגות למשתמשים גם לפני ההתקנה, כפי שמתואר בקטע אזהרות לגבי הרשאות.
אם API מחייב להצהיר על הרשאה במניפסט, במסמכי העזרה שלו מוסבר איך לעשות זאת. לדוגמה, בדף אחסון מוסבר איך להצהיר על ההרשאה 'אחסון'.
דוגמה לחלק של ההרשאות בקובץ מניפסט:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
בטבלה הבאה מפורטות ההרשאות הזמינות כרגע:
| הרשאה | תיאור |
|---|---|
"activeTab" |
הבקשה להענקת הרשאות לתוסף בהתאם למפרט activeTab. |
"alarms" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.alarms. |
"background" |
הפעלה מוקדמת של Chrome וכיבוי מאוחר שלו, כדי להאריך את חיי האפליקציות והתוספים. כשלאפליקציה מתארחת, לאפליקציה בחבילה או לתוסף מותקנים יש הרשאת 'רקע', Chrome פועל (באופן בלתי נראה) ברגע שהמשתמש מתחבר למחשב – לפני שהמשתמש מפעיל את Chrome. ההרשאה 'רקע' גם מאפשרת ל-Chrome להמשיך לפעול (גם אחרי שהחלון האחרון שלו נסגר) עד שהמשתמש ייסגר אותו באופן מפורש. הערה: אפליקציות ותוספים מושבתים נחשבים כאילו הם לא מותקנים.
בדרך כלל משתמשים בהרשאה 'רקע' עם דף רקע, דף אירוע או (באפליקציות מתארחות) חלון רקע. |
"bookmarks" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.bookmarks. |
"browsingData" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.browsingData. |
"certificateProvider" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.certificateProvider. |
"clipboardRead" |
חובה אם התוסף או האפליקציה משתמשים ב-document.execCommand('paste'). |
"clipboardWrite" |
מציין שהתוסף או האפליקציה משתמשים ב-document.execCommand('copy') או ב-document.execCommand('cut'). ההרשאה הזו נדרשת לאפליקציות מתארחות, ומומלצת לתוספים ולאפליקציות בחבילה. |
"contentSettings" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.contentSettings. |
"contextMenus" |
מעניק לתוסף גישה לממשק ה-API chrome.contextMenus. |
"cookies" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.cookies. |
"debugger" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.debugger. |
"declarativeContent" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.declarativeContent. |
"declarativeNetRequest" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.declarativeNetRequest. |
"declarativeNetRequestFeedback" |
הרשאה שמעניקה לתוסף גישה לאירועים ולשיטות ב-API chrome.declarativeNetRequest, שמחזירים מידע על התאמה של כללים דמוקרטיביים. |
"declarativeWebRequest" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.declarativeWebRequest. |
"desktopCapture" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.desktopCapture. |
"documentScan" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.documentScan. |
"downloads" |
הרשאה שמעניקה לתוסף גישה ל-API של chrome.downloads. |
"enterprise.deviceAttributes" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.enterprise.deviceAttributes. |
"enterprise.hardwarePlatform" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.enterprise.hardwarePlatform. |
"enterprise.networkingAttributes" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.enterprise.networkingAttributes. |
"enterprise.platformKeys" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.enterprise.platformKeys. |
"experimental" |
חובה אם התוסף או האפליקציה משתמשים ב-chrome.experimental.* ממשקי API. |
"fileBrowserHandler" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.fileBrowserHandler. |
"fileSystemProvider" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.fileSystemProvider. |
"fontSettings" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.fontSettings. |
"gcm" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.gcm. |
"geolocation" |
מאפשרת לתוסף או לאפליקציה להשתמש ב-Geolocation API בלי לבקש מהמשתמש הרשאה. |
"history" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.history. |
"identity" |
הרשאה שמעניקה לתוסף גישה ל-API של chrome.identity. |
"idle" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.idle. |
"loginState" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.loginState. |
"management" |
מעניק לתוסף גישה ל-API chrome.management. |
"nativeMessaging" |
הרשאה שמעניקה לתוסף גישה ל-Messaging API. |
"notifications" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.notifications. |
"pageCapture" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.pageCapture. |
"platformKeys" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.platformKeys. |
"power" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.power. |
"printerProvider" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.printerProvider. |
"printing" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.printing. |
"printingMetrics" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.printingMetrics. |
"privacy" |
הרשאה שמעניקה לתוסף גישה ל-API של chrome.privacy. |
"processes" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.processes. |
"proxy" |
הרשאה שמעניקה לתוסף גישה ל-API של chrome.proxy. |
"scripting" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.scripting. |
"search" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.search. |
"sessions" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.sessions. |
"signedInDevices" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.signedInDevices. |
"storage" |
מעניק לתוסף גישה ל-API chrome.storage. |
"system.cpu" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.system.cpu. |
"system.display" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.system.display. |
"system.memory" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.system.memory. |
"system.storage" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.system.storage. |
"tabCapture" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.tabCapture. |
"tabGroups" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.tabGroups. |
"tabs" |
הרשאה שמעניקה לתוסף גישה לשדות עם הרשאות של אובייקטים מסוג Tab שמשמשים כמה ממשקי API, כולל chrome.tabs ו-chrome.windows. במקרים רבים, לא תצטרכו להצהיר על ההרשאה "tabs" כדי להשתמש בממשקי ה-API האלה. |
"topSites" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.topSites. |
"tts" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.tts. |
"ttsEngine" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.ttsEngine. |
"unlimitedStorage" |
מכילה מכסה בלתי מוגבלת לשמירת נתונים מצד הלקוח, כמו מסדי נתונים וקבצים באחסון המקומי.
בלי ההרשאה הזו, נפח האחסון המקומי של התוסף או האפליקציה מוגבל ל-5MB. הערה: ההרשאה הזו חלה רק על מסד נתוני SQL באינטרנט ועל מטמון האפליקציה (ראו בעיה 58985). בנוסף, בשלב זה הוא לא פועל עם תת-דומיינים עם תווים כלליים לחיפוש, כמו
http://*.example.com. |
"vpnProvider" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.vpnProvider. |
"wallpaper" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.wallpaper. |
"webNavigation" |
הרשאה שמעניקה לתוסף גישה ל-API chrome.webNavigation. |
"webRequest" |
הרשאה שמעניקה לתוסף גישה לממשק ה-API chrome.webRequest. |
"webRequestBlocking" |
נדרש אם התוסף משתמש ב-API chrome.webRequest באופן חוסם. |