DeterministicESPAsyncWebServer v6.27.1
Zero-allocation, bounded-execution async HTTP server for ESP32
Loading...
Searching...
No Matches
ssh_sha512.cpp
Go to the documentation of this file.
1// Copyright (C) 2026 Douglas Quigg (dstroy0) <dquigg123@gmail.com>
2// SPDX-License-Identifier: AGPL-3.0-or-later
3
4/**
5 * @file ssh_sha512.cpp
6 * @brief SHA-512 implementation (FIPS 180-4).
7 *
8 * On Arduino builds streaming + one-shot delegate to mbedtls; on native builds the
9 * software path below is used. Backs Ed25519 (RFC 8032), which hashes with SHA-512.
10 */
11
13#include <string.h>
14
15#ifdef ARDUINO
16
17// ---------------------------------------------------------------------------
18// Arduino (ESP32): streaming + one-shot via mbedtls.
19// ---------------------------------------------------------------------------
20
21#include <mbedtls/sha512.h>
22
24{
25 mbedtls_sha512_init(&ctx->mbed);
26#if MBEDTLS_VERSION_MAJOR >= 3
27 mbedtls_sha512_starts(&ctx->mbed, 0 /* 0 = SHA-512 */);
28#else
29 mbedtls_sha512_starts_ret(&ctx->mbed, 0);
30#endif
31}
32
33void ssh_sha512_update(SshSha512Ctx *ctx, const uint8_t *data, size_t len)
34{
35#if MBEDTLS_VERSION_MAJOR >= 3
36 mbedtls_sha512_update(&ctx->mbed, data, len);
37#else
38 mbedtls_sha512_update_ret(&ctx->mbed, data, len);
39#endif
40}
41
43{
44#if MBEDTLS_VERSION_MAJOR >= 3
45 mbedtls_sha512_finish(&ctx->mbed, digest);
46#else
47 mbedtls_sha512_finish_ret(&ctx->mbed, digest);
48#endif
49 mbedtls_sha512_free(&ctx->mbed);
50}
51
52void ssh_sha512(const uint8_t *data, size_t len, uint8_t digest[SSH_SHA512_DIGEST_LEN])
53{
54 (void)mbedtls_sha512(data, len, digest, 0 /* 0 = SHA-512, 1 = SHA-384 */);
55}
56
57#else // native software path
58
59// ---------------------------------------------------------------------------
60// Software SHA-512 (FIPS 180-4) - native/test builds only
61// ---------------------------------------------------------------------------
62
63static const uint64_t K512[80] = {
64 0x428a2f98d728ae22ULL, 0x7137449123ef65cdULL, 0xb5c0fbcfec4d3b2fULL, 0xe9b5dba58189dbbcULL, 0x3956c25bf348b538ULL,
65 0x59f111f1b605d019ULL, 0x923f82a4af194f9bULL, 0xab1c5ed5da6d8118ULL, 0xd807aa98a3030242ULL, 0x12835b0145706fbeULL,
66 0x243185be4ee4b28cULL, 0x550c7dc3d5ffb4e2ULL, 0x72be5d74f27b896fULL, 0x80deb1fe3b1696b1ULL, 0x9bdc06a725c71235ULL,
67 0xc19bf174cf692694ULL, 0xe49b69c19ef14ad2ULL, 0xefbe4786384f25e3ULL, 0x0fc19dc68b8cd5b5ULL, 0x240ca1cc77ac9c65ULL,
68 0x2de92c6f592b0275ULL, 0x4a7484aa6ea6e483ULL, 0x5cb0a9dcbd41fbd4ULL, 0x76f988da831153b5ULL, 0x983e5152ee66dfabULL,
69 0xa831c66d2db43210ULL, 0xb00327c898fb213fULL, 0xbf597fc7beef0ee4ULL, 0xc6e00bf33da88fc2ULL, 0xd5a79147930aa725ULL,
70 0x06ca6351e003826fULL, 0x142929670a0e6e70ULL, 0x27b70a8546d22ffcULL, 0x2e1b21385c26c926ULL, 0x4d2c6dfc5ac42aedULL,
71 0x53380d139d95b3dfULL, 0x650a73548baf63deULL, 0x766a0abb3c77b2a8ULL, 0x81c2c92e47edaee6ULL, 0x92722c851482353bULL,
72 0xa2bfe8a14cf10364ULL, 0xa81a664bbc423001ULL, 0xc24b8b70d0f89791ULL, 0xc76c51a30654be30ULL, 0xd192e819d6ef5218ULL,
73 0xd69906245565a910ULL, 0xf40e35855771202aULL, 0x106aa07032bbd1b8ULL, 0x19a4c116b8d2d0c8ULL, 0x1e376c085141ab53ULL,
74 0x2748774cdf8eeb99ULL, 0x34b0bcb5e19b48a8ULL, 0x391c0cb3c5c95a63ULL, 0x4ed8aa4ae3418acbULL, 0x5b9cca4f7763e373ULL,
75 0x682e6ff3d6b2b8a3ULL, 0x748f82ee5defb2fcULL, 0x78a5636f43172f60ULL, 0x84c87814a1f0ab72ULL, 0x8cc702081a6439ecULL,
76 0x90befffa23631e28ULL, 0xa4506cebde82bde9ULL, 0xbef9a3f7b2c67915ULL, 0xc67178f2e372532bULL, 0xca273eceea26619cULL,
77 0xd186b8c721c0c207ULL, 0xeada7dd6cde0eb1eULL, 0xf57d4f7fee6ed178ULL, 0x06f067aa72176fbaULL, 0x0a637dc5a2c898a6ULL,
78 0x113f9804bef90daeULL, 0x1b710b35131c471bULL, 0x28db77f523047d84ULL, 0x32caab7b40c72493ULL, 0x3c9ebe0a15c9bebcULL,
79 0x431d67c49c100d4cULL, 0x4cc5d4becb3e42b6ULL, 0x597f299cfc657e2aULL, 0x5fcb6fab3ad6faecULL, 0x6c44198c4a475817ULL,
80};
81
82static const uint64_t H0[8] = {
83 0x6a09e667f3bcc908ULL, 0xbb67ae8584caa73bULL, 0x3c6ef372fe94f82bULL, 0xa54ff53a5f1d36f1ULL,
84 0x510e527fade682d1ULL, 0x9b05688c2b3e6c1fULL, 0x1f83d9abfb41bd6bULL, 0x5be0cd19137e2179ULL,
85};
86
87static inline uint64_t rotr64(uint64_t x, unsigned n)
88{
89 return (x >> n) | (x << (64 - n));
90}
91
92static inline uint64_t load_be64(const uint8_t *p)
93{
94 return ((uint64_t)p[0] << 56) | ((uint64_t)p[1] << 48) | ((uint64_t)p[2] << 40) | ((uint64_t)p[3] << 32) |
95 ((uint64_t)p[4] << 24) | ((uint64_t)p[5] << 16) | ((uint64_t)p[6] << 8) | (uint64_t)p[7];
96}
97
98static inline void store_be64(uint8_t *p, uint64_t v)
99{
100 p[0] = (uint8_t)(v >> 56);
101 p[1] = (uint8_t)(v >> 48);
102 p[2] = (uint8_t)(v >> 40);
103 p[3] = (uint8_t)(v >> 32);
104 p[4] = (uint8_t)(v >> 24);
105 p[5] = (uint8_t)(v >> 16);
106 p[6] = (uint8_t)(v >> 8);
107 p[7] = (uint8_t)(v);
108}
109
110// Compress one 128-byte block into the running state h[0..7] (FIPS 180-4 §6.4.2).
111static void sha512_block(uint64_t h[8], const uint8_t blk[128])
112{
113 uint64_t W[80];
114 for (int i = 0; i < 16; i++)
115 W[i] = load_be64(blk + i * 8);
116 for (int i = 16; i < 80; i++)
117 {
118 uint64_t s0 = rotr64(W[i - 15], 1) ^ rotr64(W[i - 15], 8) ^ (W[i - 15] >> 7); // σ0
119 uint64_t s1 = rotr64(W[i - 2], 19) ^ rotr64(W[i - 2], 61) ^ (W[i - 2] >> 6); // σ1
120 W[i] = W[i - 16] + s0 + W[i - 7] + s1;
121 }
122
123 uint64_t a = h[0];
124 uint64_t b = h[1];
125 uint64_t c = h[2];
126 uint64_t d = h[3];
127 uint64_t e = h[4];
128 uint64_t f = h[5];
129 uint64_t g = h[6];
130 uint64_t hh = h[7];
131
132 for (int i = 0; i < 80; i++)
133 {
134 uint64_t S1 = rotr64(e, 14) ^ rotr64(e, 18) ^ rotr64(e, 41); // Σ1
135 uint64_t ch = (e & f) ^ (~e & g); // Ch(e,f,g)
136 uint64_t t1 = hh + S1 + ch + K512[i] + W[i]; // T1
137 uint64_t S0 = rotr64(a, 28) ^ rotr64(a, 34) ^ rotr64(a, 39); // Σ0
138 uint64_t maj = (a & b) ^ (a & c) ^ (b & c); // Maj(a,b,c)
139 uint64_t t2 = S0 + maj; // T2
140 hh = g;
141 g = f;
142 f = e;
143 e = d + t1;
144 d = c;
145 c = b;
146 b = a;
147 a = t1 + t2;
148 }
149
150 h[0] += a;
151 h[1] += b;
152 h[2] += c;
153 h[3] += d;
154 h[4] += e;
155 h[5] += f;
156 h[6] += g;
157 h[7] += hh;
158}
159
161{
162 for (int i = 0; i < 8; i++)
163 ctx->s[i] = H0[i];
164 ctx->n = 0;
165 ctx->buflen = 0;
166 memset(ctx->buf, 0, sizeof(ctx->buf));
167}
168
169void ssh_sha512_update(SshSha512Ctx *ctx, const uint8_t *data, size_t len)
170{
171 ctx->n += len;
172 while (len > 0)
173 {
174 uint32_t space = 128 - ctx->buflen;
175 uint32_t take = (uint32_t)len < space ? (uint32_t)len : space;
176 memcpy(ctx->buf + ctx->buflen, data, take);
177 ctx->buflen += take;
178 data += take;
179 len -= take;
180 if (ctx->buflen == 128)
181 {
182 sha512_block(ctx->s, ctx->buf);
183 ctx->buflen = 0;
184 }
185 }
186}
187
188void ssh_sha512_final(SshSha512Ctx *ctx, uint8_t digest[SSH_SHA512_DIGEST_LEN])
189{
190 // 128-bit length in bits. Our byte count fits a uint64, so the high word is
191 // n >> 61 (bits above 64) and the low word is n << 3.
192 uint64_t len_hi = ctx->n >> 61;
193 uint64_t len_lo = ctx->n << 3;
194
195 ctx->buf[ctx->buflen++] = 0x80;
196
197 if (ctx->buflen > 112)
198 {
199 while (ctx->buflen < 128)
200 ctx->buf[ctx->buflen++] = 0x00;
201 sha512_block(ctx->s, ctx->buf);
202 ctx->buflen = 0;
203 }
204 while (ctx->buflen < 112)
205 ctx->buf[ctx->buflen++] = 0x00;
206
207 store_be64(ctx->buf + 112, len_hi);
208 store_be64(ctx->buf + 120, len_lo);
209 sha512_block(ctx->s, ctx->buf);
210
211 for (int i = 0; i < 8; i++)
212 store_be64(digest + i * 8, ctx->s[i]);
213}
214
215void ssh_sha512(const uint8_t *data, size_t len, uint8_t digest[SSH_SHA512_DIGEST_LEN])
216{
217 SshSha512Ctx ctx;
218 ssh_sha512_init(&ctx);
219 ssh_sha512_update(&ctx, data, len);
220 ssh_sha512_final(&ctx, digest);
221}
222
223#endif // !ARDUINO (native software path)
void ssh_sha512_final(SshSha512Ctx *ctx, uint8_t digest[SSH_SHA512_DIGEST_LEN])
Finalize the hash and write the 64-byte digest. The context is undefined afterwards; call init() agai...
void ssh_sha512_init(SshSha512Ctx *ctx)
Initialize a streaming SHA-512 context (ctx must not be NULL).
void ssh_sha512(const uint8_t *data, size_t len, uint8_t digest[SSH_SHA512_DIGEST_LEN])
One-shot SHA-512: hash len bytes of data into digest (64 bytes).
void ssh_sha512_update(SshSha512Ctx *ctx, const uint8_t *data, size_t len)
Feed len bytes of data into the running hash.
SHA-512 (FIPS 180-4) - streaming context and one-shot API.
#define SSH_SHA512_DIGEST_LEN
SHA-512 digest length in bytes.
Definition ssh_sha512.h:24
Streaming SHA-512 context.
Definition ssh_sha512.h:33
mbedtls_sha512_context mbed
mbedtls SHA-512 state (ESP32).
Definition ssh_sha512.h:34