|
LV. Функции шифровки Mcrypt
Это интерфейс с библиотекой mcrypt, который поддерживает широкий набор
алгоритмов, таких как DES, TripleDES, Blowfish
(по умолчанию), 3-WAY, SAFER-SK64, SAFER-SK128, TWOFISH, TEA, RC2 и режимов шифровки
GOST в CBC, OFB, CFB и ECB. Дополнительно он поддерживает RC6 и IDEA,
которые считаются "non-free".
Mcrypt можно использовать для шифровки и дешифровки вышеприведёнными
шифрами. Если вы связались с библиотекой libmcrypt-2.2.x, четыре важные команды mcrypt
(
mcrypt_cfb()
,
mcrypt_cbc()
,
mcrypt_ecb()
и
mcrypt_ofb()
) могут оперировать в двух режимах, которые называются MCRYPT_ENCRYPT и MCRYPT_DECRYPT,
соответственно.
Пример 1. Шифровка input-значения шифром TripleDES под 2.2.x в режиме ECB
<?php
$key = "this is a very secret key";
$input = "Let us meet at 9 o'clock at the secret place.";
$encrypted_data = mcrypt_ecb (MCRYPT_3DES, $key, $input, MCRYPT_ENCRYPT);
?>
|
|
Это пример даст данные, зашифрованные как строка в
$encrypted_data.
Если связаны с библиотекой libmcrypt 2.4.x или 2.5.x, эти функции также
будут доступны, но рекомендуется использовать продвинутые функции.
Пример 2. Шифровка input-значения шифром TripleDES под 2.4.x и выше в режиме ECB
<?php
$key = "this is a very secret key";
$input = "Let us meet at 9 o'clock at the secret place.";
$td = mcrypt_module_open ('tripledes', '', 'ecb', '');
$iv = mcrypt_create_iv (mcrypt_enc_get_iv_size ($td), MCRYPT_RAND);
mcrypt_generic_init ($td, $key, $iv);
$encrypted_data = mcrypt_generic ($td, $input);
mcrypt_generic_end ($td);
?>
|
|
Это пример даст данные, зашифрованные как строка в$encrypted_data. Полный пример см. в описании
mcrypt_module_open()
.
Эти функции работают с использованием
mcrypt.
Если вы связаны с библиотекой libmcrypt 2.4.x или выше, поддерживаются
следующие дополнительные алгоритмы блока: CAST, LOKI97, RIJNDAEL, SAFERPLUS,
SERPENT, и шифровальщики потока: ENIGMA (crypt), PANAMA, RC4 и
WAKE. С библиотекой libmcrypt 2.4.x или выше доступен также режим шифровки nOFB.
Загрузите libmcrypt-x.x.tar.gz отсюда
и следуйте инструкциям по установке. Вам необходимо скомпилировать PHP с параметром --with-mcrypt, чтобы подключить данное расширение. Убедитесь, что вы компилируете libmcrypt
с опцией --disable-posix-threads.
Это расширение не определяет никакие типы ресурсов.
Mcrypt может работать с четырьмя режимами шифровки (CBC, OFB, CFB и
ECB). Если связь имеется с библиотекой libmcrypt-2.4.x или выше, эти
функции могут также работать с блок-режимом шифровки nOFB и в режиме STREAM.
Ниже вы найдёте список всех поддерживаемых режимов шифровки с константами,
определёнными для данного режима. Более полную справку и обсуждение вы
найдёте в Applied Cryptography by Schneier (ISBN 0-471-11709-9).
-
MCRYPT_MODE_ECB (electronic codebook/электронная кодовая книга)
подходит для произвольных данных, таких как шифрование других ключей. Поскольку данные здесь случайны и
кратки, недостатки ECB имеют положительный побочный эффект.
-
MCRYPT_MODE_CBC (cipher block chaining) специально предназначен для
шифрования файлов; безопасность значительно выше, чем у ECB.
-
MCRYPT_MODE_CFB (cipher feedback) - наилучший режим для шифровки
байтовых потоков, где должны шифроваться отдельные байты.
-
MCRYPT_MODE_OFB (output feedback, в 8bit) сравним с CFB, но
используется в приложениях, где недопустима передача ошибок. Небезопасен (поскольку
работает в 8-битном режиме), поэтому использовать его не рекомендуется.
-
MCRYPT_MODE_NOFB (output feedback, в nbit) сравним с OFB, но более
безопасен, поскольку оперирует с размером блоков по алгоритму.
-
MCRYPT_MODE_STREAM - дополнительный режим для включения алгоритмов потока вроде WAKE или RC4.
Вот список шифров, которые в настоящее время поддерживаются расширением mcrypt.
Полны список см. в определениях в конце файла mcrypt.h. Общее правило для
mcrypt-2.2.x API таково: вы можете получить доступ к шифру из PHP с помощью MCRYPT_ciphername.
С libmcrypt-2.4.x и libmcrypt-2.5.x API эти константы также работают,
но можно специфицировать имя шифра как строку с вызовом
mcrypt_module_open()
.
-
MCRYPT_3DES
-
MCRYPT_ARCFOUR_IV (только libmcrypt > 2.4.x)
-
MCRYPT_ARCFOUR (только libmcrypt > 2.4.x)
-
MCRYPT_BLOWFISH
-
MCRYPT_CAST_128
-
MCRYPT_CAST_256
-
MCRYPT_CRYPT
-
MCRYPT_DES
-
MCRYPT_DES_COMPAT (только libmcrypt > 2.2.x)
-
MCRYPT_ENIGMA (только libmcrypt > 2.4.x, псевдоним для MCRYPT_CRYPT)
-
MCRYPT_GOST
-
MCRYPT_IDEA (non-free/не свободный ресурс)
-
MCRYPT_LOKI97 (только libmcrypt > 2.4.x)
-
MCRYPT_MARS (только libmcrypt > 2.4.x, non-free)
-
MCRYPT_PANAMA (только libmcrypt > 2.4.x)
-
MCRYPT_RIJNDAEL_128 (только libmcrypt > 2.4.x)
-
MCRYPT_RIJNDAEL_192 (только libmcrypt > 2.4.x)
-
MCRYPT_RIJNDAEL_256 (только libmcrypt > 2.4.x)
-
MCRYPT_RC2
-
MCRYPT_RC4 (только libmcrypt > 2.2.x)
-
MCRYPT_RC6 (только libmcrypt > 2.4.x)
-
MCRYPT_RC6_128 (только libmcrypt > 2.2.x)
-
MCRYPT_RC6_192 (только libmcrypt > 2.2.x)
-
MCRYPT_RC6_256 (только libmcrypt > 2.2.x)
-
MCRYPT_SAFER64
-
MCRYPT_SAFER128
-
MCRYPT_SAFERPLUS (только libmcrypt > 2.4.x)
-
MCRYPT_SERPENT(только libmcrypt > 2.4.x)
-
MCRYPT_SERPENT_128 (только libmcrypt > 2.2.x)
-
MCRYPT_SERPENT_192 (только libmcrypt > 2.2.x)
-
MCRYPT_SERPENT_256 (только libmcrypt > 2.2.x)
-
MCRYPT_SKIPJACK (только libmcrypt > 2.4.x)
-
MCRYPT_TEAN (только libmcrypt > 2.2.x)
-
MCRYPT_THREEWAY
-
MCRYPT_TRIPLEDES (только libmcrypt > 2.4.x)
-
MCRYPT_TWOFISH (для старых версий mcrypt 2.x или для mcrypt > 2.4.x )
-
MCRYPT_TWOFISH128 (TWOFISHxxx доступны в новых версиях 2.x, но не в версиях 2.4.x)
-
MCRYPT_TWOFISH192
-
MCRYPT_TWOFISH256
-
MCRYPT_WAKE (только libmcrypt > 2.4.x)
-
MCRYPT_XTEA (только libmcrypt > 2.4.x)
Вы обязаны (в режимах CFB и OFB) или можете (в режиме CBC) поддерживать
вектор инициализации /initialization vector (IV) для соответствующей функции шифровки. Этот
IV обязан быть уникальным и обязан быть тем же самым при дешифровке/шифровке.
Для данных, которые хранятся в шифрованном виде, вы можете получить вывод
функции индекса, под которым данные хранятся (например, MD5-ключ имени файла).
Альтернативно вы можете передать IV вместе с шифрованными данными (см. в
Главе 9.3 в Applied Cryptography by Schneier (ISBN 0-471-11709-9) обсуждение этого вопроса).
-
Содержание
-
mcrypt_cbc - шифрует/дешифрует данные в режиме CBC
-
mcrypt_cfb - шифрует/дешифрует данные в режиме CFB
-
mcrypt_create_iv - создаёт вектор инициализации (IV) из произвольного ресурса
-
mcrypt_decrypt - дешифрует crypttext с заданными параметрами
-
mcrypt_ecb - шифрует/дешифрует данные в режиме ECB mode
-
mcrypt_enc_get_algorithms_name - возвращает имя открытого алгоритма
-
mcrypt_enc_get_block_size - возвращает размер блока открытого алгоритма
-
mcrypt_enc_get_iv_size - возвращает размер IV открытого алгоритма
-
mcrypt_enc_get_key_size - возвращает максимальны поддерживаемый keysize/размер ключа открытого режима
-
mcrypt_enc_get_modes_name - возвращает имя открытого режима
-
mcrypt_enc_get_supported_key_sizes - возвращает массив с поддерживаемыми размерами ключей открытого алгоритма
-
mcrypt_enc_is_block_algorithm_mode - проверяет, работает ли шифровка открытого режима с блоками
-
mcrypt_enc_is_block_algorithm - проверяет, является ли алгоритм открытого режима алгоритмом блока
-
mcrypt_enc_is_block_mode - проверяет, выводит ли открытый режим блоки
-
mcrypt_enc_self_test - эта функция запускает самопроверку в открытом модуле
-
mcrypt_encrypt - шифрует обычный текст с заданными параметрами
-
mcrypt_generic_deinit - эта функция деинициализирует модуль шифровки
-
mcrypt_generic_end - эта функция прерывает шифровку
-
mcrypt_generic_init - эта функция инициализирует все буферы, необходимые для шифрования
-
mcrypt_generic - эта функция шифрует данные
-
mcrypt_get_block_size - получает размер блока специфицированного шифра
-
mcrypt_get_cipher_name - получает имя специфицированного шифра
-
mcrypt_get_iv_size - возвращает размер IV, принадлежащего специфицированной комбинации шифр/режим
-
mcrypt_get_key_size - получает размер ключа специфицированного шифра
-
mcrypt_list_algorithms - получает массив всех поддерживаемых шифров
-
mcrypt_list_modes - получает массив всех поддерживаемых режимов
-
mcrypt_module_close - закрывает mcrypt-модуль
-
mcrypt_module_get_algo_block_size - возвращает размер блока специфицированного алгоритма
-
mcrypt_module_get_algo_key_size - возвращает максимальный поддерживаемый keysize открытого режима
-
mcrypt_module_get_supported_key_sizes - возвращает массив с поддерживаемыми keysizes открытого алгоритма
-
mcrypt_module_is_block_algorithm_mode - эта функция возвращает, является ли специфицированный модуль алгоритмом блока, или нет
-
mcrypt_module_is_block_algorithm - эта функция проверяет, является ли специфицированный алгоритм алгоритмом блока
-
mcrypt_module_is_block_mode - эта функция возвращает, выводит специфицированный режим блоки, или нет
-
mcrypt_module_open - эта функция открывает модуль алгоритма и используемый режим
-
mcrypt_module_self_test - эта функция запускает самопроверку в специфицированном модуле
-
mcrypt_ofb - шифрует/дешифрует данные в режиме OFB
-
mdecrypt_generic - эта функция дешифрует данные
|
|
