sodium_crypto_secretbox_open

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_secretbox_open — Розшифровка за допомогою спільного ключа з автентифікацією

Опис

sodium_crypto_secretbox_open(string $ciphertext, string $nonce, string $key): string|false

Розшифровує зашифроване повідомлення симетричним (загальним) ключем.

Список параметрів

ciphertext

Має бути у форматі, наданому sodium_crypto_secretbox() (Зашифрований текст та тег, об'єднані).

nonce

Номер, який потрібно використовувати лише один раз для кожного повідомлення. Довжина 24 байти. Це досить велика межа для випадкової генерації (наприклад, random_bytes()

key

Ключ шифрування (256 біт).

Значення, що повертаються

Розшифрований рядок у разі успішного виконання або **false**в случае возникновения ошибки.

Помилки

• Викидається SodiumExceptionякщо довжина байтів параметраnonce відрізняється від SODIUM_CRYPTO_SECRETBOX_NONCEBYTES(24 байти).
• Викидається SodiumExceptionякщо довжина байтів параметраkey відрізняється від SODIUM_CRYPTO_SECRETBOX_KEYBYTES(32 байти).

Приклади

Приклад #1 Приклад використання sodium_crypto_secretbox_open()****

Loading...
▶

Результат виконання наведеного прикладу:

message to be encrypted

Дивіться також

• sodium_crypto_secretbox() - Шифрування із загальним ключем з автентифікацією
• sodium_crypto_secretbox_keygen() - Створює випадковий ключ для sodium_crypto_secretbox
• random_bytes() - Отримує криптографічно безпечні випадкові байти