You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2012/05/24 01:09:13 UTC
docs commit: Fixes CB-812 - Update Whitelisting Documentation for iOS
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 <sh...@gmail.com>
Authored: Wed May 23 16:09:07 2012 -0700
Committer: shazron <sh...@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
-------