3 * Copyright (c) 2011, Jouni Malinen <j@w1.fi>
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
16 * tls_prf_sha256 - Pseudo-Random Function for TLS v1.2 (P_SHA256, RFC 5246)
17 * @secret: Key for PRF
18 * @secret_len: Length of the key in bytes
19 * @label: A unique label for each purpose of the PRF
20 * @seed: Seed value to bind into the key
21 * @seed_len: Length of the seed
22 * @out: Buffer for the generated pseudo-random key
23 * @outlen: Number of bytes of key to generate
24 * Returns: 0 on success, -1 on failure.
26 * This function is used to derive new, cryptographically separate keys from a
27 * given key in TLS. This PRF is defined in RFC 2246, Chapter 5.
29 void tls_prf_sha256(const u8 *secret, size_t secret_len, const char *label,
30 const u8 *seed, size_t seed_len, u8 *out, size_t outlen)
36 const unsigned char *addr[3];
40 len[0] = SHA256_MAC_LEN;
41 addr[1] = (unsigned char *) label;
42 len[1] = os_strlen(label);
48 * A(0) = seed, A(i) = HMAC(secret, A(i-1))
49 * P_hash = HMAC(secret, A(1) + seed) + HMAC(secret, A(2) + seed) + ..
50 * PRF(secret, label, seed) = P_SHA256(secret, label + seed)
53 hmac_sha256_vector(secret, secret_len, 2, &addr[1], &len[1], A);
56 while (pos < outlen) {
57 hmac_sha256_vector(secret, secret_len, 3, addr, len, P);
58 hmac_sha256(secret, secret_len, A, SHA256_MAC_LEN, A);
61 if (clen > SHA256_MAC_LEN)
62 clen = SHA256_MAC_LEN;
63 os_memcpy(out + pos, P, clen);