incubator-callback-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mwbro...@apache.org
Subject docs commit: CB-812 Update iOS whitelisting.
Date Wed, 30 May 2012 22:50:00 GMT
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 <michael@michaelbrooks.ca>
Authored: Wed May 30 15:49:53 2012 -0700
Committer: Michael Brooks <michael@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
 -------


Mime
View raw message