process_keys.c 21.1 KB
Newer Older
1
/* Manage a process's keyrings
L
Linus Torvalds 已提交
2
 *
3
 * Copyright (C) 2004-2005, 2008 Red Hat, Inc. All Rights Reserved.
L
Linus Torvalds 已提交
4 5 6 7 8 9 10 11 12 13 14
 * Written by David Howells (dhowells@redhat.com)
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version
 * 2 of the License, or (at your option) any later version.
 */

#include <linux/module.h>
#include <linux/init.h>
#include <linux/sched.h>
15
#include <linux/sched/user.h>
L
Linus Torvalds 已提交
16 17 18
#include <linux/keyctl.h>
#include <linux/fs.h>
#include <linux/err.h>
I
Ingo Molnar 已提交
19
#include <linux/mutex.h>
20
#include <linux/security.h>
21
#include <linux/user_namespace.h>
22
#include <linux/uaccess.h>
L
Linus Torvalds 已提交
23 24
#include "internal.h"

25
/* Session keyring create vs join semaphore */
I
Ingo Molnar 已提交
26
static DEFINE_MUTEX(key_session_mutex);
L
Linus Torvalds 已提交
27

28
/* User keyring creation semaphore */
29 30
static DEFINE_MUTEX(key_user_keyring_mutex);

31
/* The root user's tracking struct */
L
Linus Torvalds 已提交
32
struct key_user root_key_user = {
33
	.usage		= REFCOUNT_INIT(3),
34
	.cons_lock	= __MUTEX_INITIALIZER(root_key_user.cons_lock),
35
	.lock		= __SPIN_LOCK_UNLOCKED(root_key_user.lock),
L
Linus Torvalds 已提交
36 37
	.nkeys		= ATOMIC_INIT(2),
	.nikeys		= ATOMIC_INIT(2),
38
	.uid		= GLOBAL_ROOT_UID,
L
Linus Torvalds 已提交
39 40 41
};

/*
42
 * Install the user and user session keyrings for the current process's UID.
L
Linus Torvalds 已提交
43
 */
44
int install_user_keyrings(void)
L
Linus Torvalds 已提交
45
{
D
David Howells 已提交
46 47
	struct user_struct *user;
	const struct cred *cred;
L
Linus Torvalds 已提交
48
	struct key *uid_keyring, *session_keyring;
49
	key_perm_t user_keyring_perm;
L
Linus Torvalds 已提交
50 51
	char buf[20];
	int ret;
52
	uid_t uid;
L
Linus Torvalds 已提交
53

54
	user_keyring_perm = (KEY_POS_ALL & ~KEY_POS_SETATTR) | KEY_USR_ALL;
D
David Howells 已提交
55 56
	cred = current_cred();
	user = cred->user;
57
	uid = from_kuid(cred->user_ns, user->uid);
D
David Howells 已提交
58

59
	kenter("%p{%u}", user, uid);
L
Linus Torvalds 已提交
60

61
	if (user->uid_keyring && user->session_keyring) {
62 63
		kleave(" = 0 [exist]");
		return 0;
L
Linus Torvalds 已提交
64 65
	}

66 67
	mutex_lock(&key_user_keyring_mutex);
	ret = 0;
L
Linus Torvalds 已提交
68

69 70 71 72 73
	if (!user->uid_keyring) {
		/* get the UID-specific keyring
		 * - there may be one in existence already as it may have been
		 *   pinned by a session, but the user_struct pointing to it
		 *   may have been destroyed by setuid */
74
		sprintf(buf, "_uid.%u", uid);
75 76 77

		uid_keyring = find_keyring_by_name(buf, true);
		if (IS_ERR(uid_keyring)) {
78
			uid_keyring = keyring_alloc(buf, user->uid, INVALID_GID,
79
						    cred, user_keyring_perm,
80 81
						    KEY_ALLOC_UID_KEYRING |
							KEY_ALLOC_IN_QUOTA,
82
						    NULL, NULL);
83 84 85 86 87 88 89 90
			if (IS_ERR(uid_keyring)) {
				ret = PTR_ERR(uid_keyring);
				goto error;
			}
		}

		/* get a default session keyring (which might also exist
		 * already) */
91
		sprintf(buf, "_uid_ses.%u", uid);
92 93 94 95

		session_keyring = find_keyring_by_name(buf, true);
		if (IS_ERR(session_keyring)) {
			session_keyring =
96
				keyring_alloc(buf, user->uid, INVALID_GID,
97
					      cred, user_keyring_perm,
98 99
					      KEY_ALLOC_UID_KEYRING |
						  KEY_ALLOC_IN_QUOTA,
100
					      NULL, NULL);
101 102 103 104 105 106 107 108 109 110 111 112 113 114 115
			if (IS_ERR(session_keyring)) {
				ret = PTR_ERR(session_keyring);
				goto error_release;
			}

			/* we install a link from the user session keyring to
			 * the user keyring */
			ret = key_link(session_keyring, uid_keyring);
			if (ret < 0)
				goto error_release_both;
		}

		/* install the keyrings */
		user->uid_keyring = uid_keyring;
		user->session_keyring = session_keyring;
L
Linus Torvalds 已提交
116 117
	}

118 119 120
	mutex_unlock(&key_user_keyring_mutex);
	kleave(" = 0");
	return 0;
L
Linus Torvalds 已提交
121

122 123 124 125
error_release_both:
	key_put(session_keyring);
error_release:
	key_put(uid_keyring);
126
error:
127 128
	mutex_unlock(&key_user_keyring_mutex);
	kleave(" = %d", ret);
L
Linus Torvalds 已提交
129
	return ret;
130
}
L
Linus Torvalds 已提交
131 132

