openssl_encrypt
(PHP 5 >= 5.3.0, PHP 7)
openssl_encrypt — Шифрует данные
Описание
$data
, string $method
, string $key
, int $options = 0
, string $iv = ""
, string &$tag = NULL
, string $aad = ""
, int $tag_length = 16
) : string|falseШифрует данные с заданным шифром и ключом и возвращает необработанную строку, либо строку кодированную в base64
Список параметров
-
data -
Данные для шифрования.
-
method -
Метод шифрования. Список доступных методов можно получить с помощью функции openssl_get_cipher_methods().
-
key -
Кодовая фраза. Если кодовая фраза укорочена, чем ожидалось, она автоматически дополняется символами
NUL; если кодовая фраза длиннее, чем ожидалось, она автоматически усекается. -
options -
optionsможно задать одной из констант:OPENSSL_RAW_DATA,OPENSSL_ZERO_PADDING. -
iv -
Ненулевой инициализирующий вектор.
-
tag -
Тег аутентификации, передаваемый по ссылке, в режиме шифрования AEAD (GCM или CCM).
-
aad -
Дополнительные аутентификационные данные.
-
tag_length -
Длина параметра
tag. Для режима GCM должно быть от 4 до 16.
Возвращаемые значения
Возвращает зашифрованную строку или false в случае возникновения ошибки.
Ошибки
Выдает ошибку уровня E_WARNING, если в параметр
method передан неизвестный алгоритм шифрования.
Выдает ошибку уровня E_WARNING, если в параметр
iv передано пустое значение.
Список изменений
| Версия | Описание |
|---|---|
| 7.1.0 | Добавлены параметры tag, aad и tag_length. |
Примеры
Пример #1 Пример шифрования AES с аутентификацией в режиме GCM в PHP 7.1+
<?php
// $key должен быть сгенерирован заранее криптографически безопасным образом
// например, с помощью openssl_random_pseudo_bytes
$plaintext = "данные для шифрования";
$cipher = "aes-128-gcm";
if (in_array($cipher, openssl_get_cipher_methods()))
{
$ivlen = openssl_cipher_iv_length($cipher);
$iv = openssl_random_pseudo_bytes($ivlen);
$ciphertext = openssl_encrypt($plaintext, $cipher, $key, $options=0, $iv, $tag);
// сохраняем $cipher, $iv и $tag для дальнейшей расшифровки
$original_plaintext = openssl_decrypt($ciphertext, $cipher, $key, $options=0, $iv, $tag);
echo $original_plaintext."\n";
}
?>
Пример #2 Пример шифрования AES с аутентификацией в PHP 5.6+
<?php
// $key должен быть сгенерирован заранее криптографически безопасным образом
// например, с помощью openssl_random_pseudo_bytes
$plaintext = "данные для шифрования";
$ivlen = openssl_cipher_iv_length($cipher="AES-128-CBC");
$iv = openssl_random_pseudo_bytes($ivlen);
$ciphertext_raw = openssl_encrypt($plaintext, $cipher, $key, $options=OPENSSL_RAW_DATA, $iv);
$hmac = hash_hmac('sha256', $ciphertext_raw, $key, $as_binary=true);
$ciphertext = base64_encode( $iv.$hmac.$ciphertext_raw );
// расшифровка....
$c = base64_decode($ciphertext);
$ivlen = openssl_cipher_iv_length($cipher="AES-128-CBC");
$iv = substr($c, 0, $ivlen);
$hmac = substr($c, $ivlen, $sha2len=32);
$ciphertext_raw = substr($c, $ivlen+$sha2len);
$original_plaintext = openssl_decrypt($ciphertext_raw, $cipher, $key, $options=OPENSSL_RAW_DATA, $iv);
$calcmac = hash_hmac('sha256', $ciphertext_raw, $key, $as_binary=true);
if (hash_equals($hmac, $calcmac))// с PHP 5.6+ сравнение, не подверженное атаке по времени
{
echo $original_plaintext."\n";
}
?>