1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* RxRPC key management
4 * Copyright (C) 2007 Red Hat, Inc. All Rights Reserved.
5 * Written by David Howells (dhowells@redhat.com)
7 * RxRPC keys should have a description of describing their purpose:
11 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
13 #include <crypto/skcipher.h>
14 #include <linux/module.h>
15 #include <linux/net.h>
16 #include <linux/skbuff.h>
17 #include <linux/key-type.h>
18 #include <linux/ctype.h>
19 #include <linux/slab.h>
21 #include <net/af_rxrpc.h>
22 #include <keys/rxrpc-type.h>
23 #include <keys/user-type.h>
24 #include "ar-internal.h"
26 static int rxrpc_preparse(struct key_preparsed_payload *);
27 static void rxrpc_free_preparse(struct key_preparsed_payload *);
28 static void rxrpc_destroy(struct key *);
29 static void rxrpc_describe(const struct key *, struct seq_file *);
30 static long rxrpc_read(const struct key *, char *, size_t);
33 * rxrpc defined keys take an arbitrary string as the description and an
34 * arbitrary blob of data as the payload
36 struct key_type key_type_rxrpc = {
38 .flags = KEY_TYPE_NET_DOMAIN,
39 .preparse = rxrpc_preparse,
40 .free_preparse = rxrpc_free_preparse,
41 .instantiate = generic_key_instantiate,
42 .destroy = rxrpc_destroy,
43 .describe = rxrpc_describe,
46 EXPORT_SYMBOL(key_type_rxrpc);
49 * parse an RxKAD type XDR format token
50 * - the caller guarantees we have at least 4 words
52 static int rxrpc_preparse_xdr_rxkad(struct key_preparsed_payload *prep,
54 const __be32 *xdr, unsigned int toklen)
56 struct rxrpc_key_token *token, **pptoken;
61 _enter(",{%x,%x,%x,%x},%u",
62 ntohl(xdr[0]), ntohl(xdr[1]), ntohl(xdr[2]), ntohl(xdr[3]),
67 tktlen = ntohl(xdr[7]);
68 _debug("tktlen: %x", tktlen);
69 if (tktlen > AFSTOKEN_RK_TIX_MAX)
71 if (toklen < 8 * 4 + tktlen)
74 plen = sizeof(*token) + sizeof(*token->kad) + tktlen;
75 prep->quotalen = datalen + plen;
77 plen -= sizeof(*token);
78 token = kzalloc(sizeof(*token), GFP_KERNEL);
82 token->kad = kzalloc(plen, GFP_KERNEL);
88 token->security_index = RXRPC_SECURITY_RXKAD;
89 token->kad->ticket_len = tktlen;
90 token->kad->vice_id = ntohl(xdr[0]);
91 token->kad->kvno = ntohl(xdr[1]);
92 token->kad->start = ntohl(xdr[4]);
93 token->kad->expiry = ntohl(xdr[5]);
94 token->kad->primary_flag = ntohl(xdr[6]);
95 memcpy(&token->kad->session_key, &xdr[2], 8);
96 memcpy(&token->kad->ticket, &xdr[8], tktlen);
98 _debug("SCIX: %u", token->security_index);
99 _debug("TLEN: %u", token->kad->ticket_len);
100 _debug("EXPY: %x", token->kad->expiry);
101 _debug("KVNO: %u", token->kad->kvno);
102 _debug("PRIM: %u", token->kad->primary_flag);
103 _debug("SKEY: %02x%02x%02x%02x%02x%02x%02x%02x",
104 token->kad->session_key[0], token->kad->session_key[1],
105 token->kad->session_key[2], token->kad->session_key[3],
106 token->kad->session_key[4], token->kad->session_key[5],
107 token->kad->session_key[6], token->kad->session_key[7]);
108 if (token->kad->ticket_len >= 8)
109 _debug("TCKT: %02x%02x%02x%02x%02x%02x%02x%02x",
110 token->kad->ticket[0], token->kad->ticket[1],
111 token->kad->ticket[2], token->kad->ticket[3],
112 token->kad->ticket[4], token->kad->ticket[5],
113 token->kad->ticket[6], token->kad->ticket[7]);
115 /* count the number of tokens attached */
116 prep->payload.data[1] = (void *)((unsigned long)prep->payload.data[1] + 1);
118 /* attach the data */
119 for (pptoken = (struct rxrpc_key_token **)&prep->payload.data[0];
121 pptoken = &(*pptoken)->next)
124 expiry = rxrpc_u32_to_time64(token->kad->expiry);
125 if (expiry < prep->expiry)
126 prep->expiry = expiry;
133 * attempt to parse the data as the XDR format
134 * - the caller guarantees we have more than 7 words
136 static int rxrpc_preparse_xdr(struct key_preparsed_payload *prep)
138 const __be32 *xdr = prep->data, *token, *p;
140 unsigned int len, paddedlen, loop, ntoken, toklen, sec_ix;
141 size_t datalen = prep->datalen;
144 _enter(",{%x,%x,%x,%x},%zu",
145 ntohl(xdr[0]), ntohl(xdr[1]), ntohl(xdr[2]), ntohl(xdr[3]),
148 if (datalen > AFSTOKEN_LENGTH_MAX)
151 /* XDR is an array of __be32's */
155 /* the flags should be 0 (the setpag bit must be handled by
157 if (ntohl(*xdr++) != 0)
161 /* check the cell name */
163 if (len < 1 || len > AFSTOKEN_CELL_MAX)
166 paddedlen = (len + 3) & ~3;
167 if (paddedlen > datalen)
170 cp = (const char *) xdr;
171 for (loop = 0; loop < len; loop++)
172 if (!isprint(cp[loop]))
174 for (; loop < paddedlen; loop++)
177 _debug("cellname: [%u/%u] '%*.*s'",
178 len, paddedlen, len, len, (const char *) xdr);
179 datalen -= paddedlen;
180 xdr += paddedlen >> 2;
182 /* get the token count */
185 ntoken = ntohl(*xdr++);
187 _debug("ntoken: %x", ntoken);
188 if (ntoken < 1 || ntoken > AFSTOKEN_MAX)
191 /* check each token wrapper */
197 toklen = ntohl(*p++);
200 _debug("token: [%x/%zx] %x", toklen, datalen, sec_ix);
201 paddedlen = (toklen + 3) & ~3;
202 if (toklen < 20 || toklen > datalen || paddedlen > datalen)
204 datalen -= paddedlen;
207 } while (--loop > 0);
209 _debug("remainder: %zu", datalen);
213 /* okay: we're going to assume it's valid XDR format
214 * - we ignore the cellname, relying on the key to be correctly named
216 ret = -EPROTONOSUPPORT;
218 toklen = ntohl(*xdr++);
220 xdr += (toklen + 3) / 4;
222 sec_ix = ntohl(*token++);
225 _debug("TOKEN type=%x len=%x", sec_ix, toklen);
228 case RXRPC_SECURITY_RXKAD:
229 ret2 = rxrpc_preparse_xdr_rxkad(prep, datalen, token, toklen);
232 ret2 = -EPROTONOSUPPORT;
240 case -EPROTONOSUPPORT:
251 } while (--ntoken > 0);
254 _leave(" = %d", ret);
258 _leave(" = -EPROTO");
263 * Preparse an rxrpc defined key.
265 * Data should be of the form:
267 * 0 4 key interface version number
268 * 4 2 security index (type)
270 * 8 4 key expiry time (time_t)
275 * if no data is provided, then a no-security key is made
277 static int rxrpc_preparse(struct key_preparsed_payload *prep)
279 const struct rxrpc_key_data_v1 *v1;
280 struct rxrpc_key_token *token, **pp;
286 _enter("%zu", prep->datalen);
288 /* handle a no-security key */
289 if (!prep->data && prep->datalen == 0)
292 /* determine if the XDR payload format is being used */
293 if (prep->datalen > 7 * 4) {
294 ret = rxrpc_preparse_xdr(prep);
299 /* get the key interface version number */
301 if (prep->datalen <= 4 || !prep->data)
303 memcpy(&kver, prep->data, sizeof(kver));
304 prep->data += sizeof(kver);
305 prep->datalen -= sizeof(kver);
307 _debug("KEY I/F VERSION: %u", kver);
313 /* deal with a version 1 key */
315 if (prep->datalen < sizeof(*v1))
319 if (prep->datalen != sizeof(*v1) + v1->ticket_length)
322 _debug("SCIX: %u", v1->security_index);
323 _debug("TLEN: %u", v1->ticket_length);
324 _debug("EXPY: %x", v1->expiry);
325 _debug("KVNO: %u", v1->kvno);
326 _debug("SKEY: %02x%02x%02x%02x%02x%02x%02x%02x",
327 v1->session_key[0], v1->session_key[1],
328 v1->session_key[2], v1->session_key[3],
329 v1->session_key[4], v1->session_key[5],
330 v1->session_key[6], v1->session_key[7]);
331 if (v1->ticket_length >= 8)
332 _debug("TCKT: %02x%02x%02x%02x%02x%02x%02x%02x",
333 v1->ticket[0], v1->ticket[1],
334 v1->ticket[2], v1->ticket[3],
335 v1->ticket[4], v1->ticket[5],
336 v1->ticket[6], v1->ticket[7]);
338 ret = -EPROTONOSUPPORT;
339 if (v1->security_index != RXRPC_SECURITY_RXKAD)
342 plen = sizeof(*token->kad) + v1->ticket_length;
343 prep->quotalen = plen + sizeof(*token);
346 token = kzalloc(sizeof(*token), GFP_KERNEL);
349 token->kad = kzalloc(plen, GFP_KERNEL);
353 token->security_index = RXRPC_SECURITY_RXKAD;
354 token->kad->ticket_len = v1->ticket_length;
355 token->kad->expiry = v1->expiry;
356 token->kad->kvno = v1->kvno;
357 memcpy(&token->kad->session_key, &v1->session_key, 8);
358 memcpy(&token->kad->ticket, v1->ticket, v1->ticket_length);
360 /* count the number of tokens attached */
361 prep->payload.data[1] = (void *)((unsigned long)prep->payload.data[1] + 1);
363 /* attach the data */
364 pp = (struct rxrpc_key_token **)&prep->payload.data[0];
368 expiry = rxrpc_u32_to_time64(token->kad->expiry);
369 if (expiry < prep->expiry)
370 prep->expiry = expiry;
383 static void rxrpc_free_token_list(struct rxrpc_key_token *token)
385 struct rxrpc_key_token *next;
387 for (; token; token = next) {
389 switch (token->security_index) {
390 case RXRPC_SECURITY_RXKAD:
394 pr_err("Unknown token type %x on rxrpc key\n",
395 token->security_index);
404 * Clean up preparse data.
406 static void rxrpc_free_preparse(struct key_preparsed_payload *prep)
408 rxrpc_free_token_list(prep->payload.data[0]);
412 * dispose of the data dangling from the corpse of a rxrpc key
414 static void rxrpc_destroy(struct key *key)
416 rxrpc_free_token_list(key->payload.data[0]);
420 * describe the rxrpc key
422 static void rxrpc_describe(const struct key *key, struct seq_file *m)
424 const struct rxrpc_key_token *token;
425 const char *sep = ": ";
427 seq_puts(m, key->description);
429 for (token = key->payload.data[0]; token; token = token->next) {
432 switch (token->security_index) {
433 case RXRPC_SECURITY_RXKAD:
436 default: /* we have a ticket we can't encode */
437 seq_printf(m, "%u", token->security_index);
446 * grab the security key for a socket
448 int rxrpc_request_key(struct rxrpc_sock *rx, sockptr_t optval, int optlen)
455 if (optlen <= 0 || optlen > PAGE_SIZE - 1 || rx->securities)
458 description = memdup_sockptr_nul(optval, optlen);
459 if (IS_ERR(description))
460 return PTR_ERR(description);
462 key = request_key_net(&key_type_rxrpc, description, sock_net(&rx->sk), NULL);
465 _leave(" = %ld", PTR_ERR(key));
471 _leave(" = 0 [key %x]", key->serial);
476 * generate a server data key
478 int rxrpc_get_server_data_key(struct rxrpc_connection *conn,
479 const void *session_key,
483 const struct cred *cred = current_cred();
489 struct rxrpc_key_data_v1 v1;
494 key = key_alloc(&key_type_rxrpc, "x",
495 GLOBAL_ROOT_UID, GLOBAL_ROOT_GID, cred, 0,
496 KEY_ALLOC_NOT_IN_QUOTA, NULL);
498 _leave(" = -ENOMEM [alloc %ld]", PTR_ERR(key));
502 _debug("key %d", key_serial(key));
505 data.v1.security_index = RXRPC_SECURITY_RXKAD;
506 data.v1.ticket_length = 0;
507 data.v1.expiry = rxrpc_time64_to_u32(expiry);
510 memcpy(&data.v1.session_key, session_key, sizeof(data.v1.session_key));
512 ret = key_instantiate_and_link(key, &data, sizeof(data), NULL, NULL);
516 conn->params.key = key;
517 _leave(" = 0 [%d]", key_serial(key));
523 _leave(" = -ENOMEM [ins %d]", ret);
526 EXPORT_SYMBOL(rxrpc_get_server_data_key);
529 * rxrpc_get_null_key - Generate a null RxRPC key
530 * @keyname: The name to give the key.
532 * Generate a null RxRPC key that can be used to indicate anonymous security is
533 * required for a particular domain.
535 struct key *rxrpc_get_null_key(const char *keyname)
537 const struct cred *cred = current_cred();
541 key = key_alloc(&key_type_rxrpc, keyname,
542 GLOBAL_ROOT_UID, GLOBAL_ROOT_GID, cred,
543 KEY_POS_SEARCH, KEY_ALLOC_NOT_IN_QUOTA, NULL);
547 ret = key_instantiate_and_link(key, NULL, 0, NULL, NULL);
556 EXPORT_SYMBOL(rxrpc_get_null_key);
559 * read the contents of an rxrpc key
560 * - this returns the result in XDR form
562 static long rxrpc_read(const struct key *key,
563 char *buffer, size_t buflen)
565 const struct rxrpc_key_token *token;
567 __be32 *xdr, *oldxdr;
568 u32 cnlen, toksize, ntoks, tok, zero;
569 u16 toksizes[AFSTOKEN_MAX];
573 /* we don't know what form we should return non-AFS keys in */
574 if (memcmp(key->description, "afs@", 4) != 0)
576 cnlen = strlen(key->description + 4);
578 #define RND(X) (((X) + 3) & ~3)
580 /* AFS keys we return in XDR form, so we need to work out the size of
582 size = 2 * 4; /* flags, cellname len */
583 size += RND(cnlen); /* cellname */
584 size += 1 * 4; /* token count */
587 for (token = key->payload.data[0]; token; token = token->next) {
588 toksize = 4; /* sec index */
590 switch (token->security_index) {
591 case RXRPC_SECURITY_RXKAD:
592 toksize += 8 * 4; /* viceid, kvno, key*2, begin,
593 * end, primary, tktlen */
594 if (!token->no_leak_key)
595 toksize += RND(token->kad->ticket_len);
598 default: /* we have a ticket we can't encode */
599 pr_err("Unsupported key token type (%u)\n",
600 token->security_index);
604 _debug("token[%u]: toksize=%u", ntoks, toksize);
605 ASSERTCMP(toksize, <=, AFSTOKEN_LENGTH_MAX);
607 toksizes[ntoks++] = toksize;
608 size += toksize + 4; /* each token has a length word */
613 if (!buffer || buflen < size)
616 xdr = (__be32 *)buffer;
622 #define ENCODE_DATA(l, s) \
626 memcpy(xdr, (s), _l); \
628 memcpy((u8 *)xdr + _l, &zero, 4 - (_l & 3)); \
629 xdr += (_l + 3) >> 2; \
631 #define ENCODE_BYTES(l, s) \
634 memcpy(xdr, (s), _l); \
636 memcpy((u8 *)xdr + _l, &zero, 4 - (_l & 3)); \
637 xdr += (_l + 3) >> 2; \
639 #define ENCODE64(x) \
641 __be64 y = cpu_to_be64(x); \
642 memcpy(xdr, &y, 8); \
645 #define ENCODE_STR(s) \
647 const char *_s = (s); \
648 ENCODE_DATA(strlen(_s), _s); \
651 ENCODE(0); /* flags */
652 ENCODE_DATA(cnlen, key->description + 4); /* cellname */
656 for (token = key->payload.data[0]; token; token = token->next) {
657 toksize = toksizes[tok++];
660 ENCODE(token->security_index);
662 switch (token->security_index) {
663 case RXRPC_SECURITY_RXKAD:
664 ENCODE(token->kad->vice_id);
665 ENCODE(token->kad->kvno);
666 ENCODE_BYTES(8, token->kad->session_key);
667 ENCODE(token->kad->start);
668 ENCODE(token->kad->expiry);
669 ENCODE(token->kad->primary_flag);
670 if (token->no_leak_key)
673 ENCODE_DATA(token->kad->ticket_len, token->kad->ticket);
677 pr_err("Unsupported key token type (%u)\n",
678 token->security_index);
682 ASSERTCMP((unsigned long)xdr - (unsigned long)oldxdr, ==,
691 ASSERTCMP(tok, ==, ntoks);
692 ASSERTCMP((char __user *) xdr - buffer, ==, size);
693 _leave(" = %zu", size);