/*
133 134 135 136
 * Install a thread keyring to the given credentials struct if it didn't have
 * one already.  This is allowed to overrun the quota.
 *
 * Return: 0 if a thread keyring is now present; -errno on failure.
L
Linus Torvalds 已提交
137
 */
D
David Howells 已提交
138
int install_thread_keyring_to_cred(struct cred *new)
L
Linus Torvalds 已提交
139
{
D
David Howells 已提交
140
	struct key *keyring;
L
Linus Torvalds 已提交
141

142 143 144
	if (new->thread_keyring)
		return 0;

D
David Howells 已提交
145
	keyring = keyring_alloc("_tid", new->uid, new->gid, new,
146
				KEY_POS_ALL | KEY_USR_VIEW,
147 148
				KEY_ALLOC_QUOTA_OVERRUN,
				NULL, NULL);
D
David Howells 已提交
149 150
	if (IS_ERR(keyring))
		return PTR_ERR(keyring);
L
Linus Torvalds 已提交
151

D
David Howells 已提交
152 153 154
	new->thread_keyring = keyring;
	return 0;
}
L
Linus Torvalds 已提交
155 156

/*
157 158 159
 * Install a thread keyring to the current task if it didn't have one already.
 *
 * Return: 0 if a thread keyring is now present; -errno on failure.
L
Linus Torvalds 已提交
160
 */
D
David Howells 已提交
161
static int install_thread_keyring(void)
L
Linus Torvalds 已提交
162
{
D
David Howells 已提交
163
	struct cred *new;
L
Linus Torvalds 已提交
164 165
	int ret;

D
David Howells 已提交
166 167 168
	new = prepare_creds();
	if (!new)
		return -ENOMEM;
L
Linus Torvalds 已提交
169

D
David Howells 已提交
170 171 172 173
	ret = install_thread_keyring_to_cred(new);
	if (ret < 0) {
		abort_creds(new);
		return ret;
L
Linus Torvalds 已提交
174 175
	}

D
David Howells 已提交
176 177
	return commit_creds(new);
}
L
Linus Torvalds 已提交
178

D
David Howells 已提交
179
/*
180 181
 * Install a process keyring to the given credentials struct if it didn't have
 * one already.  This is allowed to overrun the quota.
182
 *
183
 * Return: 0 if a process keyring is now present; -errno on failure.
D
David Howells 已提交
184 185 186 187
 */
int install_process_keyring_to_cred(struct cred *new)
{
	struct key *keyring;
L
Linus Torvalds 已提交
188

189
	if (new->process_keyring)
190
		return 0;
D
David Howells 已提交
191

192 193
	keyring = keyring_alloc("_pid", new->uid, new->gid, new,
				KEY_POS_ALL | KEY_USR_VIEW,
194 195
				KEY_ALLOC_QUOTA_OVERRUN,
				NULL, NULL);
D
David Howells 已提交
196 197 198
	if (IS_ERR(keyring))
		return PTR_ERR(keyring);

199 200
	new->process_keyring = keyring;
	return 0;
D
David Howells 已提交
201
}
L
Linus Torvalds 已提交
202 203

/*
204
 * Install a process keyring to the current task if it didn't have one already.
205
 *
206
 * Return: 0 if a process keyring is now present; -errno on failure.
L
Linus Torvalds 已提交
207
 */
