既に registerClassAlias() メソッドの呼び出しによってエイリアスが登録されているクラスを検索します。

このメソッドは flash.utils.getDefinitionByName() メソッドとやり取りを行いません。

パラメータ

関連項目

Flash Player のコンテナを含むアプリケーション (通常はブラウザ) でウィンドウを開くか、置き換えます。Adobe AIR では、関数によってデフォルトシステム Web ブラウザで URL が開かれます。

セキュリティ上の重要な注意事項

開発者は、FlashVars などの外部ソースから取得した URL 値を navigateToURL() 関数に渡すことがよくあります。攻撃者は、このような外部ソースを操作して、クロスサイトスクリプトのような攻撃の実行を試みます。したがって、開発者は、この関数に渡す前にすべての URL を検証する必要があります。

URL の適切なデータ検証は、アプリケーション全体での URL の使用方法により、異なることを意味する場合があります。最も一般的なデータ検証方法の 1 つは、URL が正しいスキームであることを確認する方法です。例えば、誤って javascript: のような URL を許可すると、クロスサイトスクリプト攻撃を受ける可能性があります。URL が自分のドメイン内のものであることを検証することで、フィッシング攻撃によって SWF ファイルがオープンリダイレクタとして使用できないことを確認できます。さらにセキュリティを強化するには、URL のパスを検証し、URL が RFC のガイドラインに準拠していることを確認することもできます。

例えば、次に示す簡単なコードの例では、データの検証として、http:// または https:// で始まっていない URL を拒否し、URL が自分のドメイン名に含まれることを確認しています。Web アプリケーションによってはこの例が適していない場合があるので、URL に対して他の検査が必要かどうかを検討する必要があります。

     // AS3 Regular expression pattern match for URLs that start with http:// and https:// plus your domain name.
     function checkProtocol (flashVarURL:String):Boolean {
        // Get the domain name for the SWF if it is not known at compile time.
        // If the domain is known at compile time, then the following two lines can be replaced with a hard coded string.
        var my_lc:LocalConnection = new LocalConnection();
        var domainName:String = my_lc.domain;
        // Build the RegEx to test the URL.
        // This RegEx assumes that there is at least one "/" after the
        // domain. http://www.mysite.com will not match.
        var pattern:RegExp = new RegExp("^http[s]?\:\\/\\/([^\\/]+)\\/");
        var result:Object = pattern.exec(flashVarURL);
        if (result == null || result[1] != domainName || flashVarURL.length >= 4096) {
          return (false);
        }
        return (true);
     }  
     
      

ブラウザ内で実行されるローカルコンテンツの場合、navigateToURL() メソッドを呼び出すときに "javascript:" 擬似プロトコルを（最初のパラメータとして渡される URLRequest オブジェクトを介して）指定できるのは、SWF ファイルとそれが含まれる Web ページ（存在する場合）が、信頼できるローカルのセキュリティサンドボックス内にある場合のみです。一部のブラウザでは、navigateToURL() メソッドとの javascript プロトコルの使用はサポートしていません。代わりに、call() メソッド（ExternalInterface API）を使用し、JavaScript メソッドを取り込んでいる HTML ページ内で呼び出すことを検討してください。

Flash Player、および Adobe AIR のアプリケーションサンドボックス以外では、一般的な予約ポートに接続することはできません。ブロックされている全ポートの一覧については、『ActionScript 3.0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。

ブラウザで実行される Flash Player 10 以降では、このメソッドをプログラムで使用してポップアップウィンドウを開く方法は有効でない場合があります。ブラウザ（およびブラウザの設定）によってはポップアップウィンドウがブロックされる場合があり、すべてのポップアップウィンドウが表示される保証はありません。ただし、ユーザー操作の直接の結果として実行されるコード（マウスのクリックやキー入力イベントのイベントハンドラなど）に限っては、このクラスを使用してポップアップウィンドウを開く方法が有効です。

Flash Player 10 以降では、"multipart/form-data" などのマルチパート Content-Type にアップロードが含まれていると（アップロードが含まれているかどうかは POST ボディ内の "content-disposition" ヘッダーの "filename" パラメータで示されます）、そのアップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

• POST 処理は、マウスのクリックやキーの押下などのユーザーが開始したアクションに応答して実行する必要があります。
• POST 処理がクロスドメインである (POST ターゲットが、POST 要求を送信中の SWF ファイルと同じサーバー上にない) 場合は、クロスドメインアクセスを許可する URL ポリシーファイルをターゲットサーバーが提供する必要があります。

