sodium_crypto_aead_xchacha20poly1305_ietf_encrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_xchacha20poly1305_ietf_encryptXChaCha20-Poly1305 を使って暗号化し、認証を行う(AEADモードのうちもっとも好ましい)

説明

sodium_crypto_aead_xchacha20poly1305_ietf_encrypt(
    string $message,
    string $additional_data,
    string $nonce,
    string $key
): string

XChaCha20-Poly1305 (eXtended-nonce バリアント) を使って暗号化し、認証を行います。

一般的には、提供されている AEADモードの中で、 XChaCha20-Poly1305 を使うのがもっとも好ましいです。

パラメータ

message

暗号化するプレーンテキスト

additional_data

追加の認証データ。 これは、 暗号化されたテキストに追加された認証タグを検証するのに用いられますが、 このデータは暗号化されていませんし、 暗号化されたテキストにも保存されません。

nonce

メッセージごとに一度だけ使われる数値。 長さは24バイトです。 これは、 (たとえば、random_bytes()を使って) ランダムな値を生成するのに十分大きな長さです。

key

暗号化キー(256ビット)

戻り値

成功時に、暗号化されたテキストとタグを返します。 失敗した場合に false を返します.

関連キーワード:  暗号, sodium, string, 認証, crypto, poly, xchacha, aead, Poly, XChaCha