| Wireshark 4.7.0 The Wireshark network protocol analyzer

Loading...
Searching...
No Matches
wsgcrypt.h
Go to the documentation of this file.
1
15#ifndef __WSGCRYPT_H__
16#define __WSGCRYPT_H__
17
18#include <wireshark.h>
19#include <gcrypt.h>
20
21#define HASH_MD5_LENGTH 16
22#define HASH_SHA1_LENGTH 20
23#define HASH_SHA2_224_LENGTH 28
24#define HASH_SHA2_256_LENGTH 32
25#define HASH_SHA2_384_LENGTH 48
26#define HASH_SHA2_512_LENGTH 64
27#define AEAD_AES_128_GCM_KEY_LENGTH 16
28#define AEAD_AES_256_GCM_KEY_LENGTH 32
29#define AEAD_CHACHA20POLY1305_KEY_LENGTH 32
30#define AEAD_MAX_KEY_LENGTH 32
31#define HPKE_AEAD_NONCE_LENGTH 12
32#define HPKE_HKDF_SHA256 1
33#define HPKE_HKDF_SHA384 2
34#define HPKE_HKDF_SHA512 3
35#define HPKE_AEAD_AES_128_GCM 1
36#define HPKE_AEAD_AES_256_GCM 2
37#define HPKE_AEAD_CHACHA20POLY1305 3
38#define HPKE_SUIT_ID_LEN 10
39#define HPKE_SUIT_PREFIX "HPKE"
40#define HPKE_VERSION_ID "HPKE-v1"
41#define HPKE_MAX_KDF_LEN HASH_SHA2_512_LENGTH
42#define HPKE_MODE_BASE 0
43#define HPKE_MODE_PSK 1
44#define HPKE_MODE_AUTH 2
45#define HPKE_MODE_AUTH_PSK 3
46
64WS_DLL_PUBLIC gcry_error_t ws_hmac_buffer(int algo, void *digest,
65 const void *buffer, size_t length,
66 const void *key, size_t keylen);
67
68
85WS_DLL_PUBLIC gcry_error_t ws_cmac_buffer(int algo, void *digest,
86 const void *buffer, size_t length,
87 const void *key, size_t keylen);
88
89
102WS_DLL_PUBLIC gcry_error_t crypt_des_ecb(uint8_t *output, const uint8_t *buffer, const uint8_t *key56);
103
104
120WS_DLL_PUBLIC size_t rsa_decrypt_inplace(const unsigned len, unsigned char* data,
121 gcry_sexp_t pk, bool pkcs1_padding, char **err);
122
123
139WS_DLL_PUBLIC gcry_error_t
140 hkdf_expand(int hashalgo, const uint8_t *prk, unsigned prk_len, const uint8_t *info, unsigned info_len,
141 uint8_t *out, unsigned out_len);
142
160static inline gcry_error_t
161hkdf_extract(int hashalgo, const uint8_t *salt, size_t salt_len, const uint8_t *ikm, size_t ikm_len, uint8_t *prk)
162{
163 /* PRK = HMAC-Hash(salt, IKM) where salt is key, and IKM is input. */
164 return ws_hmac_buffer(hashalgo, prk, ikm, ikm_len, salt, salt_len);
165}
166
178WS_DLL_PUBLIC uint16_t
179 hpke_hkdf_len(uint16_t kdf_id);
180
181
191WS_DLL_PUBLIC uint16_t
192 hpke_aead_key_len(uint16_t aead_id);
193
194
204WS_DLL_PUBLIC uint16_t
205 hpke_aead_nonce_len(uint16_t aead_id);
206
207
220WS_DLL_PUBLIC void
221 hpke_suite_id(uint16_t kem_id, uint16_t kdf_id, uint16_t aead_id, uint8_t *suite_id);
222
223
243WS_DLL_PUBLIC gcry_error_t
244 hpke_key_schedule(uint16_t kdf_id, uint16_t aead_id,
245 const uint8_t *salt, unsigned salt_len,
246 const uint8_t *suite_id,
247 const uint8_t *ikm, unsigned ikm_len,
248 uint8_t mode, uint8_t *key, uint8_t *base_nonce);
249
250
262WS_DLL_PUBLIC gcry_error_t
263 hpke_setup_aead(gcry_cipher_hd_t* cipher, uint16_t aead_id, uint8_t *key);
264
265
278WS_DLL_PUBLIC gcry_error_t
279 hpke_set_nonce(gcry_cipher_hd_t cipher, uint64_t seq,
280 uint8_t *base_nonce, size_t nonce_len);
281
282
283#endif /* __WSGCRYPT_H__ */
buffer
Definition mcast_stream.h:30
info
Definition file-pcapng.h:57
hpke_set_nonce
WS_DLL_PUBLIC gcry_error_t hpke_set_nonce(gcry_cipher_hd_t cipher, uint64_t seq, uint8_t *base_nonce, size_t nonce_len)
Set the nonce for an AEAD cipher using sequence number and base nonce.
Definition wsgcrypt.c:386
ws_cmac_buffer
WS_DLL_PUBLIC gcry_error_t ws_cmac_buffer(int algo, void *digest, const void *buffer, size_t length, const void *key, size_t keylen)
Compute CMAC over a buffer using the specified algorithm.
Definition wsgcrypt.c:33
hpke_aead_key_len
WS_DLL_PUBLIC uint16_t hpke_aead_key_len(uint16_t aead_id)
Return the key length for a given AEAD algorithm identifier.
Definition wsgcrypt.c:263
hkdf_expand
WS_DLL_PUBLIC gcry_error_t hkdf_expand(int hashalgo, const uint8_t *prk, unsigned prk_len, const uint8_t *info, unsigned info_len, uint8_t *out, unsigned out_len)
Perform HKDF-Expand as defined in RFC 5869.
Definition wsgcrypt.c:169
hpke_aead_nonce_len
WS_DLL_PUBLIC uint16_t hpke_aead_nonce_len(uint16_t aead_id)
Return the nonce length for a given AEAD algorithm identifier.
Definition wsgcrypt.c:278
hpke_setup_aead
WS_DLL_PUBLIC gcry_error_t hpke_setup_aead(gcry_cipher_hd_t *cipher, uint16_t aead_id, uint8_t *key)
Initialize AEAD cipher context for HPKE.
Definition wsgcrypt.c:364
crypt_des_ecb
WS_DLL_PUBLIC gcry_error_t crypt_des_ecb(uint8_t *output, const uint8_t *buffer, const uint8_t *key56)
Encrypt 8 bytes using DES in ECB mode.
Definition wsgcrypt.c:52
rsa_decrypt_inplace
WS_DLL_PUBLIC size_t rsa_decrypt_inplace(const unsigned len, unsigned char *data, gcry_sexp_t pk, bool pkcs1_padding, char **err)
Perform RSA decryption in-place.
Definition wsgcrypt.c:82
ws_hmac_buffer
WS_DLL_PUBLIC gcry_error_t ws_hmac_buffer(int algo, void *digest, const void *buffer, size_t length, const void *key, size_t keylen)
Compute HMAC over a buffer using the specified algorithm.
Definition wsgcrypt.c:15
hpke_key_schedule
WS_DLL_PUBLIC gcry_error_t hpke_key_schedule(uint16_t kdf_id, uint16_t aead_id, const uint8_t *salt, unsigned salt_len, const uint8_t *suite_id, const uint8_t *ikm, unsigned ikm_len, uint8_t mode, uint8_t *key, uint8_t *base_nonce)
Derive HPKE key and base nonce using the key schedule.
Definition wsgcrypt.c:336
hpke_hkdf_len
WS_DLL_PUBLIC uint16_t hpke_hkdf_len(uint16_t kdf_id)
Return the output length of the HKDF for a given KDF identifier.
Definition wsgcrypt.c:248
hpke_suite_id
WS_DLL_PUBLIC void hpke_suite_id(uint16_t kem_id, uint16_t kdf_id, uint16_t aead_id, uint8_t *suite_id)
Construct the HPKE suite identifier.
Definition wsgcrypt.c:291