flash.data.EncryptedLocalStore (ActionScript 3.0)

(AIR uniquement)

Package	flash.data
Classe	public class EncryptedLocalStore
Héritage	EncryptedLocalStore Object

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0

La classe EncryptedLocalStore fournit des méthodes qui permettent de définir et de récupérer des objets dans le stockage de données local crypté pour une application AIR. Un stockage local crypté permanent est disponible pour chaque application AIR installée sur l'ordinateur de l'utilisateur. Vous pouvez ainsi enregistrer et récupérer des données stockées sur le disque dur local de l'utilisateur dans un format crypté que les autres applications ou utilisateurs ne peuvent pas déchiffrer. Un stockage local crypté distinct est utilisé pour chaque application AIR et chaque application AIR utilise un stockage local crypté distinct pour chaque utilisateur.

Vous pouvez utiliser le stockage local crypté pour stocker les informations confidentielles, telles que les identifiants de connexion aux services Web.

Lorsque vous testez une application dans l'application de débogage du lanceur AIR (ADL), l'application utilise un autre stockage local crypté que celui employé par l'application AIR installée.

AIR utilise DPAPI sous Windows ^®, KeyChain sous Mac^® OS^® et KeyRing ou KWallet sous Linux^® pour associer le stockage local crypté à chaque application et utilisateur. Le stockage local crypté utilise un cryptage AES-CBC de 128 bits.

Les informations conservées dans le stockage local crypté ne sont disponibles que pour le contenu de l'application AIR dans le sandbox de sécurité de celle-ci.

Les éléments du stockage local crypté sont identifiés par une chaîne. Tous les éléments sont stockés sous forme de données de tableau d'octets.

Le stockage local crypté peut s'exécuter plus lentement si les données stockées dépassent 10 Mo.

Lorsque vous désinstallez une application AIR, le programme de désinstallation ne supprime pas les données stockées dans le stockage local crypté.

Les données du stockage local crypté sont placées dans un sous-répertoire du répertoire de données de l'application de l'utilisateur ; le chemin du sous-répertoire est Adobe/AIR/ELS/suivi de l'ID de l'application.

Consulter les exemples

	Propriété	Défini par
		constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.	Object
		prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction.	Object

	Méthode	Défini par
		getItem(name:String):ByteArray [statique] Renvoie les données de l'élément portant le paramètre name donné dans le stockage local crypté.	EncryptedLocalStore
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d'un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeItem(name:String):void [statique] Supprime l'élément présentant le paramètre name donné du stockage local crypté.	EncryptedLocalStore
		reset():void [statique] Efface tout le stockage local crypté, en supprimant toutes les données.	EncryptedLocalStore
		setItem(name:String, data:ByteArray, stronglyBound:Boolean = false):void [statique] Définit l'élément sur le nom donné aux données ByteArray fournies.	EncryptedLocalStore
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l'objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l'objet spécifié.	Object

Détails de la méthode

getItem

()

méthode

public static function getItem(name:String):ByteArray

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0

Renvoie les données de l'élément portant le paramètre name donné dans le stockage local crypté. Si un élément n'existe pas avec le paramètre name spécifié, cette méthode renvoie null.

Paramètres

name:String — Nom de l'élément dans le stockage local crypté.

Valeur renvoyée

ByteArray — Données ByteArray. S'il n'y a pas de données pour le paramètre name fourni, la méthode renvoie null.

Valeur émise

ArgumentError — La valeur name est null ou une chaîne vide.

removeItem

()

méthode

public static function removeItem(name:String):void

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0

Supprime l'élément présentant le paramètre name donné du stockage local crypté.

Paramètres

name:String — Nom de l'élément dans le stockage local crypté.

Valeur émise

ArgumentError — La valeur name est null ou une chaîne vide.

reset

()

méthode

public static function reset():void

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0

Efface tout le stockage local crypté, en supprimant toutes les données.

setItem

()

méthode

public static function setItem(name:String, data:ByteArray, stronglyBound:Boolean = false):void

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0

Définit l'élément sur le nom donné aux données ByteArray fournies.

Paramètres

	`name:String` — Nom de l'élément dans le stockage local crypté.

	`data:ByteArray` — Données.

	`stronglyBound:Boolean` (default = `false`) — Si défini sur `true`, l'élément stocké est fortement lié à la signature numérique et aux bits de l'application AIR, en plus de l'ID de l'éditeur de l'application. Un appel suivant à `getItem()` pour cet élément entraîne une exception d'exécution si les bits de l'application AIR appelante ne correspondent pas à ceux de l'application de stockage. Si vous mettez à jour votre application, elle ne peut pas lire les données fortement liées précédemment écrites dans le stockage local crypté.

Valeur émise

ArgumentError — La valeur name est null ou une chaîne vide.

Par défaut, une application AIR ne peut pas lire le stockage local crypté d'une autre application. Le paramètre stronglyBound fournit une liaison supplémentaire (aux données des bits de l'application) qui empêche les applications pirates d'essayer de lire dans le stockage local crypté de votre application en tentant de détourner l'ID de l'éditeur de votre application.

Exemples Utilisation des exemples

EncryptedLocalStore.1.as

Le code suivant stocke une chaîne dans le stockage local crypté, la récupère, puis la supprime :

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");

Guide de référence du langage et des composants ActionScript 3.0		Accueil \| Tous les packages \| Toutes les classes \| Eléments du langage \| Index \| Annexes \| Conventions \| Afficher les encadrés Masquer les encadrés
EncryptedLocalStore	Propriétés \| Méthodes \| Exemples