| パッケージ | flash.data |
| クラス | public class EncryptedLocalStore |
| 継承 | EncryptedLocalStore Object |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
暗号化されたローカルストアは、Web サービスのログイン資格情報など、保護する必要がある情報を保存するために使用できます。
AIR Debug Launcher (ADL) でアプリケーションをテストする場合、テスト対象のアプリケーションはインストール済みの AIR アプリケーションで使用されているものとは異なる暗号化されたローカルストアを使用します。
AIR は、Windows® では DPAPI、Mac® OS® では KeyChain、Linux® では KeyRing または KWallet を使用して、暗号化されたローカル ストアを各アプリケーションおよびユーザーに関連付けます。暗号化されたローカルストアでは、128 ビットの AES-CBC 暗号化を使用します。
暗号化されたローカルストアの情報は、application セキュリティサンドボックス内の AIR アプリケーションコンテンツでのみ使用できます。
暗号化されたローカルストアのアイテムは、ストリングで識別されます。アイテムは、すべてバイト配列データとして保存されます。
保存されるデータが 10 MB を超える場合、暗号化されたローカルストアの実行が低速化する場合があります。
AIR アプリケーションをアンインストールする場合、アンインストーラは暗号化されたローカルストアに保存されたデータを削除しません。
暗号化されたローカルストアのデータは、ユーザーのアプリケーションデータディレクトリのサブディレクトリに置かれます。このサブディレクトリのパスは Adobe/AIR/ELS/ の後ろにアプリケーション ID が続きます。
| メソッド | 定義元 | ||
|---|---|---|---|
[静的] 指定された名前を持つ、暗号化されたローカルストアのアイテムのデータを返します。 | EncryptedLocalStore | ||
![]() | オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | |
![]() | Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | |
![]() | 指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | |
[静的] 暗号化されたローカルストアから、指定された名前のアイテムを削除します。 | EncryptedLocalStore | ||
[静的] すべてのデータを削除して、暗号化されたローカルストア全体をクリアします。 | EncryptedLocalStore | ||
[静的] 指定された名前で、所定の ByteArray データにアイテムを設定します。 | EncryptedLocalStore | ||
![]() | ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | |
![]() | 指定されたオブジェクトのストリング表現を返します。 | Object | |
![]() | 指定されたオブジェクトのプリミティブな値を返します。 | Object | |
| () | メソッド |
public static function getItem(name:String):ByteArray| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
指定された名前を持つ、暗号化されたローカルストアのアイテムのデータを返します。指定された名前でアイテムが見つからない場合、このメソッドは null を返します。
パラメータ
name:String — 暗号化されたローカルストアのアイテムの名前です。 |
ByteArray —
ByteArray データです。 指定された名前に対するデータが存在しない場合、メソッドは null を返します。
|
ArgumentError —
name 値は null または空のストリングです。
|
| () | メソッド |
public static function removeItem(name:String):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
暗号化されたローカルストアから、指定された名前のアイテムを削除します。
パラメータ
name:String — 暗号化されたローカルストアのアイテムの名前です。 |
ArgumentError —
name 値は null または空のストリングです。
|
| () | メソッド |
public static function reset():void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
すべてのデータを削除して、暗号化されたローカルストア全体をクリアします。
| () | メソッド |
public static function setItem(name:String, data:ByteArray, stronglyBound:Boolean = false):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
指定された名前で、所定の ByteArray データにアイテムを設定します。
パラメータ
name:String — 暗号化されたローカルストアのアイテムの名前です。 | |
data:ByteArray — データです。 | |
stronglyBound:Boolean (default = false) —
true に設定された場合、保存されたアイテムはアプリケーションの発行者 ID に加えて AIR アプリケーションの電子署名とビットに厳密にバインドされます。 このアイテムに対して getItem() をその後で呼び出した場合、呼び出し元の AIR アプリケーションのビットが保存する側のアプリケーションのビットと一致しない場合はランタイム例外になります。アプリケーションを更新すると、更新されたアプリケーションは、暗号化されたローカルストアに以前に書き込まれたデータに厳密にバインドされているデータを読み取ることができません。
|
ArgumentError —
name 値は null または空のストリングです。
デフォルトでは、AIR アプリケーションは別のアプリケーションの暗号化されたローカルストアを読み取ることはできません。 |
var str:String = "Bob";
var bytes:ByteArray = new ByteArray();
bytes.writeUTFBytes(str);
EncryptedLocalStore.setItem("firstName", bytes);
var storedValue:ByteArray = EncryptedLocalStore.getItem("firstName");
trace(storedValue.readUTFBytes(storedValue.length)); // "Bob"
EncryptedLocalStore.removeItem("firstName");