D
David Howells 已提交
208
static int install_process_keyring(void)
L
Linus Torvalds 已提交
209
{
D
David Howells 已提交
210
	struct cred *new;
L
Linus Torvalds 已提交
211 212
	int ret;

D
David Howells 已提交
213 214 215
	new = prepare_creds();
	if (!new)
		return -ENOMEM;
L
Linus Torvalds 已提交
216

D
David Howells 已提交
217 218 219
	ret = install_process_keyring_to_cred(new);
	if (ret < 0) {
		abort_creds(new);
220
		return ret;
L
Linus Torvalds 已提交
221 222
	}

D
David Howells 已提交
223 224
	return commit_creds(new);
}
L
Linus Torvalds 已提交
225 226

/*
227 228 229 230 231
 * Install the given keyring as the session keyring of the given credentials
 * struct, replacing the existing one if any.  If the given keyring is NULL,
 * then install a new anonymous session keyring.
 *
 * Return: 0 on success; -errno on failure.
L
Linus Torvalds 已提交
232
 */
233
int install_session_keyring_to_cred(struct cred *cred, struct key *keyring)
L
Linus Torvalds 已提交
234
{
235
	unsigned long flags;
L
Linus Torvalds 已提交
236
	struct key *old;
237 238

	might_sleep();
L
Linus Torvalds 已提交
239 240 241

	/* create an empty session keyring */
	if (!keyring) {
242
		flags = KEY_ALLOC_QUOTA_OVERRUN;
243
		if (cred->session_keyring)
244 245
			flags = KEY_ALLOC_IN_QUOTA;

246 247
		keyring = keyring_alloc("_ses", cred->uid, cred->gid, cred,
					KEY_POS_ALL | KEY_USR_VIEW | KEY_USR_READ,
248
					flags, NULL, NULL);
249 250
		if (IS_ERR(keyring))
			return PTR_ERR(keyring);
D
David Howells 已提交
251
	} else {
252
		__key_get(keyring);
L
Linus Torvalds 已提交
253 254 255
	}

	/* install the keyring */
256 257 258 259
	old = cred->session_keyring;
	rcu_assign_pointer(cred->session_keyring, keyring);

	if (old)
260
		key_put(old);
L
Linus Torvalds 已提交
261

262
	return 0;
D
David Howells 已提交
263
}
L
Linus Torvalds 已提交
264 265

/*
266 267 268 269 270
 * Install the given keyring as the session keyring of the current task,
 * replacing the existing one if any.  If the given keyring is NULL, then
 * install a new anonymous session keyring.
 *
 * Return: 0 on success; -errno on failure.
L
Linus Torvalds 已提交
271
 */
D
David Howells 已提交
272
static int install_session_keyring(struct key *keyring)
L
Linus Torvalds 已提交
273
{
D
David Howells 已提交
274 275
	struct cred *new;
	int ret;
L
Linus Torvalds 已提交
276

D
David Howells 已提交
277 278 279
	new = prepare_creds();
	if (!new)
		return -ENOMEM;
L
Linus Torvalds 已提交
280

281
	ret = install_session_keyring_to_cred(new, keyring);
D
David Howells 已提交
282 283 284 285
	if (ret < 0) {
		abort_creds(new);
		return ret;
	}
L
Linus Torvalds 已提交
286

D
David Howells 已提交
287 288
	return commit_creds(new);
}
L
Linus Torvalds 已提交
289 290

/*
291
 * Handle the fsuid changing.
L
Linus Torvalds 已提交
292 293 294 295
 */
void key_fsuid_changed(struct task_struct *tsk)
{
	/* update the ownership of the thread keyring */
296 297 298 299 300
	BUG_ON(!tsk->cred);
	if (tsk->cred->thread_keyring) {
		down_write(&tsk->cred->thread_keyring->sem);
		tsk->cred->thread_keyring->uid = tsk->cred->fsuid;
		up_write(&tsk->cred->thread_keyring->sem);
L
Linus Torvalds 已提交
301
	}
302
}
L
Linus Torvalds 已提交
303 304

/*
305
 * Handle the fsgid changing.
L
Linus Torvalds 已提交
306 307 308 309
 */
void key_fsgid_changed(struct task_struct *tsk)
{
	/* update the ownership of the thread keyring */
310 311 312 313 314
	BUG_ON(!tsk->cred);
	if (tsk->cred->thread_keyring) {
		down_write(&tsk->cred->thread_keyring->sem);
		tsk->cred->thread_keyring->gid = tsk->cred->fsgid;
		up_write(&tsk->cred->thread_keyring->sem);
L
Linus Torvalds 已提交
315
	}
316
}
L
Linus Torvalds 已提交
317 318

