sodium_crypto_secretbox_open

#[\SensitiveParameter] sodium_crypto_secretbox_open(string $ciphertext, string $nonce, string $key): string
```php

Desencriptación de un mensaje cifrado con una clave simétrica (compartida).

## Parámetros

`ciphertext`  
Debe estar en el formato proporcionado por `sodium_crypto_secretbox` (concatenación del texto cifrado y del tag).

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

`key`  
La clave de cifrado (256 bits).

## Valores devueltos

La cadena desencriptada en caso de éxito o `false` si ocurre un error.

## Errores/Excepciones

- Si `nonce` tiene una longitud de bytes diferente de [`SODIUM_CRYPTO_SECRETBOX_NONCEBYTES`](#constant.sodium-crypto-secretbox-noncebytes) (24 bytes), se lanzará una `SodiumException`.

- Si `key` tiene una longitud de bytes diferente de [`SODIUM_CRYPTO_SECRETBOX_KEYBYTES`](#constant.sodium-crypto-secretbox-keybytes) (32 bytes), se lanzará una `SodiumException`.

## Ejemplos

Ejemplo de `sodium_crypto_secretbox_open`

mensaje a ser cifrado