Класс Безопасность
Библиотека безопасности содержит служебные методы, связанные с безопасностью
Краткое описание свойств
- Реализация криптографического алгоритма для использования.
object - Соль HMAC для использования в криптографических операциях шифрования и дешифрования.
string -
stringМетод хэширования по умолчанию. Если параметр
$typeдляSecurity::hash()не указан, используется это значение. По умолчанию 'sha1'.
Краткое описание методов
- Проверка ключа шифрования на соответствие длине.
- Сравнение, устойчивое к атакам на время выполнения, отдающее предпочтение собственным реализациям PHP.
- Дешифровка значения с использованием AES-256.
- Шифрование значения с использованием AES-256.
- Получение криптографической реализации на основе загруженных расширений.
-
Получение соли HMAC для использования в криптографических операциях шифрования/дешифрования.
- Генерация хэша строки с использованием указанного метода.
- Аналогично randomBytes(), но не обеспечивает криптографической безопасности.
- Получение случайных байтов из безопасного источника.
- Шифрование/дешифрование текста с использованием заданного ключа методом rijndael.
-
Получение или установка соли HMAC для использования в криптографических операциях шифрования/дешифрования.
-
Установка метода хэширования по умолчанию для объекта Security. Это влияет на все объекты, использующие Security::hash().
-
Установка соли HMAC для использования в криптографических операциях шифрования/дешифрования.
Подробное описание методов
_checkKey()source protected static
_checkKey( string $key , string $method )
Проверка ключа шифрования на соответствие длине.
Параметры
- строка
$key - Ключ для проверки.
- строка
$method - Метод, для которого проверяется ключ.
Исключения
InvalidArgumentExceptionКогда длина ключа не соответствует 256 бит/32 байтам
_constantEquals()source protected static
_constantEquals( string $hmac , string $compare )
Сравнение, устойчивое к атакам на время выполнения, отдающее предпочтение собственным реализациям PHP.
Параметры
- строка
$hmac - HMAC из шифрованного текста, который дешифруется.
- строка
$compare - HMAC для сравнения.
Возвращаемое значение
booleanСм. также
https://github.com/resonantcore/php-future/decrypt()source public static
decrypt( string $cipher , string $key , string|null $hmacSalt null )
Дешифровка значения с использованием AES-256.
Параметры
- строка
$cipher - Зашифрованный текст для дешифрования.
- строка
$key - Ключ длиной 256 бит/32 байта, используемый в качестве ключа шифра.
- строка|null
$hmacSaltнеобязательно null - Соль для HMAC. Оставьте null, чтобы использовать Security.salt.
Возвращаемое значение
строка|booleanРасшифрованные данные. Любые завершающие нулевые байты будут удалены.
Исключения
InvalidArgumentExceptionПри некорректных данных или ключе.
encrypt()source public static
encrypt( string $plain , string $key , string|null $hmacSalt null )
Шифрование значения с использованием AES-256.
Примечание Вы не можете правильно зашифровать/расшифровать данные с завершающими нулевыми байтами. Любые завершающие нулевые байты будут удалены при дешифровке из-за того, как PHP дополняет сообщения нулями перед шифрованием.
Параметры
- строка
$plain - Значение для шифрования.
- строка
$key - Ключ длиной 256 бит/32 байта, используемый в качестве ключа шифра.
- строка|null
$hmacSaltнеобязательно null - Соль для HMAC. Оставьте null, чтобы использовать Security.salt.
Возвращаемое значение
строкаЗашифрованные данные.
Исключения
InvalidArgumentExceptionПри некорректных данных или ключе.
engine()source public static
engine( Cake\Utility\Crypto\OpenSsl|Cake\Utility\Crypto\Mcrypt|null $instance null )
Получение криптографической реализации на основе загруженных расширений.
Вы можете использовать этот метод, чтобы принудительно выбрать между реализациями mcrypt/openssl/custom.
Параметры
- Cake\Utility\Crypto\OpenSsl|Cake\Utility\Crypto\Mcrypt|null
$instanceнеобязательно null - Экземпляр криптографической реализации для использования.
Возвращаемое значение
Cake\Utility\Crypto\OpenSsl|Cake\Utility\Crypto\McryptЭкземпляр криптографической реализации.
Исключения
InvalidArgumentExceptionЕсли совместимое криптографическое расширение недоступно.
getSalt()source public static
getSalt( )
Получение соли HMAC, используемой для операций шифрования/дешифрования.
Возвращаемое значение
строкаТекущая настроенная соль
hash()source public static
hash( string $string , string|null $type null , mixed $salt false )
Генерация хэша строки с использованием указанного метода.
Параметры
- строка
$string - Строка для хэширования
- строка|null
$typeнеобязательно null Алгоритм хэширования (например, sha1, sha256 и т. д.). Может быть любым допустимым алгоритмом, включённым в список, возвращаемый hash_algos(). Если значение не передано, используется тип, указанный в
Security::$hashType.- смешанное
$saltнеобязательно false Если true, к строке $string автоматически добавляется соль приложения (Security.salt).
Возвращаемое значение
строкаХэш
Ссылка
https://book.cakephp.org/3.0/en/core-libraries/security.html#hashing-datainsecureRandomBytes()source public static
insecureRandomBytes( integer $length )
Аналогично randomBytes(), но не обеспечивает криптографической безопасности.
Параметры
- целое число
$length - Количество байтов.
Возвращаемое значение
строкаСлучайные байты в двоичном формате.
См. также
\Cake\Utility\Security::randomBytes()randomBytes()source public static
randomBytes( integer $length )
Получить случайные байты из защищённого источника.
Этот метод будет использовать небезопасный источник и выведет предупреждение, если не сможет найти защищённый источник случайных данных.
Параметры
- целое число
$length - Количество байтов, которые требуется получить.
Возвращаемые значения
строкаСлучайные байты в двоичном формате.
rijndael()source public static
rijndael( string $text , string $key , string $operation )
Шифрование/дешифрование текста с помощью заданного ключа с помощью метода rijndael.
Параметры
- строка
$text - Зашифрованная строка для дешифрования, обычная строка для шифрования
- строка
$key - Ключ, используемый в качестве ключа шифрования для зашифрованных данных.
- строка
$operation - Операция, которую нужно выполнить, шифрование или дешифрование
Возвращаемые значения
строкаЗашифрованная/дешифрованная строка
Исключения
InvalidArgumentExceptionПри возникновении ошибок.
salt()source public static
salt( string|null $salt null )
Получение или установка соли HMAC, которая используется для операций шифрования/дешифрования.
Устаревшее
3.5.0 Используйте getSalt()/setSalt() вместо этого.Параметры
- строка|null
$saltнеобязательный null - Соль, которая должна быть использована для операций шифрования. Если null, возвращается текущая соль.
Возвращаемые значения
строкаТекущая настроенная соль
setHash()source public static
setHash( string $hash )
Устанавливает метод хеширования по умолчанию для объекта Security. Это влияет на все объекты, использующие Security::hash().
Параметры
- строка
$hash - Метод для использования (sha1/sha256/md5 и т.д.)
См. также
\Cake\Utility\Security::hash()setSalt()source public static
setSalt( string $salt )
Устанавливает соль HMAC, которая будет использоваться для операций шифрования/дешифрования.
Параметры
- строка
$salt - Соль, используемая для операций шифрования.
Подробности свойств
$_saltsource
protected static строка
Соль HMAC, используемая для операций шифрования и дешифрования.
$hashTypesource
public static строка
Метод хеширования по умолчанию. Если параметр $type для Security::hash() не указан, используется это значение. По умолчанию равно 'sha1'.
'sha1'
© 2005–2018 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.5/class-Cake.Utility.Security.html