request_key_auth.c 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276
  1. /* Request key authorisation token key definition.
  2. *
  3. * Copyright (C) 2005 Red Hat, Inc. All Rights Reserved.
  4. * Written by David Howells (dhowells@redhat.com)
  5. *
  6. * This program is free software; you can redistribute it and/or
  7. * modify it under the terms of the GNU General Public License
  8. * as published by the Free Software Foundation; either version
  9. * 2 of the License, or (at your option) any later version.
  10. *
  11. * See Documentation/security/keys/request-key.rst
  12. */
  13. #include <linux/module.h>
  14. #include <linux/sched.h>
  15. #include <linux/err.h>
  16. #include <linux/seq_file.h>
  17. #include <linux/slab.h>
  18. #include <linux/uaccess.h>
  19. #include "internal.h"
  20. #include <keys/request_key_auth-type.h>
  21. static int request_key_auth_preparse(struct key_preparsed_payload *);
  22. static void request_key_auth_free_preparse(struct key_preparsed_payload *);
  23. static int request_key_auth_instantiate(struct key *,
  24. struct key_preparsed_payload *);
  25. static void request_key_auth_describe(const struct key *, struct seq_file *);
  26. static void request_key_auth_revoke(struct key *);
  27. static void request_key_auth_destroy(struct key *);
  28. static long request_key_auth_read(const struct key *, char *, size_t);
  29. /*
  30. * The request-key authorisation key type definition.
  31. */
  32. struct key_type key_type_request_key_auth = {
  33. .name = ".request_key_auth",
  34. .def_datalen = sizeof(struct request_key_auth),
  35. .preparse = request_key_auth_preparse,
  36. .free_preparse = request_key_auth_free_preparse,
  37. .instantiate = request_key_auth_instantiate,
  38. .describe = request_key_auth_describe,
  39. .revoke = request_key_auth_revoke,
  40. .destroy = request_key_auth_destroy,
  41. .read = request_key_auth_read,
  42. };
  43. static int request_key_auth_preparse(struct key_preparsed_payload *prep)
  44. {
  45. return 0;
  46. }
  47. static void request_key_auth_free_preparse(struct key_preparsed_payload *prep)
  48. {
  49. }
  50. /*
  51. * Instantiate a request-key authorisation key.
  52. */
  53. static int request_key_auth_instantiate(struct key *key,
  54. struct key_preparsed_payload *prep)
  55. {
  56. key->payload.data[0] = (struct request_key_auth *)prep->data;
  57. return 0;
  58. }
  59. /*
  60. * Describe an authorisation token.
  61. */
  62. static void request_key_auth_describe(const struct key *key,
  63. struct seq_file *m)
  64. {
  65. struct request_key_auth *rka = get_request_key_auth(key);
  66. if (!rka)
  67. return;
  68. seq_puts(m, "key:");
  69. seq_puts(m, key->description);
  70. if (key_is_positive(key))
  71. seq_printf(m, " pid:%d ci:%zu", rka->pid, rka->callout_len);
  72. }
  73. /*
  74. * Read the callout_info data (retrieves the callout information).
  75. * - the key's semaphore is read-locked
  76. */
  77. static long request_key_auth_read(const struct key *key,
  78. char *buffer, size_t buflen)
  79. {
  80. struct request_key_auth *rka = get_request_key_auth(key);
  81. size_t datalen;
  82. long ret;
  83. if (!rka)
  84. return -EKEYREVOKED;
  85. datalen = rka->callout_len;
  86. ret = datalen;
  87. /* we can return the data as is */
  88. if (buffer && buflen > 0) {
  89. if (buflen > datalen)
  90. buflen = datalen;
  91. memcpy(buffer, rka->callout_info, buflen);
  92. }
  93. return ret;
  94. }
  95. /*
  96. * Handle revocation of an authorisation token key.
  97. *
  98. * Called with the key sem write-locked.
  99. */
  100. static void request_key_auth_revoke(struct key *key)
  101. {
  102. struct request_key_auth *rka = get_request_key_auth(key);
  103. kenter("{%d}", key->serial);
  104. if (rka->cred) {
  105. put_cred(rka->cred);
  106. rka->cred = NULL;
  107. }
  108. }
  109. static void free_request_key_auth(struct request_key_auth *rka)
  110. {
  111. if (!rka)
  112. return;
  113. key_put(rka->target_key);
  114. key_put(rka->dest_keyring);
  115. if (rka->cred)
  116. put_cred(rka->cred);
  117. kfree(rka->callout_info);
  118. kfree(rka);
  119. }
  120. /*
  121. * Destroy an instantiation authorisation token key.
  122. */
  123. static void request_key_auth_destroy(struct key *key)
  124. {
  125. struct request_key_auth *rka = get_request_key_auth(key);
  126. kenter("{%d}", key->serial);
  127. free_request_key_auth(rka);
  128. }
  129. /*
  130. * Create an authorisation token for /sbin/request-key or whoever to gain
  131. * access to the caller's security data.
  132. */
  133. struct key *request_key_auth_new(struct key *target, const char *op,
  134. const void *callout_info, size_t callout_len,
  135. struct key *dest_keyring)
  136. {
  137. struct request_key_auth *rka, *irka;
  138. const struct cred *cred = current->cred;
  139. struct key *authkey = NULL;
  140. char desc[20];
  141. int ret = -ENOMEM;
  142. kenter("%d,", target->serial);
  143. /* allocate a auth record */
  144. rka = kzalloc(sizeof(*rka), GFP_KERNEL);
  145. if (!rka)
  146. goto error;
  147. rka->callout_info = kmemdup(callout_info, callout_len, GFP_KERNEL);
  148. if (!rka->callout_info)
  149. goto error_free_rka;
  150. rka->callout_len = callout_len;
  151. strlcpy(rka->op, op, sizeof(rka->op));
  152. /* see if the calling process is already servicing the key request of
  153. * another process */
  154. if (cred->request_key_auth) {
  155. /* it is - use that instantiation context here too */
  156. down_read(&cred->request_key_auth->sem);
  157. /* if the auth key has been revoked, then the key we're
  158. * servicing is already instantiated */
  159. if (test_bit(KEY_FLAG_REVOKED,
  160. &cred->request_key_auth->flags)) {
  161. up_read(&cred->request_key_auth->sem);
  162. ret = -EKEYREVOKED;
  163. goto error_free_rka;
  164. }
  165. irka = cred->request_key_auth->payload.data[0];
  166. rka->cred = get_cred(irka->cred);
  167. rka->pid = irka->pid;
  168. up_read(&cred->request_key_auth->sem);
  169. }
  170. else {
  171. /* it isn't - use this process as the context */
  172. rka->cred = get_cred(cred);
  173. rka->pid = current->pid;
  174. }
  175. rka->target_key = key_get(target);
  176. rka->dest_keyring = key_get(dest_keyring);
  177. /* allocate the auth key */
  178. sprintf(desc, "%x", target->serial);
  179. authkey = key_alloc(&key_type_request_key_auth, desc,
  180. cred->fsuid, cred->fsgid, cred,
  181. KEY_POS_VIEW | KEY_POS_READ | KEY_POS_SEARCH |
  182. KEY_USR_VIEW, KEY_ALLOC_NOT_IN_QUOTA, NULL);
  183. if (IS_ERR(authkey)) {
  184. ret = PTR_ERR(authkey);
  185. goto error_free_rka;
  186. }
  187. /* construct the auth key */
  188. ret = key_instantiate_and_link(authkey, rka, 0, NULL, NULL);
  189. if (ret < 0)
  190. goto error_put_authkey;
  191. kleave(" = {%d,%d}", authkey->serial, refcount_read(&authkey->usage));
  192. return authkey;
  193. error_put_authkey:
  194. key_put(authkey);
  195. error_free_rka:
  196. free_request_key_auth(rka);
  197. error:
  198. kleave("= %d", ret);
  199. return ERR_PTR(ret);
  200. }
  201. /*
  202. * Search the current process's keyrings for the authorisation key for
  203. * instantiation of a key.
  204. */
  205. struct key *key_get_instantiation_authkey(key_serial_t target_id)
  206. {
  207. char description[16];
  208. struct keyring_search_context ctx = {
  209. .index_key.type = &key_type_request_key_auth,
  210. .index_key.description = description,
  211. .cred = current_cred(),
  212. .match_data.cmp = key_default_cmp,
  213. .match_data.raw_data = description,
  214. .match_data.lookup_type = KEYRING_SEARCH_LOOKUP_DIRECT,
  215. .flags = KEYRING_SEARCH_DO_STATE_CHECK,
  216. };
  217. struct key *authkey;
  218. key_ref_t authkey_ref;
  219. ctx.index_key.desc_len = sprintf(description, "%x", target_id);
  220. authkey_ref = search_process_keyrings(&ctx);
  221. if (IS_ERR(authkey_ref)) {
  222. authkey = ERR_CAST(authkey_ref);
  223. if (authkey == ERR_PTR(-EAGAIN))
  224. authkey = ERR_PTR(-ENOKEY);
  225. goto error;
  226. }
  227. authkey = key_ref_to_ptr(authkey_ref);
  228. if (test_bit(KEY_FLAG_REVOKED, &authkey->flags)) {
  229. key_put(authkey);
  230. authkey = ERR_PTR(-EKEYREVOKED);
  231. }
  232. error:
  233. return authkey;
  234. }