/*
319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337
 * Search the process keyrings attached to the supplied cred for the first
 * matching key.
 *
 * The search criteria are the type and the match function.  The description is
 * given to the match function as a parameter, but doesn't otherwise influence
 * the search.  Typically the match function will compare the description
 * parameter to the key's description.
 *
 * This can only search keyrings that grant Search permission to the supplied
 * credentials.  Keyrings linked to searched keyrings will also be searched if
 * they grant Search permission too.  Keys can only be found if they grant
 * Search permission to the credentials.
 *
 * Returns a pointer to the key with the key usage count incremented if
 * successful, -EAGAIN if we didn't find any matching key or -ENOKEY if we only
 * matched negative keys.
 *
 * In the case of a successful return, the possession attribute is set on the
 * returned key reference.
L
Linus Torvalds 已提交
338
 */
339
key_ref_t search_my_process_keyrings(struct keyring_search_context *ctx)
L
Linus Torvalds 已提交
340
{
341
	key_ref_t key_ref, ret, err;
L
Linus Torvalds 已提交
342 343 344 345 346 347 348 349

	/* we want to return -EAGAIN or -ENOKEY if any of the keyrings were
	 * searchable, but we failed to find a key or we found a negative key;
	 * otherwise we want to return a sample error (probably -EACCES) if
	 * none of the keyrings were searchable
	 *
	 * in terms of priority: success > -ENOKEY > -EAGAIN > other error
	 */
350
	key_ref = NULL;
L
Linus Torvalds 已提交
351 352 353 354
	ret = NULL;
	err = ERR_PTR(-EAGAIN);

	/* search the thread keyring first */
355
	if (ctx->cred->thread_keyring) {
356
		key_ref = keyring_search_aux(
357
			make_key_ref(ctx->cred->thread_keyring, 1), ctx);
358
		if (!IS_ERR(key_ref))
L
Linus Torvalds 已提交
359 360
			goto found;

361
		switch (PTR_ERR(key_ref)) {
L
Linus Torvalds 已提交
362 363
		case -EAGAIN: /* no key */
		case -ENOKEY: /* negative key */
364
			ret = key_ref;
L
Linus Torvalds 已提交
365 366
			break;
		default:
367
			err = key_ref;
L
Linus Torvalds 已提交
368 369 370 371 372
			break;
		}
	}

	/* search the process keyring second */
373
	if (ctx->cred->process_keyring) {
374
		key_ref = keyring_search_aux(
375
			make_key_ref(ctx->cred->process_keyring, 1), ctx);
376
		if (!IS_ERR(key_ref))
L
Linus Torvalds 已提交
377 378
			goto found;

379
		switch (PTR_ERR(key_ref)) {
L
Linus Torvalds 已提交
380
		case -EAGAIN: /* no key */
381 382
			if (ret)
				break;
L
Linus Torvalds 已提交
383
		case -ENOKEY: /* negative key */
384
			ret = key_ref;
L
Linus Torvalds 已提交
385 386
			break;
		default:
387
			err = key_ref;
L
Linus Torvalds 已提交
388 389 390 391
			break;
		}
	}

392
	/* search the session keyring */
393
	if (ctx->cred->session_keyring) {
394
		rcu_read_lock();
395
		key_ref = keyring_search_aux(
396 397
			make_key_ref(rcu_dereference(ctx->cred->session_keyring), 1),
			ctx);
398
		rcu_read_unlock();
399

400
		if (!IS_ERR(key_ref))
401 402
			goto found;

403
		switch (PTR_ERR(key_ref)) {
404 405 406 407
		case -EAGAIN: /* no key */
			if (ret)
				break;
		case -ENOKEY: /* negative key */
408
			ret = key_ref;
409 410
			break;
		default:
411
			err = key_ref;
412 413
			break;
		}
414 415
	}
	/* or search the user-session keyring */
416
	else if (ctx->cred->user->session_keyring) {
417
		key_ref = keyring_search_aux(
418 419
			make_key_ref(ctx->cred->user->session_keyring, 1),
			ctx);
420
		if (!IS_ERR(key_ref))
421 422
			goto found;

423
		switch (PTR_ERR(key_ref)) {
424 425 426 427
		case -EAGAIN: /* no key */
			if (ret)
				break;
		case -ENOKEY: /* negative key */
428
			ret = key_ref;
429 430
			break;
		default:
431
			err = key_ref;
432 433
			break;
		}
434
	}
435

436 437 438 439 440 441 442 443
	/* no key - decide on the error we're going to go for */
	key_ref = ret ? ret : err;

found:
	return key_ref;
}

