Шифрование и подпись

Криптографические операции: шифрование, HMAC, JWT и деривация ключей. Адаптировано для использования в workflow.

Подключение

local crypto = require("crypto")

Генерация случайных данных

Случайные байты

local bytes, err = crypto.random.bytes(32)

Возвращает: string, error

Случайная строка

local str, err = crypto.random.string(32)
local str, err = crypto.random.string(32, "0123456789abcdef")

Возвращает: string, error

Случайный UUID

local id, err = crypto.random.uuid()

Возвращает: string, error

HMAC

HMAC-SHA256

local hex, err = crypto.hmac.sha256(key, data)

Возвращает: string, error

HMAC-SHA512

local hex, err = crypto.hmac.sha512(key, data)

Возвращает: string, error

Шифрование

AES-GCM {id="encrypt-aes-gcm"}

local encrypted, err = crypto.encrypt.aes(data, key)
local encrypted, err = crypto.encrypt.aes(data, key, aad)

Возвращает: string, error — nonce в начале результата

ChaCha20-Poly1305 {id="encrypt-chacha20"}

local encrypted, err = crypto.encrypt.chacha20(data, key)
local encrypted, err = crypto.encrypt.chacha20(data, key, aad)

Возвращает: string, error

Расшифрование

AES-GCM {id="decrypt-aes-gcm"}

local plaintext, err = crypto.decrypt.aes(encrypted, key)
local plaintext, err = crypto.decrypt.aes(encrypted, key, aad)

Возвращает: string, error

ChaCha20-Poly1305 {id="decrypt-chacha20"}

local plaintext, err = crypto.decrypt.chacha20(encrypted, key)
local plaintext, err = crypto.decrypt.chacha20(encrypted, key, aad)

Возвращает: string, error

JWT

Кодирование

local token, err = crypto.jwt.encode(payload, secret)
local token, err = crypto.jwt.encode(payload, secret, "HS256")
local token, err = crypto.jwt.encode(payload, private_key_pem, "RS256")

Возвращает: string, error

Проверка

local claims, err = crypto.jwt.verify(token, secret)
local claims, err = crypto.jwt.verify(token, secret, "HS256", false)
local claims, err = crypto.jwt.verify(token, public_key_pem, "RS256")

Возвращает: table, error

Деривация ключей

PBKDF2

local key, err = crypto.pbkdf2(password, salt, iterations, key_length)
local key, err = crypto.pbkdf2(password, salt, iterations, key_length, "sha512")

Возвращает: string, error

Утилиты

Сравнение с постоянным временем

local equal = crypto.constant_time_compare(a, b)

Возвращает: boolean

Ошибки

Подробнее см. Обработка ошибок.