これがないドキュメントの最新バージョンです！ Click here for the latest released version.

ホワイトリストガイド

ホワイトリスト登録のドメインは、アクセスを制御するセキュリティモデルをアプリケーションコントロールを持たない外部のドメインにします。コルドバの既定のセキュリティポリシーは、任意のサイトにアクセスをできます。生産へアプリケーションを移動する前に、ホワイトリストを策定し、特定のネットワークドメインおよびサブドメインにアクセスできるようにする必要があります。

コルドバに依存しているW3C のウィジェットのアクセス仕様に準拠して、 <access> 、アプリ内での要素 config.xml 特定のドメインへのネットワークアクセスを有効にするファイル。コマンドラインインターフェイスで記述された CLI ワークフローに依存するプロジェクトのためこのファイルにあるプロジェクトの最上位ディレクトリそれ以外の場合、プラットフォーム固有の開発パス場所は以下のセクションに表示されます。（各プラットフォーム上のさまざまなプラットフォームのガイドの詳細を参照）。

ホワイトリストの構文を次の例に示します。

Google.comへのアクセス:
```
<access origin="http://google.com" />
```
安全なgoogle.comへのアクセス ( https:// )。
```
<access origin="https://google.com" />
```
サブドメインmaps.google.comへのアクセス:
```
<access origin="http://maps.google.com" />
```
すべてのサブドメインにgoogle.com、たとえば接続とdocs.google.comへのアクセス:
```
<access origin="http://*.google.com" />
```
たとえば、 google.comおよびdeveloper.mozilla.orgのすべてのドメインへのアクセス:
```
<access origin="*" />
```
これは、新しく作成した CLI プロジェクトの既定値です。

アマゾン火 OS ホワイト

プラットフォーム固有のホワイトリストの規則はあります。res/xml/config.xml.

Android のホワイトリスト

プラットフォーム固有のホワイトリストの規則はあります。res/xml/config.xml.

注: Android 2.3 とドメインホワイトリストのみで動作する前に href のハイパーリンク、画像、スクリプトなどのリソースも参照されていません。アプリケーションに挿入されてからスクリプトを避けるために措置を取る。

ホワイトリストに登録して非経由でドメインへの移動 href ハイパーリンクにより、アプリケーション内ではなく、既定のブラウザーを開いてページ。(この比較下記の iOS の動作です。)

iOS ホワイト

プラットフォームのホワイトリスト登録ルールの発見の名前のアプリケーションディレクトリに config.xml ファイル。

起源のようなプロトコルを使わずに指定 www.apache.org よりもむしろ http://www.apache.org 、すべてのデフォルト、 http 、 https 、 ftp と ftps スキーム。

IOS プラットフォーム上のワイルドカードは、 W3C のウィジェットアクセス仕様よりも柔軟性です。たとえば、次のアクセスすべてのサブドメインおよびトップレベルドメインなど、 .com と .net ：

    <access origin="*.google.*" />

ホワイトリストに登録して非経由でドメインへの移動、上述した Android のプラットフォームとは異なり href iOS 上のハイパーリンクが、まったく開いてページを防ぎます。

ブラックベリー 10 ホワイト

ホワイトリスト登録ルールを発見します。www/config.xml.

ブラックベリー 10年使用ワイルドカードの次の 2 つの方法で他のプラットフォームによって異なります。

によってアクセスできるコンテンツ XMLHttpRequest を明示的に宣言する必要があります。設定 origin="*" この場合動作しません。代わりに、すべての web セキュリティできない可能性がありますを使用して、 WebSecurity 好みのブラックベリーの構成で説明：
```
<preference name="websecurity" value="disable" />
```
設定に代わるものとして *.domain 、セット、 subdomains 属性を true 。設定する必要があります false デフォルトで。たとえば、次のようにアクセスをできます google.com 、 maps.google.com 、および docs.google.com :
```
<access origin="http://google.com" subdomains="true" />
```
次の限定にアクセスする google.com :
```
<access origin="http://google.com" subdomains="false" />
```
ローカルを含むすべてのドメインへのアクセスを指定する file:// プロトコル。

（サポートの詳細については、ブラックベリーのマニュアル参照してくださいアクセス要素.)

3.1.0 の iOS の変化

前のバージョン 3.1.0、コルドバ iOS 他コルドバのプラットフォームでサポートされているドメイン whilelisting スキームをいくつかの非標準の拡張含まれています。 3.1.0、現在 iOS のホワイトリストは今このドキュメントの上部に記載されているリソースのホワイトリストの構文に準拠します。変更する必要があります前 3.1.0 からアップグレードする場合にこれらの拡張機能を使用していた、 config.xml として前にホワイトリスト登録リソースの同じセットを続行するためにファイル。

具体的には、これらのパターンを更新する必要があります。

apache.org(プロトコル): これは以前と一致 http 、 https 、 ftp 、および ftps プロトコル。変更" *://apache.org/* "に、すべてのプロトコルを含めたり、各プロトコルをサポートする必要がある行が含まれます。
http://apache.*(ワイルドカードドメインの終わりに): これは以前すべて上位-レベルの-ドメイン、すべての可能な 2 文字の Tld を含むと一致 (しかしように有用ではないドメイン。 co.uk)。行することが実際に制御、ホワイトリストに登録する必要がある各 TLD を含めます。
h*t*://ap*he.o*g(行方不明のランダムな文字のワイルドカード文字): これらはサポートされていません。各ドメインをホワイトリストに実際に必要なプロトコルの行を含めるに変更します。

Windows Phone のホワイトリスト

アプリの Windows Phone 7 と 8 のホワイトリスト登録ルールの発見 config.xml ファイル。

Tizen ホワイト

アプリのでホワイトリスト登録ルールの発見 config.xml ファイル。プラットフォーム依存して同じ subdomains 、黒イチゴ・プラットホームとしての属性。（サポートの詳細については、Tizen のマニュアル参照してくださいアクセス要素.)

ホワイト リスト ガイド