/*
444 445 446 447 448 449
 * Search the process keyrings attached to the supplied cred for the first
 * matching key in the manner of search_my_process_keyrings(), but also search
 * the keys attached to the assumed authorisation key using its credentials if
 * one is available.
 *
 * Return same as search_my_process_keyrings().
450
 */
451
key_ref_t search_process_keyrings(struct keyring_search_context *ctx)
452 453 454 455 456 457
{
	struct request_key_auth *rka;
	key_ref_t key_ref, ret = ERR_PTR(-EACCES), err;

	might_sleep();

458
	key_ref = search_my_process_keyrings(ctx);
459 460 461 462
	if (!IS_ERR(key_ref))
		goto found;
	err = key_ref;

463 464 465 466
	/* if this process has an instantiation authorisation key, then we also
	 * search the keyrings of the process mentioned there
	 * - we don't permit access to request_key auth keys via this method
	 */
467 468 469
	if (ctx->cred->request_key_auth &&
	    ctx->cred == current_cred() &&
	    ctx->index_key.type != &key_type_request_key_auth
470
	    ) {
471 472
		const struct cred *cred = ctx->cred;

473
		/* defend against the auth key being revoked */
474
		down_read(&cred->request_key_auth->sem);
475

476
		if (key_validate(ctx->cred->request_key_auth) == 0) {
477
			rka = ctx->cred->request_key_auth->payload.data[0];
478

479 480 481
			ctx->cred = rka->cred;
			key_ref = search_process_keyrings(ctx);
			ctx->cred = cred;
L
Linus Torvalds 已提交
482

483
			up_read(&cred->request_key_auth->sem);
484 485 486 487

			if (!IS_ERR(key_ref))
				goto found;

488
			ret = key_ref;
489
		} else {
490
			up_read(&cred->request_key_auth->sem);
491
		}
L
Linus Torvalds 已提交
492 493 494
	}

	/* no key - decide on the error we're going to go for */
495 496 497 498 499 500
	if (err == ERR_PTR(-ENOKEY) || ret == ERR_PTR(-ENOKEY))
		key_ref = ERR_PTR(-ENOKEY);
	else if (err == ERR_PTR(-EACCES))
		key_ref = ret;
	else
		key_ref = err;
L
Linus Torvalds 已提交
501

502
found:
503
	return key_ref;
504
}
L
Linus Torvalds 已提交
505

506
/*
507
 * See if the key we're looking at is the target key.
508
 */
509 510
bool lookup_user_key_possessed(const struct key *key,
			       const struct key_match_data *match_data)
511
{
D
David Howells 已提交
512
	return key == match_data->raw_data;
513
}
514

L
Linus Torvalds 已提交
515
/*
516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531
 * Look up a key ID given us by userspace with a given permissions mask to get
 * the key it refers to.
 *
 * Flags can be passed to request that special keyrings be created if referred
 * to directly, to permit partially constructed keys to be found and to skip
 * validity and permission checks on the found key.
 *
 * Returns a pointer to the key with an incremented usage count if successful;
 * -EINVAL if the key ID is invalid; -ENOKEY if the key ID does not correspond
 * to a key or the best found key was a negative key; -EKEYREVOKED or
 * -EKEYEXPIRED if the best found key was revoked or expired; -EACCES if the
 * found key doesn't grant the requested permit or the LSM denied access to it;
 * or -ENOMEM if a special keyring couldn't be created.
 *
 * In the case of a successful return, the possession attribute is set on the
 * returned key reference.
L
Linus Torvalds 已提交
532
 */
533
key_ref_t lookup_user_key(key_serial_t id, unsigned long lflags,
534
			  key_perm_t perm)
