Updated Branches: refs/heads/master 8c2073680 -> 591ec4d2a
Fixes CB-812 - Update Whitelisting Documentation for iOS Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/591ec4d2 Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/591ec4d2 Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/591ec4d2 Branch: refs/heads/master Commit: 591ec4d2a04d389b4cf4e3127e991b4cb0e75bec Parents: 8c20736 Author: shazron <shaz...@gmail.com> Authored: Wed May 23 16:09:07 2012 -0700 Committer: shazron <shaz...@gmail.com> Committed: Wed May 23 16:09:07 2012 -0700 ---------------------------------------------------------------------- docs/en/edge/guide/whitelist/index.md | 22 ++++++++++++++++++++-- 1 files changed, 20 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/591ec4d2/docs/en/edge/guide/whitelist/index.md ---------------------------------------------------------------------- diff --git a/docs/en/edge/guide/whitelist/index.md b/docs/en/edge/guide/whitelist/index.md index f5f51f1..25fbf01 100644 --- a/docs/en/edge/guide/whitelist/index.md +++ b/docs/en/edge/guide/whitelist/index.md @@ -65,9 +65,27 @@ BlackBerry iOS --- -The easiest way of doing this is by going to your project's *cordova.plist* file and adding a new *String* to the *ExternalHosts* key. That's all! +1. Search for the **Cordova.plist** file in your project. +2. Add a new **String** value to the **ExternalHosts** key. -Be warned that you should not include a full URL, with the `http://` part, just the sub-domain/domain, like on the examples. +For the value of the String, just include the **hostname / IP Address** of the URL **only** without the scheme or the path of the URL. + +For example, if you have a URL like this: **http://**my.phonegap.com**:443?is_awesome=yes**, the whitelist value would be: + + my.phonegap.com + +You can also use **wildcards** in the value. For example, if you want to **allow all subdomains**, you would use this value: + + *.phonegap.com + +Similarly, if you want to allow all TLDs also (.com, .net, etc) you would do this: + + *.phonegap.* + +To allow all domains, you would just add ** "*" ** like so, this will effectively **turn off the whitelist**: + + * + Symbian -------
