Template
1
0
mirror of https://github.com/bol-van/zapret2.git synced 2026-03-14 06:13:09 +00:00

update docs

This commit is contained in:
bol-van
2025-12-15 17:02:57 +03:00
parent 8ea6a17942
commit 403413bb26

View File

@@ -1486,8 +1486,8 @@ function aes(encrypt, key, data)
Простое шифрование или дешифрование одного блока aes.
* encrypt - true - encrypt , false - decrypt
* key - raw строка. размер key должен быть 16,24,32 байт, что соответствует aes128,aes192,aes256
* data - raw строка. должен быть 16 байт
* key - raw строка. размер должен быть 16,24,32 байт, что соответствует aes128,aes192,aes256
* data - raw строка. размер должен быть 16 байт
* возвращается raw строка 16 байт с результатом операции
* в случае неверных размеров key или data вызывается error
@@ -1501,7 +1501,7 @@ function aes_gcm(encrypt, key, iv, data, associated_data)
* iv - raw строка 12 байт. ОБЯЗАТЕЛЬНО ГЕНЕРИРУЕТСЯ СЛУЧАЙНО ДЛЯ КАЖДОГО ШИФРУЕМОГО БЛОКА ДАННЫХ И ПЕРЕДАЕТСЯ ВМЕСТЕ С НИМ. При **ПОВТОРНОМ ИСПОЛЬЗОВАНИИ iv С ТЕМ ЖЕ КЛЮЧОМ ШИФРОВАНИЕ ЛЕГКО ВЗЛАМЫВАЕТСЯ**. Для генерации iv следует использовать bcryptorandom.
* data - raw строка произвольного размера. Шифр использует гамму, поэтому исходные данные не привязаны к размеру блока AES.
* associated_data - нешифруемые данные, передаваемые вместе с шифрованным сообщением и участвующие в подсчете atag. Может быть nil.
* возвращается 2 значения : raw строка - блок шифрованных данных и raw строка atag (authentication tag). atag может быть передан вместе с шифрованным сообщением и associated_data для проверки их целостности.
* возвращается 2 значения : raw строка - блок шифрованных данных и raw строка atag (authentication tag). atag может быть передан вместе с шифрованным сообщением, iv и associated_data для проверки их целостности.
* в случае неверных размеров key или iv вызывается error
```