また、すべてのマルチパート Content-Type では、RFC2046 標準に準拠した有効なシンタックスを使用する必要があります。シンタックスが有効でない場合は、アップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

セキュリティ情報について詳しくは、以下を参照してください。

• セキュリティに関する章（『ActionScript 3.0 のプログラミング』）と LiveDocs に関する最新のコメント
• Flash Player デベロッパーセンタートピック：セキュリティ

パラメータ

関連項目

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class NavigateToURLExample extends Sprite {

        public function NavigateToURLExample() {
            var url:String = "http://www.adobe.com";
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "Your Name";
            var request:URLRequest = new URLRequest(url);
            request.data = variables;
            try {            
                navigateToURL(request);
            }
            catch (e:Error) {
                // handle error here
            }
        }
    }
}

AMF (Action Message Format) でオブジェクトがエンコードされるとき、オブジェクトのクラス (タイプ) を維持します。オブジェクトを AMF にエンコードする場合、この関数は、そのクラスのエイリアスを保存し、オブジェクトのデコード時にクラスを復元できるようにします。エンコードコンテキストで、オブジェクトのクラスのエイリアスが登録されていない場合、オブジェクトは匿名オブジェクトとしてエンコードされます。同様に、デコードコンテキストで、同じエイリアスが登録されていない場合、デコードするデータに対して、匿名オブジェクトが作成されます。

LocalConnection、ByteArray、SharedObject、NetConnection、および NetStream はすべて、AMF でオブジェクトをエンコードするクラスの例です。

エンコードおよびデコードコンテキストでは、エイリアスに同じクラスを使用する必要はありません。エンコード先およびデコード先のクラスに、ソースクラスによって直列化されたすべてのメンバーが含まれている限り、クラスを意図的に変更できます。

パラメータ

関連項目

package {
    import flash.display.Sprite;
    import flash.net.registerClassAlias;
    import flash.utils.ByteArray;

    public class RegisterClassAliasExample extends Sprite {
        public function RegisterClassAliasExample() {
            registerClassAlias("com.example.eg", ExampleClass);
            var eg1:ExampleClass = new ExampleClass();
            var ba:ByteArray = new ByteArray();
            ba.writeObject(eg1);
            ba.position = 0;
            var eg2:* = ba.readObject();
            trace(eg2 is ExampleClass); // true
        }
    }
}

class ExampleClass {}

URL リクエストをサーバーに送信しますが、応答は無視します。

サーバーの応答を調べるには、代わりに URLLoader.load() メソッドを使用します。

一般的な予約ポートに接続することはできません。ブロックされている全ポートの一覧については、『ActionScript 3.0 のプログラミング』のセキュリティに関する章の「ネットワーク API の制限」を参照してください。

SWF ファイルがこのメソッドを使用しないようにするには、SWF コンテンツを含んでいる HTML ページに allowNetworking パラメータ (object タグおよび embed タグのパラメータ) を設定します。

Flash Player 10 以降では、"multipart/form-data" などのマルチパート Content-Type にアップロードが含まれていると（アップロードが含まれているかどうかは POST ボディ内の "content-disposition" ヘッダーの "filename" パラメータで示されます）、そのアップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

• POST 処理は、マウスのクリックやキーの押下などのユーザーが開始したアクションに応答して実行する必要があります。
• POST 処理がクロスドメインである (POST ターゲットが、POST 要求を送信中の SWF ファイルと同じサーバー上にない) 場合は、クロスドメインアクセスを許可する URL ポリシーファイルをターゲットサーバーが提供する必要があります。

また、すべてのマルチパート Content-Type では、RFC2046 標準に準拠した有効なシンタックスを使用する必要があります。シンタックスが有効でない場合は、アップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

セキュリティ情報について詳しくは、以下を参照してください。

• セキュリティに関する章（『ActionScript 3.0 のプログラミング』）と LiveDocs に関する最新のコメント
• Flash Player デベロッパーセンタートピック：セキュリティ

パラメータ

関連項目

 package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.net.URLVariables;
    import flash.net.sendToURL;

    public class SendToURLExample extends Sprite {

        public function SendToURLExample() {
            var url:String = "http://www.yourDomain.com/application.jsp";
            var variables:URLVariables = new URLVariables();
            variables.sessionId = new Date().getTime();
            variables.userLabel = "Your Name";

            var request:URLRequest = new URLRequest(url);
            request.data = variables;
            trace("sendToURL: " + request.url + "?" + request.data);
            try {
                sendToURL(request);
            }
            catch (e:Error) {
                // handle error here
            }
        }
    }
}