暗号化 & 署名

暗号化 & 署名

暗号化、HMAC、JWT、鍵導出を含む暗号操作を提供します。ワークフロー向けに適応されています。

ロード

local crypto = require("crypto")

乱数生成

ランダムバイト

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

パラメータ	型	説明
length	integer	バイト数（1から1,048,576）

戻り値: string, error

ランダム文字列

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

パラメータ	型	説明
length	integer	文字列長（1から1,048,576）
charset	string?	使用する文字（デフォルト: 英数字）

戻り値: string, error

ランダムUUID

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

戻り値: string, error

HMAC

HMAC-SHA256

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

パラメータ	型	説明
key	string	HMACキー
data	string	認証するデータ

戻り値: string, error

HMAC-SHA512

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

パラメータ	型	説明
key	string	HMACキー
data	string	認証するデータ

戻り値: 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)

パラメータ	型	説明
data	string	暗号化する平文
key	string	16、24、または32バイト（AES-128/192/256）
aad	string?	追加の認証データ

戻り値: 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)

パラメータ	型	説明
data	string	暗号化する平文
key	string	32バイトである必要あり
aad	string?	追加の認証データ

戻り値: 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)

パラメータ	型	説明
data	string	encrypt.aesからの暗号化データ
key	string	暗号化に使用した同じキー
aad	string?	暗号化で使用した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)

パラメータ	型	説明
data	string	encrypt.chacha20からの暗号化データ
key	string	暗号化に使用した同じキー
aad	string?	暗号化で使用した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")

パラメータ	型	説明
payload	table	JWTクレーム（カスタムヘッダーには_header）
key	string	シークレット（HMAC）またはPEM秘密鍵（RSA）
alg	string?	HS256、HS384、HS512、RS256（デフォルト: HS256）

戻り値: 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")

パラメータ	型	説明
token	string	検証するJWTトークン
key	string	シークレット（HMAC）またはPEM公開鍵（RSA）
alg	string?	期待するアルゴリズム（デフォルト: HS256）
require_exp	boolean?	有効期限を検証（デフォルト: true）

戻り値: table, error

鍵導出

PBKDF2

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

パラメータ	型	説明
password	string	パスワード/パスフレーズ
salt	string	ソルト値
iterations	integer	イテレーション回数（最大10,000,000）
key_length	integer	希望する鍵長（バイト）
hash	string?	sha256またはsha512（デフォルト: sha256）

戻り値: string, error

ユーティリティ

定数時間比較

local equal = crypto.constant_time_compare(a, b)

パラメータ	型	説明
a	string	最初の文字列
b	string	2番目の文字列

戻り値: boolean

エラー

条件	種別	再試行可能
無効な長さ	errors.INVALID	no
空のキー	errors.INVALID	no
無効なキーサイズ	errors.INVALID	no
復号失敗	errors.INTERNAL	no
トークン期限切れ	errors.INTERNAL	no

エラーの処理についてはエラー処理を参照。