L
Linus Torvalds 已提交
535
{
536
	struct keyring_search_context ctx = {
D
David Howells 已提交
537 538 539
		.match_data.cmp		= lookup_user_key_possessed,
		.match_data.lookup_type	= KEYRING_SEARCH_LOOKUP_DIRECT,
		.flags			= KEYRING_SEARCH_NO_STATE_CHECK,
540
	};
541
	struct request_key_auth *rka;
L
Linus Torvalds 已提交
542
	struct key *key;
543
	key_ref_t key_ref, skey_ref;
L
Linus Torvalds 已提交
544 545
	int ret;

546
try_again:
547
	ctx.cred = get_current_cred();
548
	key_ref = ERR_PTR(-ENOKEY);
L
Linus Torvalds 已提交
549 550 551

	switch (id) {
	case KEY_SPEC_THREAD_KEYRING:
552
		if (!ctx.cred->thread_keyring) {
553
			if (!(lflags & KEY_LOOKUP_CREATE))
L
Linus Torvalds 已提交
554 555
				goto error;

556
			ret = install_thread_keyring();
L
Linus Torvalds 已提交
557
			if (ret < 0) {
558
				key_ref = ERR_PTR(ret);
L
Linus Torvalds 已提交
559 560
				goto error;
			}
561
			goto reget_creds;
L
Linus Torvalds 已提交
562 563
		}

564
		key = ctx.cred->thread_keyring;
565
		__key_get(key);
566
		key_ref = make_key_ref(key, 1);
L
Linus Torvalds 已提交
567 568 569
		break;

	case KEY_SPEC_PROCESS_KEYRING:
570
		if (!ctx.cred->process_keyring) {
571
			if (!(lflags & KEY_LOOKUP_CREATE))
L
Linus Torvalds 已提交
572 573
				goto error;

574
			ret = install_process_keyring();
L
Linus Torvalds 已提交
575
			if (ret < 0) {
576
				key_ref = ERR_PTR(ret);
L
Linus Torvalds 已提交
577 578
				goto error;
			}
579
			goto reget_creds;
L
Linus Torvalds 已提交
580 581
		}

582
		key = ctx.cred->process_keyring;
583
		__key_get(key);
584
		key_ref = make_key_ref(key, 1);
L
Linus Torvalds 已提交
585 586 587
		break;

	case KEY_SPEC_SESSION_KEYRING:
588
		if (!ctx.cred->session_keyring) {
L
Linus Torvalds 已提交
589 590
			/* always install a session keyring upon access if one
			 * doesn't exist yet */
591
			ret = install_user_keyrings();
592 593
			if (ret < 0)
				goto error;
594 595 596 597
			if (lflags & KEY_LOOKUP_CREATE)
				ret = join_session_keyring(NULL);
			else
				ret = install_session_keyring(
598
					ctx.cred->user->session_keyring);
D
David Howells 已提交
599

L
Linus Torvalds 已提交
600 601
			if (ret < 0)
				goto error;
602
			goto reget_creds;
603 604
		} else if (ctx.cred->session_keyring ==
			   ctx.cred->user->session_keyring &&
605 606 607 608 609
			   lflags & KEY_LOOKUP_CREATE) {
			ret = join_session_keyring(NULL);
			if (ret < 0)
				goto error;
			goto reget_creds;
L
Linus Torvalds 已提交
610 611
		}

612
		rcu_read_lock();
613
		key = rcu_dereference(ctx.cred->session_keyring);
614
		__key_get(key);
615
		rcu_read_unlock();
616
		key_ref = make_key_ref(key, 1);
L
Linus Torvalds 已提交
617 618 619
		break;

	case KEY_SPEC_USER_KEYRING:
620
		if (!ctx.cred->user->uid_keyring) {
621
			ret = install_user_keyrings();
622 623 624 625
			if (ret < 0)
				goto error;
		}

626
		key = ctx.cred->user->uid_keyring;
627
		__key_get(key);
628
		key_ref = make_key_ref(key, 1);
L
Linus Torvalds 已提交
629 630 631
		break;

	case KEY_SPEC_USER_SESSION_KEYRING:
632
		if (!ctx.cred->user->session_keyring) {
633
			ret = install_user_keyrings();
634 635 636 637
			if (ret < 0)
				goto error;
		}

638
		key = ctx.cred->user->session_keyring;
639
		__key_get(key);
640
		key_ref = make_key_ref(key, 1);
L
Linus Torvalds 已提交
641 642 643 644
		break;

	case KEY_SPEC_GROUP_KEYRING:
		/* group keyrings are not yet supported */
645
		key_ref = ERR_PTR(-EINVAL);
L
Linus Torvalds 已提交
646 647
		goto error;

648
	case KEY_SPEC_REQKEY_AUTH_KEY:
649
		key = ctx.cred->request_key_auth;
650 651 652
		if (!key)
			goto error;

653
		__key_get(key);
654 655 656
		key_ref = make_key_ref(key, 1);
		break;

657
	case KEY_SPEC_REQUESTOR_KEYRING:
658
		if (!ctx.cred->request_key_auth)
659 660
			goto error;

661
		down_read(&ctx.cred->request_key_auth->sem);
662
		if (test_bit(KEY_FLAG_REVOKED,
663
			     &ctx.cred->request_key_auth->flags)) {
664 665 666
			key_ref = ERR_PTR(-EKEYREVOKED);
			key = NULL;
		} else {
667
			rka = ctx.cred->request_key_auth->payload.data[0];
668
			key = rka->dest_keyring;
669
			__key_get(key);
670
		}
671
		up_read(&ctx.cred->request_key_auth->sem);
672 673 674 675 676
		if (!key)
			goto error;
		key_ref = make_key_ref(key, 1);
		break;

L
Linus Torvalds 已提交
677
	default:
678
		key_ref = ERR_PTR(-EINVAL);
L
Linus Torvalds 已提交
679 680 681 682
		if (id < 1)
			goto error;

		key = key_lookup(id);
683
		if (IS_ERR(key)) {
684
			key_ref = ERR_CAST(key);
L
Linus Torvalds 已提交
685
			goto error;
686 687 688 689 690
		}

		key_ref = make_key_ref(key, 0);

		/* check to see if we possess the key */
691 692 693
		ctx.index_key.type		= key->type;
		ctx.index_key.description	= key->description;
		ctx.index_key.desc_len		= strlen(key->description);
D
David Howells 已提交
694
		ctx.match_data.raw_data		= key;
695 696 697
		kdebug("check possessed");
		skey_ref = search_process_keyrings(&ctx);
		kdebug("possessed=%p", skey_ref);
698 699 700 701 702 703

		if (!IS_ERR(skey_ref)) {
			key_put(key);
			key_ref = skey_ref;
		}

L
Linus Torvalds 已提交
704 705 706
		break;
	}

707 708 709 710 711 712 713 714
	/* unlink does not use the nominated key in any way, so can skip all
	 * the permission checks as it is only concerned with the keyring */
	if (lflags & KEY_LOOKUP_FOR_UNLINK) {
		ret = 0;
		goto error;
	}

	if (!(lflags & KEY_LOOKUP_PARTIAL)) {
715 716 717 718 719 720 721 722 723 724 725
		ret = wait_for_key_construction(key, true);
		switch (ret) {
		case -ERESTARTSYS:
			goto invalid_key;
		default:
			if (perm)
				goto invalid_key;
		case 0:
			break;
		}
	} else if (perm) {
L
Linus Torvalds 已提交
726 727 728 729 730 731
		ret = key_validate(key);
		if (ret < 0)
			goto invalid_key;
	}

	ret = -EIO;
732 733
	if (!(lflags & KEY_LOOKUP_PARTIAL) &&
	    !test_bit(KEY_FLAG_INSTANTIATED, &key->flags))
L
Linus Torvalds 已提交
734 735
		goto invalid_key;

736
	/* check the permissions */
737
	ret = key_task_permission(key_ref, ctx.cred, perm);
738
	if (ret < 0)
L
Linus Torvalds 已提交
739 740
		goto invalid_key;

741 742
	key->last_used_at = current_kernel_time().tv_sec;

743
error:
744
	put_cred(ctx.cred);
745
	return key_ref;
L
Linus Torvalds 已提交
746

747 748 749
invalid_key:
	key_ref_put(key_ref);
	key_ref = ERR_PTR(ret);
L
Linus Torvalds 已提交
750 751
	goto error;

752 753 754
	/* if we attempted to install a keyring, then it may have caused new
	 * creds to be installed */
reget_creds:
755
	put_cred(ctx.cred);
756
	goto try_again;
757
}
758

