VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-08-16 18:22:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update to English sodium-crypto-aead-xchacha20poly1305-ietf-encrypt.xml

Browse Source
This commit is contained in:
Mikhail Alferov
2024-05-23 09:17:29 +03:00
committed by GitHub
parent 22424237fd
commit da4c2583cf
1 changed files with 13 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
reference/sodium/functions/sodium-crypto-aead-xchacha20poly1305-ietf-encrypt.xml
View File

@ -1,26 +1,26 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14e3e35ca0c82b3b5fb3fd71b9dd70e9eb250ab1 Maintainer: lex Status: ready -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sodium-crypto-aead-xchacha20poly1305-ietf-encrypt">
<refentry xml:id="function.sodium-crypto-aead-xchacha20poly1305-ietf-encrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>sodium_crypto_aead_xchacha20poly1305_ietf_encrypt</refname>
<refpurpose>(Предпочтительно) Шифрует, а затем проверяет подлинность с помощью XChaCha20-Poly1305</refpurpose>
<refpurpose>(Предпочтительно) Шифрует, а затем проверяет подлинность алгоритмом XChaCha20-Poly1305</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>sodium_crypto_aead_xchacha20poly1305_ietf_encrypt</methodname>
<methodparam><type>string</type><parameter>message</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>message</parameter></methodparam>
<methodparam><type>string</type><parameter>additional_data</parameter></methodparam>
<methodparam><type>string</type><parameter>nonce</parameter></methodparam>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
Шифрует, а затем проверяет подлинность с помощью XChaCha20-Poly1305(вариант eXtended-nonce).
Функция шифрует, а затем проверяет подлинность алгоритмом XChaCha20-Poly1305(вариант eXtended-nonce).
</para>
<para>
Как правило, XChaCha20-Poly1305 - лучший из имеющихся режимов AEAD для использования.
Как правило, алгоритм XChaCha20-Poly1305 — лучший из имеющихся режимов AEAD.
</para>
</refsect1>
@ -40,8 +40,9 @@
<term><parameter>additional_data</parameter></term>
<listitem>
<para>
Дополнительные проверенные данные. Это используется при проверке тега подлинности, добавленного к зашифрованному тексту,
но он не шифруется и не сохраняется в зашифрованном тексте.
Дополнительные проверенные данные. Функция использует значение при проверке тега
подлинности, который добавили к зашифрованному тексту,
но не шифрует и не сохраняет в зашифрованном тексте.
</para>
</listitem>
</varlistentry>
@ -50,7 +51,7 @@
<listitem>
<para>
Номер, который необходимо использовать только один раз для каждого сообщения. Длина 24 байта.
Это достаточно большая граница для случайной генерации (например, <function>random_bytes</function>).
Это достаточно большая граница, чтобы её случайным образом (то есть функцией <function>random_bytes</function>).
</para>
</listitem>
</varlistentry>
@ -58,7 +59,7 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
Ключ шифрования (256 бит).
Ключ шифрования (256 битов).
</para>
</listitem>
</varlistentry>
@ -68,11 +69,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
В случае успешного выполнения возвращает зашифрованный текст и тег&return.falseforfailure;.
В случае успешного выполнения функция возвращает зашифрованный текст и тег&return.falseforfailure;.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables: