More Doxygen documentation.
[BearSSL] / src / ssl / ssl_single_rsa.c
1 /*
2 * Copyright (c) 2016 Thomas Pornin <pornin@bolet.org>
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining
5 * a copy of this software and associated documentation files (the
6 * "Software"), to deal in the Software without restriction, including
7 * without limitation the rights to use, copy, modify, merge, publish,
8 * distribute, sublicense, and/or sell copies of the Software, and to
9 * permit persons to whom the Software is furnished to do so, subject to
10 * the following conditions:
11 *
12 * The above copyright notice and this permission notice shall be
13 * included in all copies or substantial portions of the Software.
14 *
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
19 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
20 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
21 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 * SOFTWARE.
23 */
24
25 #include "inner.h"
26
27 static int
28 sr_choose(const br_ssl_server_policy_class **pctx,
29 const br_ssl_server_context *cc,
30 br_ssl_server_choices *choices)
31 {
32 br_ssl_server_policy_rsa_context *pc;
33 const br_suite_translated *st;
34 size_t u, st_num;
35 int hash_id;
36
37 pc = (br_ssl_server_policy_rsa_context *)pctx;
38 st = br_ssl_server_get_client_suites(cc, &st_num);
39 hash_id = br_ssl_choose_hash(br_ssl_server_get_client_hashes(cc));
40 choices->chain = pc->chain;
41 choices->chain_len = pc->chain_len;
42 for (u = 0; u < st_num; u ++) {
43 unsigned tt;
44
45 tt = st[u][1];
46 switch (tt >> 12) {
47 case BR_SSLKEYX_RSA:
48 if ((pc->allowed_usages & BR_KEYTYPE_KEYX) != 0) {
49 choices->cipher_suite = st[u][0];
50 return 1;
51 }
52 break;
53 case BR_SSLKEYX_ECDHE_RSA:
54 if ((pc->allowed_usages & BR_KEYTYPE_SIGN) != 0
55 && hash_id != 0)
56 {
57 choices->cipher_suite = st[u][0];
58 choices->hash_id = hash_id;
59 return 1;
60 }
61 break;
62 }
63 }
64 return 0;
65 }
66
67 static uint32_t
68 sr_do_keyx(const br_ssl_server_policy_class **pctx,
69 unsigned char *data, size_t len)
70 {
71 br_ssl_server_policy_rsa_context *pc;
72
73 pc = (br_ssl_server_policy_rsa_context *)pctx;
74 return br_rsa_ssl_decrypt(pc->irsacore, pc->sk, data, len);
75 }
76
77 /*
78 * OID for hash functions in RSA signatures.
79 */
80 static const unsigned char HASH_OID_SHA1[] = {
81 0x05, 0x2B, 0x0E, 0x03, 0x02, 0x1A
82 };
83
84 static const unsigned char HASH_OID_SHA224[] = {
85 0x09, 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x04
86 };
87
88 static const unsigned char HASH_OID_SHA256[] = {
89 0x09, 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x01
90 };
91
92 static const unsigned char HASH_OID_SHA384[] = {
93 0x09, 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x02
94 };
95
96 static const unsigned char HASH_OID_SHA512[] = {
97 0x09, 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, 0x03
98 };
99
100 static const unsigned char *HASH_OID[] = {
101 HASH_OID_SHA1,
102 HASH_OID_SHA224,
103 HASH_OID_SHA256,
104 HASH_OID_SHA384,
105 HASH_OID_SHA512
106 };
107
108 static size_t
109 sr_do_sign(const br_ssl_server_policy_class **pctx,
110 int hash_id, size_t hv_len, unsigned char *data, size_t len)
111 {
112 br_ssl_server_policy_rsa_context *pc;
113 unsigned char hv[64];
114 size_t sig_len;
115 const unsigned char *hash_oid;
116
117 pc = (br_ssl_server_policy_rsa_context *)pctx;
118 memcpy(hv, data, hv_len);
119 if (hash_id == 0) {
120 hash_oid = NULL;
121 } else if (hash_id >= 2 && hash_id <= 6) {
122 hash_oid = HASH_OID[hash_id - 2];
123 } else {
124 return 0;
125 }
126 sig_len = (pc->sk->n_bitlen + 7) >> 3;
127 if (len < sig_len) {
128 return 0;
129 }
130 return pc->irsasign(hash_oid, hv, hv_len, pc->sk, data) ? sig_len : 0;
131 }
132
133 static const br_ssl_server_policy_class sr_policy_vtable = {
134 sizeof(br_ssl_server_policy_rsa_context),
135 sr_choose,
136 sr_do_keyx,
137 sr_do_sign
138 };
139
140 /* see bearssl_ssl.h */
141 void
142 br_ssl_server_set_single_rsa(br_ssl_server_context *cc,
143 const br_x509_certificate *chain, size_t chain_len,
144 const br_rsa_private_key *sk, unsigned allowed_usages,
145 br_rsa_private irsacore, br_rsa_pkcs1_sign irsasign)
146 {
147 cc->chain_handler.single_rsa.vtable = &sr_policy_vtable;
148 cc->chain_handler.single_rsa.chain = chain;
149 cc->chain_handler.single_rsa.chain_len = chain_len;
150 cc->chain_handler.single_rsa.sk = sk;
151 cc->chain_handler.single_rsa.allowed_usages = allowed_usages;
152 cc->chain_handler.single_rsa.irsacore = irsacore;
153 cc->chain_handler.single_rsa.irsasign = irsasign;
154 cc->policy_vtable = &cc->chain_handler.single_rsa.vtable;
155 }