ASCON Suite
ascon-trng-windows.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2022 Southern Storm Software, Pty Ltd.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included
12  * in all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20  * DEALINGS IN THE SOFTWARE.
21  */
22 
23 #include "ascon-trng.h"
25 #include <string.h>
26 
27 #if defined(ASCON_TRNG_WINDOWS)
28 
29 #include <windows.h>
30 #include <wincrypt.h>
31 
32 /* Microsoft documentation recommends using RtlGenRandom() rather
33  * than CryptGenRandom() as it is more efficient than creating a
34  * cryptography service provider. But it is harder to access as
35  * there is no import library. Fix this later to dynamically load
36  * "Advapi32.dll" and resolve the entry point for RtlGenRandom(). */
37 
38 int ascon_trng_generate(unsigned char *out, size_t outlen)
39 {
40  HCRYPTPROV provider = 0;
41  int ok = 0;
42  if (CryptAcquireContextW
43  (&provider, 0, 0, PROV_RSA_FULL,
44  CRYPT_VERIFYCONTEXT | CRYPT_SILENT)) {
45  if (CryptGenRandom(provider, outlen, out))
46  ok = 1;
47  CryptReleaseContext(provider, 0);
48  }
49  if (!ok) {
50  /* Could not open the provider or it didn't work; this is a problem! */
51  memset(out, 0, outlen);
52  }
53  return ok;
54 }
55 
56 #endif /* ASCON_TRNG_WINDOWS */
int ascon_trng_generate(unsigned char *out, size_t outlen)
Generates a buffer of bytes from the system TRNG source.
Access to the system's random number source.