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