EncryptionKeyGenerator

Пакет	mx.data.crypto
Класс	public class EncryptionKeyGenerator
Наследование	EncryptionKeyGenerator Object

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Класс EncryptionKeyGenerator создает значение ключа шифрования, аналогичное тому, что используется для шифрования файлов или данных. Например, ключ шифрования может использоваться для зашифрованной локальной базы данных SQL (SQLite) AIR.

Этот класс использует методы и алгоритмы, которые обеспечивают максимальную защиту и конфиденциальность данных. С помощью этого класса создается ключ шифрования, если для приложения требуется зашифровать данные на уровне каждого пользователя ( т. е. только один пользователь программы может получить доступ к своим данным). Иногда шифрование данных на уровне каждого пользователя может использоваться даже в случаях, когда структура приложения разрешает другим пользователям получать доступ к данным. Для получения дополнительной информации см. раздел Предпосылки для использования зашифрованной базы данных в руководстве Разработка приложений Adobe AIR в программе Flex.

Для создания ключа шифрования используется указываемый пароль. Для всех паролей, используемых в одном приложении AIR, которое запущено с одной учетной записи пользователя на одном компьютере, результаты ключа шифрования будут совпадать.

Для создания ключа шифрования на основе пароля используется метод getEncryptionKey(). Для подтверждения надежности пароля перед вызовом метода getEncryptionKey() используйте метод validateStrongPassword().

Также EncryptionKeyGenerator включает в себя служебную константу ENCRYPTED_DB_PASSWORD_ERROR_ID. Эта константа соответствует идентификатору ошибки SQLError, возникающей при попытке доступа кода к зашифрованной базе данных с неправильным ключом шифрования.

Этот класс создает ключ шифрования, который обеспечивает максимальный уровень защиты и конфиденциальности данных. Для достижения высочайшего уровня защиты необходимо соблюдать несколько принципов безопасности:

Указанный пользователем пароль не должен сохраняться в приложении.
Приложение не должно сохранять ключ шифрования, возвращенный методом getEncryptionKey().
При каждом запуске приложения и попытке пользователя получить доступ к базе данных код приложения должен вызывать метод getEncryptionKey(), чтобы восстановить ключ шифрования.

Для получения дополнительной информации о защите данных и объяснении методов системы защиты, используемых в классе EncryptionKeyGenerator, см. в разделе Пример: создание и использование ключа шифрования в руководстве Разработка приложений Adobe AIR в программе Flex.

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		EncryptionKeyGenerator() Создает новый экземпляр EncryptionKeyGenerator.	EncryptionKeyGenerator
		getEncryptionKey(password:String, overrideSaltELSKey:String = null):ByteArray Использует пароль для создания 16-байтового ключа шифрования.	EncryptionKeyGenerator
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		validateStrongPassword(password:String):Boolean Проверяет пароль и возвращает значение, указывающее, является ли пароль надежным.	EncryptionKeyGenerator
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

Общедоступные константы

	Константа		Определено
		ENCRYPTED_DB_PASSWORD_ERROR_ID : uint = 3138 [статические] Эта константа соответствует идентификатору ошибки (3138) SQLError, возникающей при попытке доступа кода к зашифрованной базе данных с неправильным ключом шифрования.	EncryptionKeyGenerator

Сведения о конструкторе

Сведения о методе

getEncryptionKey

()

метод

public function getEncryptionKey(password:String, overrideSaltELSKey:String = null):ByteArray

Язык версии:

ActionScript 3.0

Версия продукта:

Adobe Digital Enterprise Platform Data Services for Java EE 3.1

Версии среды выполнения:

Flash Player 9, AIR 1.1

Использует пароль для создания 16-байтового ключа шифрования. Возвращаемое значение может использоваться как ключ шифрования для зашифрованной локальной базы данных SQL (SQLite) AIR.

Вызов метода getEncryptionKey() в одном приложении AIR, которое запущено с одной учетной записи пользователя на одном компьютере, результаты ключа шифрования будут совпадать для всех паролей.

Этот метод создает ключ шифрования, который обеспечивает максимальный уровень защиты и конфиденциальности данных. Для достижения высочайшего уровня защиты необходимо соблюдать несколько принципов безопасности в приложении:

Указанный пользователем пароль не должен сохраняться в приложении.
Приложение не должно сохранять ключ шифрования, возвращенный методом getEncryptionKey().
При каждом запуске приложения и попытке пользователя получить доступ к базе данных необходимо вызвать метод getEncryptionKey(), чтобы восстановить ключ шифрования.

Параметры

	`password:String` — Пароль для создания ключа шифрования.

	`overrideSaltELSKey:String` (default = `null`) — EncryptionKeyGenerator создает и сохраняет произвольное значение (называемое солт-значением) в процессе создания ключа шифрования. Когда приложение впервые вызывает метод `getEncryptionKey()`, создается солт-значение, которое сохраняется в зашифрованном локальном хранилище приложения AIR (ELS). Впоследствии солт-значение загружается из ELS. Если необходимо использовать пользовательский ключ ELS строки для хранения солт-значения, укажите значение для параметра `overrideSaltELSKey`. Если параметр имеет значение `null` (по умолчанию), используется имя ключа по умолчанию.

Возвращает

ByteArray — Созданный ключ шифрования, 16-байтовый объект ByteArray.

Выдает

	`ArgumentError` — Если указанный пароль не рассматривается как надежный в соответствии с критериями, изложенными в описании метода `validateStrongPassword()`

	`ArgumentError` — Если указано значение отличное от `null` для параметра `overrideSaltELSKey` и значением является пустая строка (`""`)

Сведения о константе

Юридическая информация | Политика конфиденциальности онлайн

EncryptionKeyGenerator - AS3 ADEP Data Services

Пакетыx

Элементы языка

Приложения

Пакет mx.data.crypto

getEncryptionKey

validateStrongPassword

ENCRYPTED_DB_PASSWORD_ERROR_ID