L
Linus Torvalds 已提交
759
/*
760 761 762 763 764 765 766 767 768
 * Join the named keyring as the session keyring if possible else attempt to
 * create a new one of that name and join that.
 *
 * If the name is NULL, an empty anonymous keyring will be installed as the
 * session keyring.
 *
 * Named session keyrings are joined with a semaphore held to prevent the
 * keyrings from going away whilst the attempt is made to going them and also
 * to prevent a race in creating compatible session keyrings.
L
Linus Torvalds 已提交
769 770 771
 */
long join_session_keyring(const char *name)
{
D
David Howells 已提交
772 773
	const struct cred *old;
	struct cred *new;
L
Linus Torvalds 已提交
774
	struct key *keyring;
D
David Howells 已提交
775 776 777 778 779 780
	long ret, serial;

	new = prepare_creds();
	if (!new)
		return -ENOMEM;
	old = current_cred();
L
Linus Torvalds 已提交
781 782 783

	/* if no name is provided, install an anonymous keyring */
	if (!name) {
D
David Howells 已提交
784
		ret = install_session_keyring_to_cred(new, NULL);
L
Linus Torvalds 已提交
785 786 787
		if (ret < 0)
			goto error;

788
		serial = new->session_keyring->serial;
D
David Howells 已提交
789 790 791 792
		ret = commit_creds(new);
		if (ret == 0)
			ret = serial;
		goto okay;
L
Linus Torvalds 已提交
793 794 795
	}

	/* allow the user to join or create a named keyring */
I
Ingo Molnar 已提交
796
	mutex_lock(&key_session_mutex);
L
Linus Torvalds 已提交
797 798

	/* look for an existing keyring of this name */
799
	keyring = find_keyring_by_name(name, false);
L
Linus Torvalds 已提交
800 801
	if (PTR_ERR(keyring) == -ENOKEY) {
		/* not found - try and create a new one */
802 803 804
		keyring = keyring_alloc(
			name, old->uid, old->gid, old,
			KEY_POS_ALL | KEY_USR_VIEW | KEY_USR_READ | KEY_USR_LINK,
805
			KEY_ALLOC_IN_QUOTA, NULL, NULL);
L
Linus Torvalds 已提交
806 807
		if (IS_ERR(keyring)) {
			ret = PTR_ERR(keyring);
808
			goto error2;
L
Linus Torvalds 已提交
809
		}
D
David Howells 已提交
810
	} else if (IS_ERR(keyring)) {
L
Linus Torvalds 已提交
811 812
		ret = PTR_ERR(keyring);
		goto error2;
813 814
	} else if (keyring == new->session_keyring) {
		ret = 0;
815
		goto error3;
L
Linus Torvalds 已提交
816 817 818
	}

	/* we've got a keyring - now to install it */
D
David Howells 已提交
819
	ret = install_session_keyring_to_cred(new, keyring);
L
Linus Torvalds 已提交
820
	if (ret < 0)
821
		goto error3;
L
Linus Torvalds 已提交
822

D
David Howells 已提交
823 824 825
	commit_creds(new);
	mutex_unlock(&key_session_mutex);

L
Linus Torvalds 已提交
826 827
	ret = keyring->serial;
	key_put(keyring);
D
David Howells 已提交
828 829
okay:
	return ret;
L
Linus Torvalds 已提交
830

831 832
error3:
	key_put(keyring);
833
error2:
I
Ingo Molnar 已提交
834
	mutex_unlock(&key_session_mutex);
835
error:
D
David Howells 已提交
836
	abort_creds(new);
L
Linus Torvalds 已提交
837
	return ret;
D
David Howells 已提交
838
}
839 840

