# sodium_crypto_box

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_box — Chiffrement asymétrique authentifié

### Description

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

Chiffre un message en utilisant la cryptographie asymétrique (clé publique).

L'algorithme utilisé par les fonctions préfixées par sodium_crypto_box() est Diffie-Hellman sur la courbe de Montgomery, Curve25519; généralement abrégée en X25519.

### Liste de paramètres

`message`

  Le message à chiffrer.

`nonce`

  Un nombre qui doit être utilisé une seule fois, par message. 24 octets de long. Ceci est une limite suffisamment grande pour être générée aléatoirement (i.e. random_bytes()).

`key_pair`

  Voir sodium_crypto_box_keypair_from_secretkey_and_publickey(). Ceci inclut la clé publique de l'expéditeur et la clé secrète du destinataire.

### Valeurs de retour

Renvoie le message chiffré (ciphertext plus étiquette d'authentification). Le texte chiffré sera 16 octets plus long que le texte en clair, et une chaîne binaire brute. Voir sodium_bin2base64() pour un encodage sûr pour le stockage.