암호화 및 서명

crypto 모듈은 난수 생성, HMAC 계산, 데이터 암복호화, JWT 인코딩과 검증, 키 파생을 제공합니다. 결정론적 워크플로우에서는 난수 생성과 무작위 nonce를 만드는 암호화가 기록된 부작용으로 실행되며, 리플레이는 기록된 바이트를 반환합니다. HMAC, 복호화, JWT 처리, PBKDF2, 비교를 포함한 다른 작업은 직접 실행됩니다.

이 페이지는 API 레퍼런스입니다. 각 코드 블록은 완전한 키 관리 또는 인증 시스템이 아니라 독립된 호출입니다. data, key, aad, payload, token 같은 이름은 애플리케이션에서 제공하는 값입니다. 키와 비밀번호는 애플리케이션의 비밀 관리 경계를 통해 로드하고, 하드코딩하거나 로그 또는 진단 결과에 반환하지 마세요. 여기에 표시된 value, error 결과를 사용하기 전에 오류를 전파하거나 처리하세요.

로딩

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

구현은 제공된 알파벳에서 바이트를 선택합니다. 비 ASCII 알파벳은 잘못된 UTF-8로 분할될 수 있으며, 알파벳의 바이트 길이가 256의 약수일 때만 모듈로 선택이 정확히 균등합니다. 균등한 무작위 비밀 자료에는 crypto.random.bytes를 사용하고 필요한 전송 형식으로 결과를 인코딩하세요.

난수 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

문서에 나온 알고리즘 이름 중 하나만 전달하세요. 이 고정 런타임에서 지원하지 않는 값을 encode에 전달하면 오류 대신 HS256으로 폴백합니다. 호출 전에 설정 가능한 알고리즘을 검증하고 신뢰할 수 없는 필드를 _header에 복사하지 마세요. 특히 입력이 alg 같은 예약 JWT 헤더를 재정의하게 해서는 안 됩니다.

검증

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

exp와 nbf가 있으면 워크플로우 시간 기준이 아니라 JWT 라이브러리의 현재 wall clock을 기준으로 검증합니다. require_exp = false는 exp 클레임이 없어도 허용할 뿐, 존재하는 클레임의 검증을 비활성화하지 않습니다. 시간에 의존하는 결과를 리플레이에 민감한 워크플로우 제어에 사용하지 마세요. 액티비티에서 검사하거나 명시적으로 리플레이 안전한 값으로 시간을 검증하세요.

키 파생

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

길이가 다르면 결과는 false입니다. 기본 상수 시간 비교 보장은 길이가 같은 입력에 적용되므로, 고정 길이 다이제스트 또는 길이가 같은 비밀을 비교하세요.

에러

에러 처리는 에러 처리를 참조하세요.