/*
841 842
 * Replace a process's session keyring on behalf of one of its children when
 * the target  process is about to resume userspace execution.
843
 */
844
void key_change_session_keyring(struct callback_head *twork)
845
{
846
	const struct cred *old = current_cred();
847
	struct cred *new = container_of(twork, struct cred, rcu);
848

849 850
	if (unlikely(current->flags & PF_EXITING)) {
		put_cred(new);
851
		return;
852
	}
853 854 855 856 857 858 859 860 861 862

	new->  uid	= old->  uid;
	new-> euid	= old-> euid;
	new-> suid	= old-> suid;
	new->fsuid	= old->fsuid;
	new->  gid	= old->  gid;
	new-> egid	= old-> egid;
	new-> sgid	= old-> sgid;
	new->fsgid	= old->fsgid;
	new->user	= get_uid(old->user);
863
	new->user_ns	= get_user_ns(old->user_ns);
864 865 866 867 868 869
	new->group_info	= get_group_info(old->group_info);

	new->securebits	= old->securebits;
	new->cap_inheritable	= old->cap_inheritable;
	new->cap_permitted	= old->cap_permitted;
	new->cap_effective	= old->cap_effective;
870
	new->cap_ambient	= old->cap_ambient;
871 872 873 874
	new->cap_bset		= old->cap_bset;

	new->jit_keyring	= old->jit_keyring;
	new->thread_keyring	= key_get(old->thread_keyring);
875
	new->process_keyring	= key_get(old->process_keyring);
876 877 878 879 880

	security_transfer_creds(new, old);

	commit_creds(new);
}
881 882 883 884 885 886 887 888 889 890

/*
 * Make sure that root's user and user-session keyrings exist.
 */
static int __init init_root_keyring(void)
{
	return install_user_keyrings();
}

late_initcall(init_root_keyring);