You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2012/05/31 00:50:00 UTC
docs commit: CB-812 Update iOS whitelisting.
Updated Branches:
refs/heads/master 949714e39 -> 481dc21b2
CB-812 Update iOS whitelisting.
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/481dc21b
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/481dc21b
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/481dc21b
Branch: refs/heads/master
Commit: 481dc21b2f18a04576298a814dc4326a37b7f052
Parents: 949714e
Author: Michael Brooks <mi...@michaelbrooks.ca>
Authored: Wed May 30 15:49:53 2012 -0700
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Wed May 30 15:49:53 2012 -0700
----------------------------------------------------------------------
docs/en/edge/guide/whitelist/index.md | 36 +++++++++++++++++-----------
1 files changed, 22 insertions(+), 14 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/481dc21b/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 b50c564..c7f8c43 100644
--- a/docs/en/edge/guide/whitelist/index.md
+++ b/docs/en/edge/guide/whitelist/index.md
@@ -95,27 +95,35 @@ Access to all domains, including `file://` protocol:
iOS
---
-1. Search for the **Cordova.plist** file in your project.
-2. Add a new **String** value to the **ExternalHosts** key.
+1. Open `Cordova.plist`.
+ - In Xcode, it is found at `AppName/Supporting Files/Cordova.plist`
+ - In the directory, it is found at `AppName/Cordova.plist`
+2. Add a new `String` value under the `ExternalHosts` key.
+ - We recommend using Xcode to avoid editing raw XML.
-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.
+Domain protocols (e.g. `http://` and `https://`) are not supported by iOS.
-For example, if you have a URL like this: **http://**my.phonegap.com**:443?is_awesome=yes**, the whitelist value would be:
+Access to [google.com][2] and the secure [google.com][3] (`https://`):
- my.phonegap.com
+ google.com
-You can also use **wildcards** in the value. For example, if you want to **allow all subdomains**, you would use this value:
+Access to the subdomain [maps.google.com][4]:
+
+ maps.google.com
+
+Access to all the subdomains on [google.com][2] (e.g. [mail.google.com][5] and [docs.google.com][6]):
+
+ *.google.com
+
+Access to all domains (e.g. [google.com][2] and [developer.mozilla.org][7]):
+
+ *
- *.phonegap.com
-
-Similarly, if you want to allow all TLDs also (.com, .net, etc) you would do this:
+Wildcards on iOS (`*`) are more flexible than the [W3C Widget Access][1] specification.
- *.phonegap.*
-
-To allow all domains, you would just add ** "*" ** like so, this will effectively **turn off the whitelist**:
+Access to all subdomains and TLDs (`.com`, `.net`, etc):
- *
-
+ *.google.*
Symbian
-------