From 414018232113768fa9e89b080dbc1c6f77767d24 Mon Sep 17 00:00:00 2001 From: "SUMIDA, Ippei" Date: Tue, 19 Nov 2024 19:43:14 +0900 Subject: [PATCH 1/3] =?UTF-8?q?Sodium=E9=96=A2=E6=95=B0=E8=BF=BD=E5=8A=A0?= =?UTF-8?q?=E5=88=86=E3=81=AE=E7=BF=BB=E8=A8=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/sodium/constants.xml | 88 +++++++++++++++ .../sodium-crypto-aead-aegis128l-decrypt.xml | 101 ++++++++++++++++++ .../sodium-crypto-aead-aegis128l-encrypt.xml | 97 +++++++++++++++++ .../sodium-crypto-aead-aegis128l-keygen.xml | 59 ++++++++++ .../sodium-crypto-aead-aegis256-decrypt.xml | 100 +++++++++++++++++ .../sodium-crypto-aead-aegis256-encrypt.xml | 97 +++++++++++++++++ .../sodium-crypto-aead-aegis256-keygen.xml | 59 ++++++++++ 7 files changed, 601 insertions(+) create mode 100644 reference/sodium/functions/sodium-crypto-aead-aegis128l-decrypt.xml create mode 100644 reference/sodium/functions/sodium-crypto-aead-aegis128l-encrypt.xml create mode 100644 reference/sodium/functions/sodium-crypto-aead-aegis128l-keygen.xml create mode 100644 reference/sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml create mode 100644 reference/sodium/functions/sodium-crypto-aead-aegis256-encrypt.xml create mode 100644 reference/sodium/functions/sodium-crypto-aead-aegis256-keygen.xml diff --git a/reference/sodium/constants.xml b/reference/sodium/constants.xml index c13a4e6fec..92c377695c 100644 --- a/reference/sodium/constants.xml +++ b/reference/sodium/constants.xml @@ -77,6 +77,94 @@ + + + SODIUM_CRYPTO_AEAD_AEGIS128L_KEYBYTES + (int) + + + + PHP 8.4.0 以降で利用可能です。 + + + + + + SODIUM_CRYPTO_AEAD_AEGIS128L_NSECBYTES + (int) + + + + PHP 8.4.0 以降で利用可能です。 + + + + + + SODIUM_CRYPTO_AEAD_AEGIS128L_NPUBBYTES + (int) + + + + PHP 8.4.0 以降で利用可能です。 + + + + + + SODIUM_CRYPTO_AEAD_AEGIS128L_ABYTES + (int) + + + + PHP 8.4.0 以降で利用可能です。 + + + + + + SODIUM_CRYPTO_AEAD_AEGIS256_KEYBYTES + (int) + + + + Available as of PHP 8.4.0. + + + + + + SODIUM_CRYPTO_AEAD_AEGIS256_NSECBYTES + (int) + + + + PHP 8.4.0 以降で利用可能です。 + + + + + + SODIUM_CRYPTO_AEAD_AEGIS256_NPUBBYTES + (int) + + + + PHP 8.4.0 以降で利用可能です。 + + + + + + SODIUM_CRYPTO_AEAD_AEGIS256_ABYTES + (int) + + + + PHP 8.4.0 以降で利用可能です。 + + + SODIUM_CRYPTO_AEAD_AES256GCM_KEYBYTES diff --git a/reference/sodium/functions/sodium-crypto-aead-aegis128l-decrypt.xml b/reference/sodium/functions/sodium-crypto-aead-aegis128l-decrypt.xml new file mode 100644 index 0000000000..740274a1fb --- /dev/null +++ b/reference/sodium/functions/sodium-crypto-aead-aegis128l-decrypt.xml @@ -0,0 +1,101 @@ + + + + + + sodium_crypto_aead_aegis128l_decrypt + AEGIS-128L を用いてメッセージを検証し、複合する + + + + &reftitle.description; + + stringfalsesodium_crypto_aead_aegis128l_decrypt + stringciphertext + stringadditional_data + stringnonce + #[\SensitiveParameter]stringkey + + + AEGIS-128L を用いてメッセージを検証し、複合します。 + + + + + &reftitle.parameters; + + + ciphertext + + + sodium_crypto_aead_aegis128l_encrypt が生成したフォーマットでなければなりません。 + + + + + additional_data + + + 追加の認証データ。 + これは、 + 暗号化されたテキストに追加された認証タグを検証するのに用いられますが、 + このデータは暗号化されていませんし、 + 暗号化されたテキストにも保存されていません。 + + + + + nonce + + + メッセージごとに一度だけ使われる数値。 + + + + + key + + + 暗号化キー(128ビット). + + + + + + + + &reftitle.returnvalues; + + 成功時にプレーンテキストを返します。 + &return.falseforfailure; + + + + + &reftitle.seealso; + + sodium_crypto_aead_aegis128l_encrypt + sodium_crypto_aead_aegis128l_keygen + + + + diff --git a/reference/sodium/functions/sodium-crypto-aead-aegis128l-encrypt.xml b/reference/sodium/functions/sodium-crypto-aead-aegis128l-encrypt.xml new file mode 100644 index 0000000000..0accd1519f --- /dev/null +++ b/reference/sodium/functions/sodium-crypto-aead-aegis128l-encrypt.xml @@ -0,0 +1,97 @@ + + + + + + sodium_crypto_aead_aegis128l_encrypt + AEGIS-128L を使って暗号化し、認証を行う + + + &reftitle.description; + + stringsodium_crypto_aead_aegis128l_encrypt + #[\SensitiveParameter]stringmessage + stringadditional_data + stringnonce + #[\SensitiveParameter]stringkey + + + AEGIS-128L を使って暗号化し、認証を行います。 + + + + &reftitle.parameters; + + + message + + + 暗号化するプレーンテキスト + + + + + additional_data + + + 追加の認証データ。 + これは、 + 暗号化されたテキストに追加された認証タグを検証するのに用いられますが、 + このデータは暗号化されていませんし、 + 暗号化されたテキストにも保存されません。 + + + + + nonce + + + メッセージごとに一度だけ使われる数値。 + + + + + key + + + 暗号化キー(128ビット). + + + + + + + &reftitle.returnvalues; + + 暗号化されたテキストと、 + 認証タグを生のバイナリのバイト列に含めた文字列を返します。 + + + + &reftitle.seealso; + + sodium_crypto_aead_aegis128l_decrypt + sodium_crypto_aead_aegis128l_keygen + + + + diff --git a/reference/sodium/functions/sodium-crypto-aead-aegis128l-keygen.xml b/reference/sodium/functions/sodium-crypto-aead-aegis128l-keygen.xml new file mode 100644 index 0000000000..19de3ba6e7 --- /dev/null +++ b/reference/sodium/functions/sodium-crypto-aead-aegis128l-keygen.xml @@ -0,0 +1,59 @@ + + + + + + sodium_crypto_aead_aegis128l_keygen + Generate a random AEGIS-128L key + + + &reftitle.description; + + stringsodium_crypto_aead_aegis128l_keygen + + + + sodium_crypto_aead_aegis128l_encrypt + や + sodium_crypto_aead_aegis128l_decrypt + で使うランダムな鍵を生成します。 + + + + &reftitle.parameters; + &no.function.parameters; + + + &reftitle.returnvalues; + + 128ビット長のランダムな暗号化キーを返します。 + + + + &reftitle.seealso; + + sodium_crypto_aead_aegis128l_decrypt + sodium_crypto_aead_aegis128l_encrypt + + + + diff --git a/reference/sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml b/reference/sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml new file mode 100644 index 0000000000..b208e5dbfe --- /dev/null +++ b/reference/sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml @@ -0,0 +1,100 @@ + + + + + + sodium_crypto_aead_aegis256_decrypt + AEGIS-256 を用いてメッセージを検証し、復号する + + + &reftitle.description; + + stringfalsesodium_crypto_aead_aegis256_decrypt + stringciphertext + stringadditional_data + stringnonce + #[\SensitiveParameter]stringkey + + + AEGIS-256 を用いてメッセージを検証し、復号します。 + + + + &reftitle.parameters; + + + ciphertext + + + sodium_crypto_aead_aegis256_encrypt + が生成したフォーマット + (暗号化されたテキスト、タグを連結したもの) + でなければなりません。 + + + + + additional_data + + + 追加の認証データ。 + これは、 + 暗号化されたテキストに追加された認証タグを検証するのに用いられますが、 + このデータは暗号化されていませんし、 + 暗号化されたテキストにも保存されていません。 + + + + + nonce + + + メッセージごとに一度だけ使われる数値。 + + + + + key + + + 暗号化キー(256ビット) + + + + + + + &reftitle.returnvalues; + + 成功時にプレーンテキストを返します。 + &return.falseforfailure;. + + + + &reftitle.seealso; + + sodium_crypto_aead_aegis256_encrypt + sodium_crypto_aead_aegis256_keygen + + + + diff --git a/reference/sodium/functions/sodium-crypto-aead-aegis256-encrypt.xml b/reference/sodium/functions/sodium-crypto-aead-aegis256-encrypt.xml new file mode 100644 index 0000000000..77ca0ff568 --- /dev/null +++ b/reference/sodium/functions/sodium-crypto-aead-aegis256-encrypt.xml @@ -0,0 +1,97 @@ + + + + + + sodium_crypto_aead_aegis256_encrypt + AEGIS-256 を使って暗号化し、認証を行う + + + &reftitle.description; + + stringsodium_crypto_aead_aegis256_encrypt + #[\SensitiveParameter]stringmessage + stringadditional_data + stringnonce + #[\SensitiveParameter]stringkey + + + AEGIS-256 を使って暗号化し、認証を行います。 + + + + &reftitle.parameters; + + + message + + + 暗号化するプレーンテキスト + + + + + additional_data + + + 追加の認証データ。 + これは、 + 暗号化されたテキストに追加された認証タグを検証するのに用いられますが、 + このデータは暗号化されていませんし、 + 暗号化されたテキストにも保存されません。 + + + + + nonce + + + メッセージごとに一度だけ使われる数値。 + + + + + key + + + 暗号化キー(256ビット) + + + + + + + &reftitle.returnvalues; + + 暗号化されたテキストと、 + 認証タグを生のバイナリのバイト列に含めた文字列を返します。 + + + + &reftitle.seealso; + + sodium_crypto_aead_aegis256_decrypt + sodium_crypto_aead_aegis256_keygen + + + + diff --git a/reference/sodium/functions/sodium-crypto-aead-aegis256-keygen.xml b/reference/sodium/functions/sodium-crypto-aead-aegis256-keygen.xml new file mode 100644 index 0000000000..8c16de629e --- /dev/null +++ b/reference/sodium/functions/sodium-crypto-aead-aegis256-keygen.xml @@ -0,0 +1,59 @@ + + + + + + sodium_crypto_aead_aegis256_keygen + ランダムな AEGIS-256 暗号化キーを生成する + + + &reftitle.description; + + stringsodium_crypto_aead_aegis256_keygen + + + + sodium_crypto_aead_aegis256_encrypt + や + sodium_crypto_aead_aegis256_decrypt + で使うランダムな鍵を生成します。 + + + + &reftitle.parameters; + &no.function.parameters; + + + &reftitle.returnvalues; + + 256ビット長のランダムな暗号化キーを返します。 + + + + &reftitle.seealso; + + sodium_crypto_aead_aegis256_decrypt + sodium_crypto_aead_aegis256_encrypt + + + + From 3fa512cf043cde54eb62ee5b43eca334b649e411 Mon Sep 17 00:00:00 2001 From: "SUMIDA, Ippei" Date: Wed, 20 Nov 2024 08:59:43 +0900 Subject: [PATCH 2/3] =?UTF-8?q?revision=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/sodium/constants.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/sodium/constants.xml b/reference/sodium/constants.xml index 92c377695c..ee47200305 100644 --- a/reference/sodium/constants.xml +++ b/reference/sodium/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; From 4eac6d5ed9e869337df6b937207f722c2a5563db Mon Sep 17 00:00:00 2001 From: "SUMIDA, Ippei" Date: Wed, 20 Nov 2024 09:01:48 +0900 Subject: [PATCH 3/3] =?UTF-8?q?=E4=B8=8D=E8=A6=81=E3=81=AA=E7=BF=BB?= =?UTF-8?q?=E8=A8=B3=E3=81=AE=E5=89=8A=E9=99=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/reference/sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml b/reference/sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml index b208e5dbfe..e00296e407 100644 --- a/reference/sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml +++ b/reference/sodium/functions/sodium-crypto-aead-aegis256-decrypt.xml @@ -26,10 +26,7 @@ ciphertext - sodium_crypto_aead_aegis256_encrypt - が生成したフォーマット - (暗号化されたテキスト、タグを連結したもの) - でなければなりません。 + sodium_crypto_aead_aegis256_encrypt が生成したフォーマットでなければなりません。