Index: trunk/src/chrome/common/extensions/docs/templates/articles/manifest/web_accessible_resources.html |
=================================================================== |
--- trunk/src/chrome/common/extensions/docs/templates/articles/manifest/web_accessible_resources.html (revision 199633) |
+++ trunk/src/chrome/common/extensions/docs/templates/articles/manifest/web_accessible_resources.html (working copy) |
@@ -1,59 +0,0 @@ |
-<h1 id="web_accessible_resources">Manifest - Web Accessible Resources</h1> |
- |
-<p> |
-An array of strings specifying the paths (relative to the package root) of |
-packaged resources that are expected to be usable in the context of a web page. |
-For example, an extension that injects a content script with the intention of |
-building up some custom interface for <code>example.com</code> would whitelist |
-any resources that interface requires (images, icons, stylesheets, scripts, |
-etc.) as follows: |
-</p> |
- |
-<pre class="prettyprint"><span class="pun">{</span><span class="pln"> |
- </span><span class="pun">...</span><span class="pln"> |
- </span><span class="str">"web_accessible_resources"</span><span class="pun">:</span><span class="pln"> </span><span class="pun">[</span><span class="pln"> |
- </span><span class="str">"images/my-awesome-image1.png"</span><span class="pun">,</span><span class="pln"> |
- </span><span class="str">"images/my-amazing-icon1.png"</span><span class="pun">,</span><span class="pln"> |
- </span><span class="str">"style/double-rainbow.css"</span><span class="pun">,</span><span class="pln"> |
- </span><span class="str">"script/double-rainbow.js"</span><span class="pln"> |
- </span><span class="pun">],</span><span class="pln"> |
- </span><span class="pun">...</span><span class="pln"> |
-</span><span class="pun">}</span></pre> |
- |
-<p> |
-These resources would then be available in a webpage via the URL |
-<code>chrome-extension://[PACKAGE ID]/[PATH]</code>, which can be generated with |
-the <a href="http://developer.chrome.com/extensions/extension.html#method-getURL">extension.getURL</a> method. Whitelisted resources are served with appropriate |
-<a href="http://www.w3.org/TR/cors/">CORS</a> headers, so they're available via |
-mechanisms like XHR. |
-</p> |
- |
-<p> |
-Injected content scripts themselves do not need to be whitelisted. |
-</p> |
- |
-<p> |
-Prior to manifest version 2 all resources within an extension could be accessed |
-from any page on the web. This allowed a malicious website to |
-<a href="http://en.wikipedia.org/wiki/Device_fingerprint">fingerprint</a> the |
-extensions that a user has installed or exploit vulnerabilities (for example |
-<a href="http://en.wikipedia.org/wiki/Cross-site_scripting">XSS bugs</a>)within |
-installed extensions. Limiting availability to only resources which are |
-explicitly intended to be web accessible serves to both minimize the available |
-attack surface and protect the privacy of users. |
-</p> |
- |
-<h2 id="availability">Default Availability</h2> |
- |
-<p> |
-Resources inside of packages using <a href="http://developer.chrome.com/extensions/manifest.html#manifest_version"><code>manifest_version</code></a> |
-2 or above are <strong>blocked by default</strong>, and must be whitelisted |
-for use via this property. |
-</p> |
- |
-<p> |
-Resources inside of packages using <code>manifest_version</code> 1 are available |
-by default, but <em>if</em> you do set this property, then it will be treated as |
-a complete list of all whitelisted resources. Resources not listed will be |
-blocked. |
-</p> |