std.crypto.hkdf.assert
别名
别名目标 std.debug.assert
std.crypto.hkdf.Hkdf
类型函数
Hkdf 构造接受某种初始密钥材料来源, 从中派生一个或多个均匀分布的密钥。
pub fn Hkdf(comptime Hmac: type) type
参数
Hmac: type
std.crypto.hkdf.Hkdf.expand
函数
从主密钥 prk 和子密钥描述 ctx 派生子密钥。
pub fn expand(out: []u8, ctx: []const u8, prk: [prk_length]u8) void
参数
std.crypto.hkdf.Hkdf.extract
函数
从盐值和初始密钥材料返回主密钥。
pub fn extract(salt: []const u8, ikm: []const u8) [prk_length]u8
参数
salt: []const u8
ikm: []const u8
std.crypto.hkdf.Hkdf.extractInit
函数
初始化从盐值和密钥材料创建主密钥的过程, 密钥材料可以稍后添加,也可以分块添加。 示例:
var prk: [hkdf.prk_length]u8 = undefined;
var hkdf = HkdfSha256.extractInit(salt);
hkdf.update(ikm1);
hkdf.update(ikm2);
hkdf.final(&prk);
pub fn extractInit(salt: []const u8) Hmac
参数
salt: []const u8
std.crypto.hkdf.Hkdf.prk_length
常量
主密钥的长度,单位为字节。
std.crypto.hkdf.HkdfSha256
类型
HKDF-SHA256
std.crypto.hkdf.HkdfSha512
类型
HKDF-SHA512
std.crypto.hkdf.hmac
别名
别名目标 std.crypto.auth.hmac
std.crypto.hkdf.htest
常量
std.crypto.hkdf.mem
别名
别名目标 std.mem
std.crypto.hkdf.std
别名
别名目标 std
源码
std/crypto/hkdf.zig
const std = @import("../std.zig");
const assert = std.debug.assert;
const hmac = std.crypto.auth.hmac;
const mem = std.mem;
/// HKDF-SHA256
pub const HkdfSha256 = Hkdf(hmac.sha2.HmacSha256);
/// HKDF-SHA512
pub const HkdfSha512 = Hkdf(hmac.sha2.HmacSha512);
/// Hkdf 构造接受某种初始密钥材料来源,
/// 从中派生一个或多个均匀分布的密钥。
pub fn Hkdf(comptime Hmac: type) type {
return struct {
/// 主密钥的长度,单位为字节。
pub const prk_length = Hmac.mac_length;
/// 从盐值和初始密钥材料返回主密钥。
pub fn extract(salt: []const u8, ikm: []const u8) [prk_length]u8 {
var prk: [prk_length]u8 = undefined;
Hmac.create(&prk, ikm, salt);
return prk;
}
/// 初始化从盐值和密钥材料创建主密钥的过程,
/// 密钥材料可以稍后添加,也可以分块添加。
/// 示例:
/// ```
/// var prk: [hkdf.prk_length]u8 = undefined;
/// var hkdf = HkdfSha256.extractInit(salt);
/// hkdf.update(ikm1);
/// hkdf.update(ikm2);
/// hkdf.final(&prk);
/// ```
pub fn extractInit(salt: []const u8) Hmac {
return Hmac.init(salt);
}
/// 从主密钥 `prk` 和子密钥描述 `ctx` 派生子密钥。
pub fn expand(out: []u8, ctx: []const u8, prk: [prk_length]u8) void {
assert(out.len <= prk_length * 255); // 对于 Hkdf 构造,输出大小过大
var i: usize = 0;
var counter = [1]u8{1};
while (i + prk_length <= out.len) : (i += prk_length) {
var st = Hmac.init(&prk);
if (i != 0) {
st.update(out[i - prk_length ..][0..prk_length]);
}
st.update(ctx);
st.update(&counter);
st.final(out[i..][0..prk_length]);
counter[0] +%= 1;
assert(counter[0] != 1);
}
const left = out.len % prk_length;
if (left > 0) {
var st = Hmac.init(&prk);
if (i != 0) {
st.update(out[i - prk_length ..][0..prk_length]);
}
st.update(ctx);
st.update(&counter);
var tmp: [prk_length]u8 = undefined;
st.final(tmp[0..prk_length]);
@memcpy(out[i..][0..left], tmp[0..left]);
}
}
};
}
const htest = @import("test.zig");
test "Hkdf" {
const ikm: [22]u8 = @splat(0x0b);
const salt = [_]u8{ 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0a, 0x0b, 0x0c };
const context = [_]u8{ 0xf0, 0xf1, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7, 0xf8, 0xf9 };
const kdf = HkdfSha256;
const prk = kdf.extract(&salt, &ikm);
try htest.assertEqual("077709362c2e32df0ddc3f0dc47bba6390b6c73bb50f9c3122ec844ad7c2b3e5", &prk);
var out: [42]u8 = undefined;
kdf.expand(&out, &context, prk);
try htest.assertEqual("3cb25f25faacd57a90434f64d0362f2a2d2d0a90cf1a5a4c5db02d56ecc4c5bf34007208d5b887185865", &out);
var hkdf = kdf.extractInit(&salt);
hkdf.update(&ikm);
var prk2: [kdf.prk_length]u8 = undefined;
hkdf.final(&prk2);
try htest.assertEqual("077709362c2e32df0ddc3f0dc47bba6390b6c73bb50f9c3122ec844ad7c2b3e5", &prk2);
}
test "Hkdf Sha3-512" {
const sha3_512 = std.crypto.hash.sha3.Sha3_512;
const hmac_sha3_512 = hmac.Hmac(sha3_512);
const hkdf = Hkdf(hmac_sha3_512);
const prk = hkdf.extract("", "");
var out = [1]u8{0};
hkdf.expand(out[0..], "", prk);
}