sodium_crypto_aead_xchacha20poly1305_ietf_encrypt
XChaCha20-Poly1305 を使って暗号化し、認証を行う(AEADモードのうちもっとも好ましい)
説明
string sodium_crypto_aead_xchacha20poly1305_ietf_encrypt(
#[\SensitiveParameter]string $message,
string $additional_data,
string $nonce,
#[\SensitiveParameter]string $key
)
一般的には、提供されている AEADモードの中で、
XChaCha20-Poly1305 を使うのがもっとも好ましいです。
パラメータ
-
message
-
暗号化するプレーンテキスト
-
additional_data
-
追加の認証データ。
これは、
暗号化されたテキストに追加された認証タグを検証するのに用いられますが、
このデータは暗号化されていませんし、
暗号化されたテキストにも保存されません。
-
nonce
-
メッセージごとに一度だけ使われる数値。
長さは24バイトです。
これは、
(たとえば、random_bytesを使って)
ランダムな値を生成するのに十分大きな長さです。
-
key
-
暗号化キー(256ビット)
戻り値
成功時に、暗号化されたテキストとタグを返します。
失敗した場合に false を返します.