Request missing SWID tags in a directed PA-TNC message
[strongswan.git] / src / libimcv / pts / pts_meas_algo.h
1 /*
2 * Copyright (C) 2011 Sansar Choinyambuu
3 * Copyright (C) 2011-2014 Andreas Steffen
4 * HSR Hochschule fuer Technik Rapperswil
5 *
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the
8 * Free Software Foundation; either version 2 of the License, or (at your
9 * option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
10 *
11 * This program is distributed in the hope that it will be useful, but
12 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
13 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * for more details.
15 */
16
17 /**
18 * @defgroup pts_meas_algo pts_meas_algo
19 * @{ @ingroup pts
20 */
21
22 #ifndef PTS_MEAS_ALGO_H_
23 #define PTS_MEAS_ALGO_H_
24
25 #include <library.h>
26 #include <crypto/hashers/hasher.h>
27
28 typedef enum pts_meas_algorithms_t pts_meas_algorithms_t;
29
30 /**
31 * PTS Measurement Algorithms
32 */
33 enum pts_meas_algorithms_t {
34 PTS_MEAS_ALGO_NONE = 0,
35 PTS_MEAS_ALGO_SHA384 = (1<<13),
36 PTS_MEAS_ALGO_SHA256 = (1<<14),
37 PTS_MEAS_ALGO_SHA1 = (1<<15)
38 };
39
40 /**
41 * enum name for pts_meas_algorithms_t.
42 */
43 extern enum_name_t *pts_meas_algorithm_names;
44
45 /**
46 * Diffie-Hellman Hash Algorithm Values
47 * see section 3.8.5 of PTS Protocol: Binding to TNC IF-M Specification
48 *
49 * 1
50 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
51 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
52 * |1|2|3|R|R|R|R|R|R|R|R|R|R|R|R|R|
53 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
54 *
55 */
56
57 /**
58 * Probe available PTS measurement algorithms
59 *
60 * @param algorithms set of available algorithms
61 * @return TRUE if mandatory algorithms are available
62 */
63 bool pts_meas_algo_probe(pts_meas_algorithms_t *algorithms);
64
65 /**
66 * Update supported PTS measurement algorithms according to configuration
67 *
68 * sha1 : PTS_MEAS_ALGO_SHA1
69 * sha256: PTS_MEAS_ALGO_SHA1 | PTS_MEAS_ALGO_SHA256
70 * sha384: PTS_MEAS_ALGO_SHA1 | PTS_MEAS_ALGO_SHA256 | PTS_MEAS_ALGO_SHA384
71 *
72 * The PTS-IMC is expected to select the strongest supported algorithm
73 *
74 * @param hash_alg configured hash algorithm
75 * @param algorithms returns set of available PTS measurement algorithms
76 */
77 bool pts_meas_algo_update(char *hash_alg, pts_meas_algorithms_t *algorithms);
78
79 /**
80 * Select the strongest PTS measurement algorithm
81 * among a set of offered PTS measurement algorithms
82 *
83 * @param supported_algos set of supported PTS measurement algorithms
84 * @param offered_algos set of offered PTS measurements algorithms
85 * @return selected algorithm
86 */
87 pts_meas_algorithms_t pts_meas_algo_select(pts_meas_algorithms_t supported_algos,
88 pts_meas_algorithms_t offered_algos);
89
90 /**
91 * Convert pts_meas_algorithms_t to hash_algorithm_t
92 *
93 * @param algorithm PTS measurement algorithm type
94 * @return libstrongswan hash algorithm type
95 */
96 hash_algorithm_t pts_meas_algo_to_hash(pts_meas_algorithms_t algorithm);
97
98 /**
99 * Return the hash size of a pts_meas_algorithm
100 *
101 * @param algorithm PTS measurement algorithm type
102 * @return hash size in bytes
103 */
104 size_t pts_meas_algo_hash_size(pts_meas_algorithms_t algorithm);
105
106 #endif /** PTS_MEAS_ALGO_H_ @}*/