blob: b04e48e23dfcb6c1322116542c7b84a75f74d5a6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
/* packet-cose.h
* Definitions for CBOR Object Signing and Encryption (COSE) dissection
* References:
* RFC 8152: https://tools.ietf.org/html/rfc8152
*
* Copyright 2019-2021, Brian Sipos <brian.sipos@gmail.com>
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* SPDX-License-Identifier: LGPL-2.1-or-later
*/
#ifndef __PACKET_COSE_H__
#define __PACKET_COSE_H__
#include <glib.h>
/**
* COSE message dissectors are registered multiple ways:
* 1. The unit-keyed dissector table "cose.msgtag" with keys being
* IANA-registered CBOR tag values (e.g., 18 is COSE_Sign1).
* 2. The string-keyed dissector table "media_type" with keys being
* IANA-registered media type IDs
* (e.g., application/cose; cose-type="cose-sign1" is COSE_Sign1).
* 3. The registered dissectors for names "cose" and message names in
* all-lowercase form (e.g., "cose_sign1").
* There is currently no CoAP dissector table to register with.
*
* COSE message dissectors use the tag (wscbor_tag_t *) value, if used to
* discriminate the message type, as the user data pointer.
*
* COSE header label dissectors are registered with the dissector table
* "cose.header" and key parameter dissectors with the table "cose.keyparam"
* both with cose_param_key_t* keys.
* The header/parameter dissectors use a cose_header_context_t* as the user
* data pointer.
*
* An additional dissector "cose.msg.headers" will dissect an individual
* header map structure outside of a COSE message.
*/
// A header parameter or key-type parameter key
typedef struct {
/// The Algorithm or Key Type context or NULL for
/// all-context keys.
GVariant *principal;
/// Label simple value (int or tstr) as variant.
/// Object owned by this struct.
GVariant *label;
} cose_param_key_t;
/** Compatible with GHashFunc signature.
*/
guint cose_param_key_hash(gconstpointer ptr);
/** Compatible with GEqualFunc signature.
*/
gboolean cose_param_key_equal(gconstpointer a, gconstpointer b);
/** Compatible with GDestroyNotify signature.
*/
void cose_param_key_free(gpointer ptr);
/// User data for header/key-parameter dissectors
typedef struct {
/// Principal value (alg or kty) of the map, if defined.
GVariant *principal;
/// Current label being processed
GVariant *label;
} cose_header_context_t;
#endif /* __PACKET_COSE_H__ */
|
