xref: /openbmc/linux/net/sctp/auth.c (revision d2c43ff1)
1 /* SCTP kernel implementation
2  * (C) Copyright 2007 Hewlett-Packard Development Company, L.P.
3  *
4  * This file is part of the SCTP kernel implementation
5  *
6  * This SCTP implementation is free software;
7  * you can redistribute it and/or modify it under the terms of
8  * the GNU General Public License as published by
9  * the Free Software Foundation; either version 2, or (at your option)
10  * any later version.
11  *
12  * This SCTP implementation is distributed in the hope that it
13  * will be useful, but WITHOUT ANY WARRANTY; without even the implied
14  *                 ************************
15  * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
16  * See the GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with GNU CC; see the file COPYING.  If not, see
20  * <http://www.gnu.org/licenses/>.
21  *
22  * Please send any bug reports or fixes you make to the
23  * email address(es):
24  *    lksctp developers <linux-sctp@vger.kernel.org>
25  *
26  * Written or modified by:
27  *   Vlad Yasevich     <vladislav.yasevich@hp.com>
28  */
29 
30 #include <crypto/hash.h>
31 #include <linux/slab.h>
32 #include <linux/types.h>
33 #include <linux/scatterlist.h>
34 #include <net/sctp/sctp.h>
35 #include <net/sctp/auth.h>
36 
37 static struct sctp_hmac sctp_hmac_list[SCTP_AUTH_NUM_HMACS] = {
38 	{
39 		/* id 0 is reserved.  as all 0 */
40 		.hmac_id = SCTP_AUTH_HMAC_ID_RESERVED_0,
41 	},
42 	{
43 		.hmac_id = SCTP_AUTH_HMAC_ID_SHA1,
44 		.hmac_name = "hmac(sha1)",
45 		.hmac_len = SCTP_SHA1_SIG_SIZE,
46 	},
47 	{
48 		/* id 2 is reserved as well */
49 		.hmac_id = SCTP_AUTH_HMAC_ID_RESERVED_2,
50 	},
51 #if IS_ENABLED(CONFIG_CRYPTO_SHA256)
52 	{
53 		.hmac_id = SCTP_AUTH_HMAC_ID_SHA256,
54 		.hmac_name = "hmac(sha256)",
55 		.hmac_len = SCTP_SHA256_SIG_SIZE,
56 	}
57 #endif
58 };
59 
60 
61 void sctp_auth_key_put(struct sctp_auth_bytes *key)
62 {
63 	if (!key)
64 		return;
65 
66 	if (refcount_dec_and_test(&key->refcnt)) {
67 		kzfree(key);
68 		SCTP_DBG_OBJCNT_DEC(keys);
69 	}
70 }
71 
72 /* Create a new key structure of a given length */
73 static struct sctp_auth_bytes *sctp_auth_create_key(__u32 key_len, gfp_t gfp)
74 {
75 	struct sctp_auth_bytes *key;
76 
77 	/* Verify that we are not going to overflow INT_MAX */
78 	if (key_len > (INT_MAX - sizeof(struct sctp_auth_bytes)))
79 		return NULL;
80 
81 	/* Allocate the shared key */
82 	key = kmalloc(sizeof(struct sctp_auth_bytes) + key_len, gfp);
83 	if (!key)
84 		return NULL;
85 
86 	key->len = key_len;
87 	refcount_set(&key->refcnt, 1);
88 	SCTP_DBG_OBJCNT_INC(keys);
89 
90 	return key;
91 }
92 
93 /* Create a new shared key container with a give key id */
94 struct sctp_shared_key *sctp_auth_shkey_create(__u16 key_id, gfp_t gfp)
95 {
96 	struct sctp_shared_key *new;
97 
98 	/* Allocate the shared key container */
99 	new = kzalloc(sizeof(struct sctp_shared_key), gfp);
100 	if (!new)
101 		return NULL;
102 
103 	INIT_LIST_HEAD(&new->key_list);
104 	new->key_id = key_id;
105 
106 	return new;
107 }
108 
109 /* Free the shared key structure */
110 static void sctp_auth_shkey_free(struct sctp_shared_key *sh_key)
111 {
112 	BUG_ON(!list_empty(&sh_key->key_list));
113 	sctp_auth_key_put(sh_key->key);
114 	sh_key->key = NULL;
115 	kfree(sh_key);
116 }
117 
118 /* Destroy the entire key list.  This is done during the
119  * associon and endpoint free process.
120  */
121 void sctp_auth_destroy_keys(struct list_head *keys)
122 {
123 	struct sctp_shared_key *ep_key;
124 	struct sctp_shared_key *tmp;
125 
126 	if (list_empty(keys))
127 		return;
128 
129 	key_for_each_safe(ep_key, tmp, keys) {
130 		list_del_init(&ep_key->key_list);
131 		sctp_auth_shkey_free(ep_key);
132 	}
133 }
134 
135 /* Compare two byte vectors as numbers.  Return values
136  * are:
137  * 	  0 - vectors are equal
138  * 	< 0 - vector 1 is smaller than vector2
139  * 	> 0 - vector 1 is greater than vector2
140  *
141  * Algorithm is:
142  * 	This is performed by selecting the numerically smaller key vector...
143  *	If the key vectors are equal as numbers but differ in length ...
144  *	the shorter vector is considered smaller
145  *
146  * Examples (with small values):
147  * 	000123456789 > 123456789 (first number is longer)
148  * 	000123456789 < 234567891 (second number is larger numerically)
149  * 	123456789 > 2345678 	 (first number is both larger & longer)
150  */
151 static int sctp_auth_compare_vectors(struct sctp_auth_bytes *vector1,
152 			      struct sctp_auth_bytes *vector2)
153 {
154 	int diff;
155 	int i;
156 	const __u8 *longer;
157 
158 	diff = vector1->len - vector2->len;
159 	if (diff) {
160 		longer = (diff > 0) ? vector1->data : vector2->data;
161 
162 		/* Check to see if the longer number is
163 		 * lead-zero padded.  If it is not, it
164 		 * is automatically larger numerically.
165 		 */
166 		for (i = 0; i < abs(diff); i++) {
167 			if (longer[i] != 0)
168 				return diff;
169 		}
170 	}
171 
172 	/* lengths are the same, compare numbers */
173 	return memcmp(vector1->data, vector2->data, vector1->len);
174 }
175 
176 /*
177  * Create a key vector as described in SCTP-AUTH, Section 6.1
178  *    The RANDOM parameter, the CHUNKS parameter and the HMAC-ALGO
179  *    parameter sent by each endpoint are concatenated as byte vectors.
180  *    These parameters include the parameter type, parameter length, and
181  *    the parameter value, but padding is omitted; all padding MUST be
182  *    removed from this concatenation before proceeding with further
183  *    computation of keys.  Parameters which were not sent are simply
184  *    omitted from the concatenation process.  The resulting two vectors
185  *    are called the two key vectors.
186  */
187 static struct sctp_auth_bytes *sctp_auth_make_key_vector(
188 			sctp_random_param_t *random,
189 			sctp_chunks_param_t *chunks,
190 			sctp_hmac_algo_param_t *hmacs,
191 			gfp_t gfp)
192 {
193 	struct sctp_auth_bytes *new;
194 	__u32	len;
195 	__u32	offset = 0;
196 	__u16	random_len, hmacs_len, chunks_len = 0;
197 
198 	random_len = ntohs(random->param_hdr.length);
199 	hmacs_len = ntohs(hmacs->param_hdr.length);
200 	if (chunks)
201 		chunks_len = ntohs(chunks->param_hdr.length);
202 
203 	len = random_len + hmacs_len + chunks_len;
204 
205 	new = sctp_auth_create_key(len, gfp);
206 	if (!new)
207 		return NULL;
208 
209 	memcpy(new->data, random, random_len);
210 	offset += random_len;
211 
212 	if (chunks) {
213 		memcpy(new->data + offset, chunks, chunks_len);
214 		offset += chunks_len;
215 	}
216 
217 	memcpy(new->data + offset, hmacs, hmacs_len);
218 
219 	return new;
220 }
221 
222 
223 /* Make a key vector based on our local parameters */
224 static struct sctp_auth_bytes *sctp_auth_make_local_vector(
225 				    const struct sctp_association *asoc,
226 				    gfp_t gfp)
227 {
228 	return sctp_auth_make_key_vector(
229 				    (sctp_random_param_t *)asoc->c.auth_random,
230 				    (sctp_chunks_param_t *)asoc->c.auth_chunks,
231 				    (sctp_hmac_algo_param_t *)asoc->c.auth_hmacs,
232 				    gfp);
233 }
234 
235 /* Make a key vector based on peer's parameters */
236 static struct sctp_auth_bytes *sctp_auth_make_peer_vector(
237 				    const struct sctp_association *asoc,
238 				    gfp_t gfp)
239 {
240 	return sctp_auth_make_key_vector(asoc->peer.peer_random,
241 					 asoc->peer.peer_chunks,
242 					 asoc->peer.peer_hmacs,
243 					 gfp);
244 }
245 
246 
247 /* Set the value of the association shared key base on the parameters
248  * given.  The algorithm is:
249  *    From the endpoint pair shared keys and the key vectors the
250  *    association shared keys are computed.  This is performed by selecting
251  *    the numerically smaller key vector and concatenating it to the
252  *    endpoint pair shared key, and then concatenating the numerically
253  *    larger key vector to that.  The result of the concatenation is the
254  *    association shared key.
255  */
256 static struct sctp_auth_bytes *sctp_auth_asoc_set_secret(
257 			struct sctp_shared_key *ep_key,
258 			struct sctp_auth_bytes *first_vector,
259 			struct sctp_auth_bytes *last_vector,
260 			gfp_t gfp)
261 {
262 	struct sctp_auth_bytes *secret;
263 	__u32 offset = 0;
264 	__u32 auth_len;
265 
266 	auth_len = first_vector->len + last_vector->len;
267 	if (ep_key->key)
268 		auth_len += ep_key->key->len;
269 
270 	secret = sctp_auth_create_key(auth_len, gfp);
271 	if (!secret)
272 		return NULL;
273 
274 	if (ep_key->key) {
275 		memcpy(secret->data, ep_key->key->data, ep_key->key->len);
276 		offset += ep_key->key->len;
277 	}
278 
279 	memcpy(secret->data + offset, first_vector->data, first_vector->len);
280 	offset += first_vector->len;
281 
282 	memcpy(secret->data + offset, last_vector->data, last_vector->len);
283 
284 	return secret;
285 }
286 
287 /* Create an association shared key.  Follow the algorithm
288  * described in SCTP-AUTH, Section 6.1
289  */
290 static struct sctp_auth_bytes *sctp_auth_asoc_create_secret(
291 				 const struct sctp_association *asoc,
292 				 struct sctp_shared_key *ep_key,
293 				 gfp_t gfp)
294 {
295 	struct sctp_auth_bytes *local_key_vector;
296 	struct sctp_auth_bytes *peer_key_vector;
297 	struct sctp_auth_bytes	*first_vector,
298 				*last_vector;
299 	struct sctp_auth_bytes	*secret = NULL;
300 	int	cmp;
301 
302 
303 	/* Now we need to build the key vectors
304 	 * SCTP-AUTH , Section 6.1
305 	 *    The RANDOM parameter, the CHUNKS parameter and the HMAC-ALGO
306 	 *    parameter sent by each endpoint are concatenated as byte vectors.
307 	 *    These parameters include the parameter type, parameter length, and
308 	 *    the parameter value, but padding is omitted; all padding MUST be
309 	 *    removed from this concatenation before proceeding with further
310 	 *    computation of keys.  Parameters which were not sent are simply
311 	 *    omitted from the concatenation process.  The resulting two vectors
312 	 *    are called the two key vectors.
313 	 */
314 
315 	local_key_vector = sctp_auth_make_local_vector(asoc, gfp);
316 	peer_key_vector = sctp_auth_make_peer_vector(asoc, gfp);
317 
318 	if (!peer_key_vector || !local_key_vector)
319 		goto out;
320 
321 	/* Figure out the order in which the key_vectors will be
322 	 * added to the endpoint shared key.
323 	 * SCTP-AUTH, Section 6.1:
324 	 *   This is performed by selecting the numerically smaller key
325 	 *   vector and concatenating it to the endpoint pair shared
326 	 *   key, and then concatenating the numerically larger key
327 	 *   vector to that.  If the key vectors are equal as numbers
328 	 *   but differ in length, then the concatenation order is the
329 	 *   endpoint shared key, followed by the shorter key vector,
330 	 *   followed by the longer key vector.  Otherwise, the key
331 	 *   vectors are identical, and may be concatenated to the
332 	 *   endpoint pair key in any order.
333 	 */
334 	cmp = sctp_auth_compare_vectors(local_key_vector,
335 					peer_key_vector);
336 	if (cmp < 0) {
337 		first_vector = local_key_vector;
338 		last_vector = peer_key_vector;
339 	} else {
340 		first_vector = peer_key_vector;
341 		last_vector = local_key_vector;
342 	}
343 
344 	secret = sctp_auth_asoc_set_secret(ep_key, first_vector, last_vector,
345 					    gfp);
346 out:
347 	sctp_auth_key_put(local_key_vector);
348 	sctp_auth_key_put(peer_key_vector);
349 
350 	return secret;
351 }
352 
353 /*
354  * Populate the association overlay list with the list
355  * from the endpoint.
356  */
357 int sctp_auth_asoc_copy_shkeys(const struct sctp_endpoint *ep,
358 				struct sctp_association *asoc,
359 				gfp_t gfp)
360 {
361 	struct sctp_shared_key *sh_key;
362 	struct sctp_shared_key *new;
363 
364 	BUG_ON(!list_empty(&asoc->endpoint_shared_keys));
365 
366 	key_for_each(sh_key, &ep->endpoint_shared_keys) {
367 		new = sctp_auth_shkey_create(sh_key->key_id, gfp);
368 		if (!new)
369 			goto nomem;
370 
371 		new->key = sh_key->key;
372 		sctp_auth_key_hold(new->key);
373 		list_add(&new->key_list, &asoc->endpoint_shared_keys);
374 	}
375 
376 	return 0;
377 
378 nomem:
379 	sctp_auth_destroy_keys(&asoc->endpoint_shared_keys);
380 	return -ENOMEM;
381 }
382 
383 
384 /* Public interface to create the association shared key.
385  * See code above for the algorithm.
386  */
387 int sctp_auth_asoc_init_active_key(struct sctp_association *asoc, gfp_t gfp)
388 {
389 	struct sctp_auth_bytes	*secret;
390 	struct sctp_shared_key *ep_key;
391 	struct sctp_chunk *chunk;
392 
393 	/* If we don't support AUTH, or peer is not capable
394 	 * we don't need to do anything.
395 	 */
396 	if (!asoc->ep->auth_enable || !asoc->peer.auth_capable)
397 		return 0;
398 
399 	/* If the key_id is non-zero and we couldn't find an
400 	 * endpoint pair shared key, we can't compute the
401 	 * secret.
402 	 * For key_id 0, endpoint pair shared key is a NULL key.
403 	 */
404 	ep_key = sctp_auth_get_shkey(asoc, asoc->active_key_id);
405 	BUG_ON(!ep_key);
406 
407 	secret = sctp_auth_asoc_create_secret(asoc, ep_key, gfp);
408 	if (!secret)
409 		return -ENOMEM;
410 
411 	sctp_auth_key_put(asoc->asoc_shared_key);
412 	asoc->asoc_shared_key = secret;
413 
414 	/* Update send queue in case any chunk already in there now
415 	 * needs authenticating
416 	 */
417 	list_for_each_entry(chunk, &asoc->outqueue.out_chunk_list, list) {
418 		if (sctp_auth_send_cid(chunk->chunk_hdr->type, asoc))
419 			chunk->auth = 1;
420 	}
421 
422 	return 0;
423 }
424 
425 
426 /* Find the endpoint pair shared key based on the key_id */
427 struct sctp_shared_key *sctp_auth_get_shkey(
428 				const struct sctp_association *asoc,
429 				__u16 key_id)
430 {
431 	struct sctp_shared_key *key;
432 
433 	/* First search associations set of endpoint pair shared keys */
434 	key_for_each(key, &asoc->endpoint_shared_keys) {
435 		if (key->key_id == key_id)
436 			return key;
437 	}
438 
439 	return NULL;
440 }
441 
442 /*
443  * Initialize all the possible digest transforms that we can use.  Right now
444  * now, the supported digests are SHA1 and SHA256.  We do this here once
445  * because of the restrictiong that transforms may only be allocated in
446  * user context.  This forces us to pre-allocated all possible transforms
447  * at the endpoint init time.
448  */
449 int sctp_auth_init_hmacs(struct sctp_endpoint *ep, gfp_t gfp)
450 {
451 	struct crypto_shash *tfm = NULL;
452 	__u16   id;
453 
454 	/* If AUTH extension is disabled, we are done */
455 	if (!ep->auth_enable) {
456 		ep->auth_hmacs = NULL;
457 		return 0;
458 	}
459 
460 	/* If the transforms are already allocated, we are done */
461 	if (ep->auth_hmacs)
462 		return 0;
463 
464 	/* Allocated the array of pointers to transorms */
465 	ep->auth_hmacs = kzalloc(sizeof(struct crypto_shash *) *
466 				 SCTP_AUTH_NUM_HMACS, gfp);
467 	if (!ep->auth_hmacs)
468 		return -ENOMEM;
469 
470 	for (id = 0; id < SCTP_AUTH_NUM_HMACS; id++) {
471 
472 		/* See is we support the id.  Supported IDs have name and
473 		 * length fields set, so that we can allocated and use
474 		 * them.  We can safely just check for name, for without the
475 		 * name, we can't allocate the TFM.
476 		 */
477 		if (!sctp_hmac_list[id].hmac_name)
478 			continue;
479 
480 		/* If this TFM has been allocated, we are all set */
481 		if (ep->auth_hmacs[id])
482 			continue;
483 
484 		/* Allocate the ID */
485 		tfm = crypto_alloc_shash(sctp_hmac_list[id].hmac_name, 0, 0);
486 		if (IS_ERR(tfm))
487 			goto out_err;
488 
489 		ep->auth_hmacs[id] = tfm;
490 	}
491 
492 	return 0;
493 
494 out_err:
495 	/* Clean up any successful allocations */
496 	sctp_auth_destroy_hmacs(ep->auth_hmacs);
497 	return -ENOMEM;
498 }
499 
500 /* Destroy the hmac tfm array */
501 void sctp_auth_destroy_hmacs(struct crypto_shash *auth_hmacs[])
502 {
503 	int i;
504 
505 	if (!auth_hmacs)
506 		return;
507 
508 	for (i = 0; i < SCTP_AUTH_NUM_HMACS; i++) {
509 		crypto_free_shash(auth_hmacs[i]);
510 	}
511 	kfree(auth_hmacs);
512 }
513 
514 
515 struct sctp_hmac *sctp_auth_get_hmac(__u16 hmac_id)
516 {
517 	return &sctp_hmac_list[hmac_id];
518 }
519 
520 /* Get an hmac description information that we can use to build
521  * the AUTH chunk
522  */
523 struct sctp_hmac *sctp_auth_asoc_get_hmac(const struct sctp_association *asoc)
524 {
525 	struct sctp_hmac_algo_param *hmacs;
526 	__u16 n_elt;
527 	__u16 id = 0;
528 	int i;
529 
530 	/* If we have a default entry, use it */
531 	if (asoc->default_hmac_id)
532 		return &sctp_hmac_list[asoc->default_hmac_id];
533 
534 	/* Since we do not have a default entry, find the first entry
535 	 * we support and return that.  Do not cache that id.
536 	 */
537 	hmacs = asoc->peer.peer_hmacs;
538 	if (!hmacs)
539 		return NULL;
540 
541 	n_elt = (ntohs(hmacs->param_hdr.length) -
542 		 sizeof(struct sctp_paramhdr)) >> 1;
543 	for (i = 0; i < n_elt; i++) {
544 		id = ntohs(hmacs->hmac_ids[i]);
545 
546 		/* Check the id is in the supported range. And
547 		 * see if we support the id.  Supported IDs have name and
548 		 * length fields set, so that we can allocate and use
549 		 * them.  We can safely just check for name, for without the
550 		 * name, we can't allocate the TFM.
551 		 */
552 		if (id > SCTP_AUTH_HMAC_ID_MAX ||
553 		    !sctp_hmac_list[id].hmac_name) {
554 			id = 0;
555 			continue;
556 		}
557 
558 		break;
559 	}
560 
561 	if (id == 0)
562 		return NULL;
563 
564 	return &sctp_hmac_list[id];
565 }
566 
567 static int __sctp_auth_find_hmacid(__be16 *hmacs, int n_elts, __be16 hmac_id)
568 {
569 	int  found = 0;
570 	int  i;
571 
572 	for (i = 0; i < n_elts; i++) {
573 		if (hmac_id == hmacs[i]) {
574 			found = 1;
575 			break;
576 		}
577 	}
578 
579 	return found;
580 }
581 
582 /* See if the HMAC_ID is one that we claim as supported */
583 int sctp_auth_asoc_verify_hmac_id(const struct sctp_association *asoc,
584 				    __be16 hmac_id)
585 {
586 	struct sctp_hmac_algo_param *hmacs;
587 	__u16 n_elt;
588 
589 	if (!asoc)
590 		return 0;
591 
592 	hmacs = (struct sctp_hmac_algo_param *)asoc->c.auth_hmacs;
593 	n_elt = (ntohs(hmacs->param_hdr.length) -
594 		 sizeof(struct sctp_paramhdr)) >> 1;
595 
596 	return __sctp_auth_find_hmacid(hmacs->hmac_ids, n_elt, hmac_id);
597 }
598 
599 
600 /* Cache the default HMAC id.  This to follow this text from SCTP-AUTH:
601  * Section 6.1:
602  *   The receiver of a HMAC-ALGO parameter SHOULD use the first listed
603  *   algorithm it supports.
604  */
605 void sctp_auth_asoc_set_default_hmac(struct sctp_association *asoc,
606 				     struct sctp_hmac_algo_param *hmacs)
607 {
608 	struct sctp_endpoint *ep;
609 	__u16   id;
610 	int	i;
611 	int	n_params;
612 
613 	/* if the default id is already set, use it */
614 	if (asoc->default_hmac_id)
615 		return;
616 
617 	n_params = (ntohs(hmacs->param_hdr.length) -
618 		    sizeof(struct sctp_paramhdr)) >> 1;
619 	ep = asoc->ep;
620 	for (i = 0; i < n_params; i++) {
621 		id = ntohs(hmacs->hmac_ids[i]);
622 
623 		/* Check the id is in the supported range */
624 		if (id > SCTP_AUTH_HMAC_ID_MAX)
625 			continue;
626 
627 		/* If this TFM has been allocated, use this id */
628 		if (ep->auth_hmacs[id]) {
629 			asoc->default_hmac_id = id;
630 			break;
631 		}
632 	}
633 }
634 
635 
636 /* Check to see if the given chunk is supposed to be authenticated */
637 static int __sctp_auth_cid(enum sctp_cid chunk, struct sctp_chunks_param *param)
638 {
639 	unsigned short len;
640 	int found = 0;
641 	int i;
642 
643 	if (!param || param->param_hdr.length == 0)
644 		return 0;
645 
646 	len = ntohs(param->param_hdr.length) - sizeof(struct sctp_paramhdr);
647 
648 	/* SCTP-AUTH, Section 3.2
649 	 *    The chunk types for INIT, INIT-ACK, SHUTDOWN-COMPLETE and AUTH
650 	 *    chunks MUST NOT be listed in the CHUNKS parameter.  However, if
651 	 *    a CHUNKS parameter is received then the types for INIT, INIT-ACK,
652 	 *    SHUTDOWN-COMPLETE and AUTH chunks MUST be ignored.
653 	 */
654 	for (i = 0; !found && i < len; i++) {
655 		switch (param->chunks[i]) {
656 		case SCTP_CID_INIT:
657 		case SCTP_CID_INIT_ACK:
658 		case SCTP_CID_SHUTDOWN_COMPLETE:
659 		case SCTP_CID_AUTH:
660 			break;
661 
662 		default:
663 			if (param->chunks[i] == chunk)
664 				found = 1;
665 			break;
666 		}
667 	}
668 
669 	return found;
670 }
671 
672 /* Check if peer requested that this chunk is authenticated */
673 int sctp_auth_send_cid(enum sctp_cid chunk, const struct sctp_association *asoc)
674 {
675 	if (!asoc)
676 		return 0;
677 
678 	if (!asoc->ep->auth_enable || !asoc->peer.auth_capable)
679 		return 0;
680 
681 	return __sctp_auth_cid(chunk, asoc->peer.peer_chunks);
682 }
683 
684 /* Check if we requested that peer authenticate this chunk. */
685 int sctp_auth_recv_cid(enum sctp_cid chunk, const struct sctp_association *asoc)
686 {
687 	if (!asoc)
688 		return 0;
689 
690 	if (!asoc->ep->auth_enable)
691 		return 0;
692 
693 	return __sctp_auth_cid(chunk,
694 			      (struct sctp_chunks_param *)asoc->c.auth_chunks);
695 }
696 
697 /* SCTP-AUTH: Section 6.2:
698  *    The sender MUST calculate the MAC as described in RFC2104 [2] using
699  *    the hash function H as described by the MAC Identifier and the shared
700  *    association key K based on the endpoint pair shared key described by
701  *    the shared key identifier.  The 'data' used for the computation of
702  *    the AUTH-chunk is given by the AUTH chunk with its HMAC field set to
703  *    zero (as shown in Figure 6) followed by all chunks that are placed
704  *    after the AUTH chunk in the SCTP packet.
705  */
706 void sctp_auth_calculate_hmac(const struct sctp_association *asoc,
707 			      struct sk_buff *skb,
708 			      struct sctp_auth_chunk *auth,
709 			      gfp_t gfp)
710 {
711 	struct crypto_shash *tfm;
712 	struct sctp_auth_bytes *asoc_key;
713 	__u16 key_id, hmac_id;
714 	__u8 *digest;
715 	unsigned char *end;
716 	int free_key = 0;
717 
718 	/* Extract the info we need:
719 	 * - hmac id
720 	 * - key id
721 	 */
722 	key_id = ntohs(auth->auth_hdr.shkey_id);
723 	hmac_id = ntohs(auth->auth_hdr.hmac_id);
724 
725 	if (key_id == asoc->active_key_id)
726 		asoc_key = asoc->asoc_shared_key;
727 	else {
728 		struct sctp_shared_key *ep_key;
729 
730 		ep_key = sctp_auth_get_shkey(asoc, key_id);
731 		if (!ep_key)
732 			return;
733 
734 		asoc_key = sctp_auth_asoc_create_secret(asoc, ep_key, gfp);
735 		if (!asoc_key)
736 			return;
737 
738 		free_key = 1;
739 	}
740 
741 	/* set up scatter list */
742 	end = skb_tail_pointer(skb);
743 
744 	tfm = asoc->ep->auth_hmacs[hmac_id];
745 
746 	digest = auth->auth_hdr.hmac;
747 	if (crypto_shash_setkey(tfm, &asoc_key->data[0], asoc_key->len))
748 		goto free;
749 
750 	{
751 		SHASH_DESC_ON_STACK(desc, tfm);
752 
753 		desc->tfm = tfm;
754 		desc->flags = 0;
755 		crypto_shash_digest(desc, (u8 *)auth,
756 				    end - (unsigned char *)auth, digest);
757 		shash_desc_zero(desc);
758 	}
759 
760 free:
761 	if (free_key)
762 		sctp_auth_key_put(asoc_key);
763 }
764 
765 /* API Helpers */
766 
767 /* Add a chunk to the endpoint authenticated chunk list */
768 int sctp_auth_ep_add_chunkid(struct sctp_endpoint *ep, __u8 chunk_id)
769 {
770 	struct sctp_chunks_param *p = ep->auth_chunk_list;
771 	__u16 nchunks;
772 	__u16 param_len;
773 
774 	/* If this chunk is already specified, we are done */
775 	if (__sctp_auth_cid(chunk_id, p))
776 		return 0;
777 
778 	/* Check if we can add this chunk to the array */
779 	param_len = ntohs(p->param_hdr.length);
780 	nchunks = param_len - sizeof(struct sctp_paramhdr);
781 	if (nchunks == SCTP_NUM_CHUNK_TYPES)
782 		return -EINVAL;
783 
784 	p->chunks[nchunks] = chunk_id;
785 	p->param_hdr.length = htons(param_len + 1);
786 	return 0;
787 }
788 
789 /* Add hmac identifires to the endpoint list of supported hmac ids */
790 int sctp_auth_ep_set_hmacs(struct sctp_endpoint *ep,
791 			   struct sctp_hmacalgo *hmacs)
792 {
793 	int has_sha1 = 0;
794 	__u16 id;
795 	int i;
796 
797 	/* Scan the list looking for unsupported id.  Also make sure that
798 	 * SHA1 is specified.
799 	 */
800 	for (i = 0; i < hmacs->shmac_num_idents; i++) {
801 		id = hmacs->shmac_idents[i];
802 
803 		if (id > SCTP_AUTH_HMAC_ID_MAX)
804 			return -EOPNOTSUPP;
805 
806 		if (SCTP_AUTH_HMAC_ID_SHA1 == id)
807 			has_sha1 = 1;
808 
809 		if (!sctp_hmac_list[id].hmac_name)
810 			return -EOPNOTSUPP;
811 	}
812 
813 	if (!has_sha1)
814 		return -EINVAL;
815 
816 	for (i = 0; i < hmacs->shmac_num_idents; i++)
817 		ep->auth_hmacs_list->hmac_ids[i] =
818 				htons(hmacs->shmac_idents[i]);
819 	ep->auth_hmacs_list->param_hdr.length =
820 			htons(sizeof(struct sctp_paramhdr) +
821 			hmacs->shmac_num_idents * sizeof(__u16));
822 	return 0;
823 }
824 
825 /* Set a new shared key on either endpoint or association.  If the
826  * the key with a same ID already exists, replace the key (remove the
827  * old key and add a new one).
828  */
829 int sctp_auth_set_key(struct sctp_endpoint *ep,
830 		      struct sctp_association *asoc,
831 		      struct sctp_authkey *auth_key)
832 {
833 	struct sctp_shared_key *cur_key = NULL;
834 	struct sctp_auth_bytes *key;
835 	struct list_head *sh_keys;
836 	int replace = 0;
837 
838 	/* Try to find the given key id to see if
839 	 * we are doing a replace, or adding a new key
840 	 */
841 	if (asoc)
842 		sh_keys = &asoc->endpoint_shared_keys;
843 	else
844 		sh_keys = &ep->endpoint_shared_keys;
845 
846 	key_for_each(cur_key, sh_keys) {
847 		if (cur_key->key_id == auth_key->sca_keynumber) {
848 			replace = 1;
849 			break;
850 		}
851 	}
852 
853 	/* If we are not replacing a key id, we need to allocate
854 	 * a shared key.
855 	 */
856 	if (!replace) {
857 		cur_key = sctp_auth_shkey_create(auth_key->sca_keynumber,
858 						 GFP_KERNEL);
859 		if (!cur_key)
860 			return -ENOMEM;
861 	}
862 
863 	/* Create a new key data based on the info passed in */
864 	key = sctp_auth_create_key(auth_key->sca_keylength, GFP_KERNEL);
865 	if (!key)
866 		goto nomem;
867 
868 	memcpy(key->data, &auth_key->sca_key[0], auth_key->sca_keylength);
869 
870 	/* If we are replacing, remove the old keys data from the
871 	 * key id.  If we are adding new key id, add it to the
872 	 * list.
873 	 */
874 	if (replace)
875 		sctp_auth_key_put(cur_key->key);
876 	else
877 		list_add(&cur_key->key_list, sh_keys);
878 
879 	cur_key->key = key;
880 	return 0;
881 nomem:
882 	if (!replace)
883 		sctp_auth_shkey_free(cur_key);
884 
885 	return -ENOMEM;
886 }
887 
888 int sctp_auth_set_active_key(struct sctp_endpoint *ep,
889 			     struct sctp_association *asoc,
890 			     __u16  key_id)
891 {
892 	struct sctp_shared_key *key;
893 	struct list_head *sh_keys;
894 	int found = 0;
895 
896 	/* The key identifier MUST correst to an existing key */
897 	if (asoc)
898 		sh_keys = &asoc->endpoint_shared_keys;
899 	else
900 		sh_keys = &ep->endpoint_shared_keys;
901 
902 	key_for_each(key, sh_keys) {
903 		if (key->key_id == key_id) {
904 			found = 1;
905 			break;
906 		}
907 	}
908 
909 	if (!found)
910 		return -EINVAL;
911 
912 	if (asoc) {
913 		asoc->active_key_id = key_id;
914 		sctp_auth_asoc_init_active_key(asoc, GFP_KERNEL);
915 	} else
916 		ep->active_key_id = key_id;
917 
918 	return 0;
919 }
920 
921 int sctp_auth_del_key_id(struct sctp_endpoint *ep,
922 			 struct sctp_association *asoc,
923 			 __u16  key_id)
924 {
925 	struct sctp_shared_key *key;
926 	struct list_head *sh_keys;
927 	int found = 0;
928 
929 	/* The key identifier MUST NOT be the current active key
930 	 * The key identifier MUST correst to an existing key
931 	 */
932 	if (asoc) {
933 		if (asoc->active_key_id == key_id)
934 			return -EINVAL;
935 
936 		sh_keys = &asoc->endpoint_shared_keys;
937 	} else {
938 		if (ep->active_key_id == key_id)
939 			return -EINVAL;
940 
941 		sh_keys = &ep->endpoint_shared_keys;
942 	}
943 
944 	key_for_each(key, sh_keys) {
945 		if (key->key_id == key_id) {
946 			found = 1;
947 			break;
948 		}
949 	}
950 
951 	if (!found)
952 		return -EINVAL;
953 
954 	/* Delete the shared key */
955 	list_del_init(&key->key_list);
956 	sctp_auth_shkey_free(key);
957 
958 	return 0;
959 }
960