sodium_crypto_box

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_boxCifrado asimétrico autenticado

Descripción

sodium_crypto_box(#[\SensitiveParameter] string $message, string $nonce, #[\SensitiveParameter] string $key_pair): string

Cifra un mensaje utilizando criptografía asimétrica (clave pública).

El algoritmo utilizado por las funciones prefijadas por sodium_crypto_box() es Diffie-Hellman sobre la curva de Montgomery, Curve25519; generalmente abreviado como X25519.

Parámetros

message

El mensaje a cifrar.

nonce

Un número que debe ser utilizado una sola vez, por mensaje. 24 bytes de largo. Este es un límite suficientemente grande para ser generado aleatoriamente (i.e. random_bytes()).

key_pair

Ver sodium_crypto_box_keypair_from_secretkey_and_publickey(). Esto incluye la clave pública del remitente y la clave secreta del destinatario.

Valores devueltos

Devuelve el mensaje cifrado (ciphertext más etiqueta de autenticación). El texto cifrado será 16 bytes más largo que el texto en claro, y una string binaria bruta. Ver sodium_bin2base64() para un encodaje seguro para el almacenamiento.