OLD | NEW |
1 <div id="pageData-name" class="pageData">Permission Warnings</div> | 1 <h1>Permission Warnings</h1> |
2 <div id="pageData-showTOC" class="pageData">true</div> | 2 |
3 | 3 |
4 <!-- | 4 <!-- |
5 NOTE: When this doc is updated, the online help should also be updated: | 5 NOTE: When this doc is updated, the online help should also be updated: |
6 http://www.google.com/support/chrome_webstore/bin/answer.py?hl=en&answer=186213 | 6 http://www.google.com/support/chrome_webstore/bin/answer.py?hl=en&answer=186213 |
7 | 7 |
8 We should periodically look at | 8 We should periodically look at |
9 http://src.chromium.org/viewvc/chrome/trunk/src/chrome/app/generated_resources.g
rd?view=markup | 9 http://src.chromium.org/viewvc/chrome/trunk/src/chrome/app/generated_resources.g
rd?view=markup |
10 to make sure that we're covering all messages. Search for | 10 to make sure that we're covering all messages. Search for |
11 IDS_EXTENSION_PROMPT_WARNING | 11 IDS_EXTENSION_PROMPT_WARNING |
12 (e.g. IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY). | 12 (e.g. IDS_EXTENSION_PROMPT_WARNING_BROWSING_HISTORY). |
(...skipping 19 matching lines...) Expand all Loading... |
32 </p> | 32 </p> |
33 | 33 |
34 | 34 |
35 <h2 id="examples"> Examples of permission warnings </h2> | 35 <h2 id="examples"> Examples of permission warnings </h2> |
36 | 36 |
37 <p> | 37 <p> |
38 Here's a typical dialog | 38 Here's a typical dialog |
39 that a user might see when installing an extension: | 39 that a user might see when installing an extension: |
40 </p> | 40 </p> |
41 | 41 |
42 <img src="../images/perms-hw1.png" | 42 <img src="{{static}}/images/perms-hw1.png" |
43 width="410" height="193" | 43 width="410" height="193" |
44 alt="Permission warning: 'It can: Access your data on api.flickr.com'" | 44 alt="Permission warning: 'It can: Access your data on api.flickr.com'" |
45 /> | 45 /> |
46 | 46 |
47 <p> | 47 <p> |
48 The warning about access to data on api.flickr.com | 48 The warning about access to data on api.flickr.com |
49 is caused by the following lines | 49 is caused by the following lines |
50 in the extension's manifest: | 50 in the extension's manifest: |
51 </p> | 51 </p> |
52 | 52 |
(...skipping 28 matching lines...) Expand all Loading... |
81 </pre> | 81 </pre> |
82 | 82 |
83 <p> | 83 <p> |
84 When the extension autoupdates, | 84 When the extension autoupdates, |
85 the increased permissions | 85 the increased permissions |
86 cause the extension to be disabled | 86 cause the extension to be disabled |
87 until the user re-enables it. | 87 until the user re-enables it. |
88 Here's the warning the user sees: | 88 Here's the warning the user sees: |
89 </p> | 89 </p> |
90 | 90 |
91 <img src="../images/perms-hw2-disabled.png" | 91 <img src="{{static}}/images/perms-hw2-disabled.png" |
92 width="814" height="30" | 92 width="814" height="30" |
93 alt="Warning text: 'The newest version of the extension Hello World requires m
ore permissions, so it has been disabled. [Re-enable].'" | 93 alt="Warning text: 'The newest version of the extension Hello World requires m
ore permissions, so it has been disabled. [Re-enable].'" |
94 /> | 94 /> |
95 | 95 |
96 <p> | 96 <p> |
97 Clicking the Re-enable button | 97 Clicking the Re-enable button |
98 brings up the following warning: | 98 brings up the following warning: |
99 </p> | 99 </p> |
100 | 100 |
101 <img src="../images/perms-hw2.png" | 101 <img src="{{static}}/images/perms-hw2.png" |
102 width="412" height="220" | 102 width="412" height="220" |
103 alt="Permission warning: 'It can: Access your data on api.flickr.com and flick
r.com; Read and modify your browsing history'" | 103 alt="Permission warning: 'It can: Access your data on api.flickr.com and flick
r.com; Read and modify your browsing history'" |
104 /> | 104 /> |
105 | 105 |
106 | 106 |
107 <h2 id="warnings"> Warnings and their triggers </h2> | 107 <h2 id="warnings"> Warnings and their triggers </h2> |
108 | 108 |
109 <p> | 109 <p> |
110 It can be surprising when adding a permission such as "tabs" | 110 It can be surprising when adding a permission such as "tabs" |
111 results in the seemingly unrelated warning | 111 results in the seemingly unrelated warning |
(...skipping 327 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
439 (and all other extensions that have outstanding updates) | 439 (and all other extensions that have outstanding updates) |
440 by clicking the <b>chrome://extensions</b> page's | 440 by clicking the <b>chrome://extensions</b> page's |
441 <b>Update extensions now</b> button. | 441 <b>Update extensions now</b> button. |
442 </p> | 442 </p> |
443 | 443 |
444 <h2 id="api">API</h2> | 444 <h2 id="api">API</h2> |
445 | 445 |
446 <p> | 446 <p> |
447 You can get a list of permission warnings for any manifest with | 447 You can get a list of permission warnings for any manifest with |
448 <a href="management.html#method-getPermissionWarnings">chrome.management.getPerm
issionWarnings()</a>. | 448 <a href="management.html#method-getPermissionWarnings">chrome.management.getPerm
issionWarnings()</a>. |
449 </p> | 449 </p> |
OLD | NEW |