2 * Redistribution and use in source and binary forms, with or without
3 * modification, are permitted provided that the following conditions are met:
4 * * Redistributions of source code must retain the above copyright
5 * notice, this list of conditions and the following disclaimer.
6 * * Redistributions in binary form must reproduce the above copyright
7 * notice, this list of conditions and the following disclaimer in the
8 * documentation and/or other materials provided with the distribution.
9 * * Neither the name of the <organization> nor the
10 * names of its contributors may be used to endorse or promote products
11 * derived from this software without specific prior written permission.
13 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
14 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 * ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
17 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
18 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
19 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
20 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
22 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24 * Copyright (c) 2020, Felix Dörre
25 * All rights reserved.
28 #include <sys/dsl_crypt.h>
29 #include <sys/byteorder.h>
34 #include <sys/zio_crypt.h>
35 #include <openssl/evp.h>
38 #define PAM_SM_PASSWORD
39 #define PAM_SM_SESSION
40 #include <security/pam_modules.h>
42 #if defined(__linux__)
43 #include <security/pam_ext.h>
44 #define MAP_FLAGS MAP_PRIVATE | MAP_ANONYMOUS
45 #elif defined(__FreeBSD__)
46 #include <security/pam_appl.h>
48 pam_syslog(pam_handle_t
*pamh
, int loglevel
, const char *fmt
, ...)
53 vsyslog(loglevel
, fmt
, args
);
56 #define MAP_FLAGS MAP_PRIVATE | MAP_ANON | MAP_NOCORE
69 static const char PASSWORD_VAR_NAME
[] = "pam_zfs_key_authtok";
71 static libzfs_handle_t
*g_zfs
;
73 static void destroy_pw(pam_handle_t
*pamh
, void *data
, int errcode
);
75 typedef int (*mlock_func_t
) (const void *, size_t);
83 * Try to mlock(2) or munlock(2) addr while handling EAGAIN by retrying ten
84 * times and sleeping 10 milliseconds in between for a total of 0.1
85 * seconds. lock_func must point to either mlock(2) or munlock(2).
88 try_lock(mlock_func_t lock_func
, const void *addr
, size_t len
)
92 useconds_t sleep_dur
= 10 * 1000;
94 if ((err
= (*lock_func
)(addr
, len
)) != EAGAIN
) {
97 for (int i
= retries
; i
> 0; --i
) {
98 (void) usleep(sleep_dur
);
99 if ((err
= (*lock_func
)(addr
, len
)) != EAGAIN
) {
107 static pw_password_t
*
108 alloc_pw_size(size_t len
)
110 pw_password_t
*pw
= malloc(sizeof (pw_password_t
));
116 * We use mmap(2) rather than malloc(3) since later on we mlock(2) the
117 * memory region. Since mlock(2) and munlock(2) operate on whole memory
118 * pages we should allocate a whole page here as mmap(2) does. Further
119 * this ensures that the addresses passed to mlock(2) an munlock(2) are
120 * on a page boundary as suggested by FreeBSD and required by some
121 * other implementations. Finally we avoid inadvertently munlocking
122 * memory mlocked by an concurrently running instance of us.
124 pw
->value
= mmap(NULL
, pw
->len
, PROT_READ
| PROT_WRITE
, MAP_FLAGS
,
127 if (pw
->value
== MAP_FAILED
) {
131 if (try_lock(mlock
, pw
->value
, pw
->len
) != 0) {
132 (void) munmap(pw
->value
, pw
->len
);
139 static pw_password_t
*
140 alloc_pw_string(const char *source
)
142 size_t len
= strlen(source
) + 1;
143 pw_password_t
*pw
= alloc_pw_size(len
);
148 memcpy(pw
->value
, source
, pw
->len
);
153 pw_free(pw_password_t
*pw
)
155 memset(pw
->value
, 0, pw
->len
);
156 if (try_lock(munlock
, pw
->value
, pw
->len
) == 0) {
157 (void) munmap(pw
->value
, pw
->len
);
162 static pw_password_t
*
163 pw_fetch(pam_handle_t
*pamh
)
166 if (pam_get_authtok(pamh
, PAM_AUTHTOK
, &token
, NULL
) != PAM_SUCCESS
) {
167 pam_syslog(pamh
, LOG_ERR
,
168 "couldn't get password from PAM stack");
172 pam_syslog(pamh
, LOG_ERR
,
173 "token from PAM stack is null");
176 return (alloc_pw_string(token
));
179 static const pw_password_t
*
180 pw_fetch_lazy(pam_handle_t
*pamh
)
182 pw_password_t
*pw
= pw_fetch(pamh
);
186 int ret
= pam_set_data(pamh
, PASSWORD_VAR_NAME
, pw
, destroy_pw
);
187 if (ret
!= PAM_SUCCESS
) {
189 pam_syslog(pamh
, LOG_ERR
, "pam_set_data failed");
195 static const pw_password_t
*
196 pw_get(pam_handle_t
*pamh
)
198 const pw_password_t
*authtok
= NULL
;
199 int ret
= pam_get_data(pamh
, PASSWORD_VAR_NAME
,
200 (const void**)(&authtok
));
201 if (ret
== PAM_SUCCESS
)
203 if (ret
== PAM_NO_MODULE_DATA
)
204 return (pw_fetch_lazy(pamh
));
205 pam_syslog(pamh
, LOG_ERR
, "password not available");
210 pw_clear(pam_handle_t
*pamh
)
212 int ret
= pam_set_data(pamh
, PASSWORD_VAR_NAME
, NULL
, NULL
);
213 if (ret
!= PAM_SUCCESS
) {
214 pam_syslog(pamh
, LOG_ERR
, "clearing password failed");
221 destroy_pw(pam_handle_t
*pamh
, void *data
, int errcode
)
223 (void) pamh
, (void) errcode
;
226 pw_free((pw_password_t
*)data
);
231 pam_zfs_init(pam_handle_t
*pamh
)
234 if ((g_zfs
= libzfs_init()) == NULL
) {
236 pam_syslog(pamh
, LOG_ERR
, "Zfs initialization error: %s",
237 libzfs_error_init(error
));
248 static pw_password_t
*
249 prepare_passphrase(pam_handle_t
*pamh
, zfs_handle_t
*ds
,
250 const char *passphrase
, nvlist_t
*nvlist
)
252 pw_password_t
*key
= alloc_pw_size(WRAPPING_KEY_LEN
);
258 if (nvlist
!= NULL
) {
259 int fd
= open("/dev/urandom", O_RDONLY
);
265 char *buf
= (char *)&salt
;
266 size_t bytes
= sizeof (uint64_t);
267 while (bytes_read
< bytes
) {
268 ssize_t len
= read(fd
, buf
+ bytes_read
, bytes
279 if (nvlist_add_uint64(nvlist
,
280 zfs_prop_to_name(ZFS_PROP_PBKDF2_SALT
), salt
)) {
281 pam_syslog(pamh
, LOG_ERR
,
282 "failed to add salt to nvlist");
286 iters
= DEFAULT_PBKDF2_ITERATIONS
;
287 if (nvlist_add_uint64(nvlist
, zfs_prop_to_name(
288 ZFS_PROP_PBKDF2_ITERS
), iters
)) {
289 pam_syslog(pamh
, LOG_ERR
,
290 "failed to add iters to nvlist");
295 salt
= zfs_prop_get_int(ds
, ZFS_PROP_PBKDF2_SALT
);
296 iters
= zfs_prop_get_int(ds
, ZFS_PROP_PBKDF2_ITERS
);
300 if (!PKCS5_PBKDF2_HMAC_SHA1((char *)passphrase
,
301 strlen(passphrase
), (uint8_t *)&salt
,
302 sizeof (uint64_t), iters
, WRAPPING_KEY_LEN
,
303 (uint8_t *)key
->value
)) {
304 pam_syslog(pamh
, LOG_ERR
, "pbkdf failed");
312 is_key_loaded(pam_handle_t
*pamh
, const char *ds_name
)
314 zfs_handle_t
*ds
= zfs_open(g_zfs
, ds_name
, ZFS_TYPE_FILESYSTEM
);
316 pam_syslog(pamh
, LOG_ERR
, "dataset %s not found", ds_name
);
319 int keystatus
= zfs_prop_get_int(ds
, ZFS_PROP_KEYSTATUS
);
321 return (keystatus
!= ZFS_KEYSTATUS_UNAVAILABLE
);
325 change_key(pam_handle_t
*pamh
, const char *ds_name
,
326 const char *passphrase
)
328 zfs_handle_t
*ds
= zfs_open(g_zfs
, ds_name
, ZFS_TYPE_FILESYSTEM
);
330 pam_syslog(pamh
, LOG_ERR
, "dataset %s not found", ds_name
);
333 nvlist_t
*nvlist
= fnvlist_alloc();
334 pw_password_t
*key
= prepare_passphrase(pamh
, ds
, passphrase
, nvlist
);
340 if (nvlist_add_string(nvlist
,
341 zfs_prop_to_name(ZFS_PROP_KEYLOCATION
),
343 pam_syslog(pamh
, LOG_ERR
, "nvlist_add failed for keylocation");
349 if (nvlist_add_uint64(nvlist
,
350 zfs_prop_to_name(ZFS_PROP_KEYFORMAT
),
351 ZFS_KEYFORMAT_PASSPHRASE
)) {
352 pam_syslog(pamh
, LOG_ERR
, "nvlist_add failed for keyformat");
358 int ret
= lzc_change_key(ds_name
, DCP_CMD_NEW_KEY
, nvlist
,
359 (uint8_t *)key
->value
, WRAPPING_KEY_LEN
);
362 pam_syslog(pamh
, LOG_ERR
, "change_key failed: %d", ret
);
373 decrypt_mount(pam_handle_t
*pamh
, const char *ds_name
,
374 const char *passphrase
)
376 zfs_handle_t
*ds
= zfs_open(g_zfs
, ds_name
, ZFS_TYPE_FILESYSTEM
);
378 pam_syslog(pamh
, LOG_ERR
, "dataset %s not found", ds_name
);
381 pw_password_t
*key
= prepare_passphrase(pamh
, ds
, passphrase
, NULL
);
386 int ret
= lzc_load_key(ds_name
, B_FALSE
, (uint8_t *)key
->value
,
390 pam_syslog(pamh
, LOG_ERR
, "load_key failed: %d", ret
);
394 ret
= zfs_mount(ds
, NULL
, 0);
396 pam_syslog(pamh
, LOG_ERR
, "mount failed: %d", ret
);
405 unmount_unload(pam_handle_t
*pamh
, const char *ds_name
)
407 zfs_handle_t
*ds
= zfs_open(g_zfs
, ds_name
, ZFS_TYPE_FILESYSTEM
);
409 pam_syslog(pamh
, LOG_ERR
, "dataset %s not found", ds_name
);
412 int ret
= zfs_unmount(ds
, NULL
, 0);
414 pam_syslog(pamh
, LOG_ERR
, "zfs_unmount failed with: %d", ret
);
419 ret
= lzc_unload_key(ds_name
);
421 pam_syslog(pamh
, LOG_ERR
, "unload_key failed with: %d", ret
);
435 const char *username
;
436 int unmount_and_unload
;
440 zfs_key_config_load(pam_handle_t
*pamh
, zfs_key_config_t
*config
,
441 int argc
, const char **argv
)
443 config
->homes_prefix
= strdup("rpool/home");
444 if (config
->homes_prefix
== NULL
) {
445 pam_syslog(pamh
, LOG_ERR
, "strdup failure");
448 config
->runstatedir
= strdup(RUNSTATEDIR
"/pam_zfs_key");
449 if (config
->runstatedir
== NULL
) {
450 pam_syslog(pamh
, LOG_ERR
, "strdup failure");
451 free(config
->homes_prefix
);
455 if (pam_get_user(pamh
, &name
, NULL
) != PAM_SUCCESS
) {
456 pam_syslog(pamh
, LOG_ERR
,
457 "couldn't get username from PAM stack");
458 free(config
->runstatedir
);
459 free(config
->homes_prefix
);
462 struct passwd
*entry
= getpwnam(name
);
464 free(config
->runstatedir
);
465 free(config
->homes_prefix
);
468 config
->uid
= entry
->pw_uid
;
469 config
->username
= name
;
470 config
->unmount_and_unload
= 1;
471 config
->dsname
= NULL
;
472 config
->homedir
= NULL
;
473 for (int c
= 0; c
< argc
; c
++) {
474 if (strncmp(argv
[c
], "homes=", 6) == 0) {
475 free(config
->homes_prefix
);
476 config
->homes_prefix
= strdup(argv
[c
] + 6);
477 } else if (strncmp(argv
[c
], "runstatedir=", 12) == 0) {
478 free(config
->runstatedir
);
479 config
->runstatedir
= strdup(argv
[c
] + 12);
480 } else if (strcmp(argv
[c
], "nounmount") == 0) {
481 config
->unmount_and_unload
= 0;
482 } else if (strcmp(argv
[c
], "prop_mountpoint") == 0) {
483 if (config
->homedir
== NULL
)
484 config
->homedir
= strdup(entry
->pw_dir
);
491 zfs_key_config_free(zfs_key_config_t
*config
)
493 free(config
->homes_prefix
);
494 free(config
->runstatedir
);
495 free(config
->homedir
);
496 free(config
->dsname
);
500 find_dsname_by_prop_value(zfs_handle_t
*zhp
, void *data
)
502 zfs_type_t type
= zfs_get_type(zhp
);
503 zfs_key_config_t
*target
= data
;
504 char mountpoint
[ZFS_MAXPROPLEN
];
506 /* Skip any datasets whose type does not match */
507 if ((type
& ZFS_TYPE_FILESYSTEM
) == 0) {
512 /* Skip any datasets whose mountpoint does not match */
513 (void) zfs_prop_get(zhp
, ZFS_PROP_MOUNTPOINT
, mountpoint
,
514 sizeof (mountpoint
), NULL
, NULL
, 0, B_FALSE
);
515 if (strcmp(target
->homedir
, mountpoint
) != 0) {
520 target
->dsname
= strdup(zfs_get_name(zhp
));
526 zfs_key_config_get_dataset(zfs_key_config_t
*config
)
528 if (config
->homedir
!= NULL
&&
529 config
->homes_prefix
!= NULL
) {
530 zfs_handle_t
*zhp
= zfs_open(g_zfs
, config
->homes_prefix
,
531 ZFS_TYPE_FILESYSTEM
);
533 pam_syslog(NULL
, LOG_ERR
, "dataset %s not found",
534 config
->homes_prefix
);
538 (void) zfs_iter_filesystems_v2(zhp
, 0,
539 find_dsname_by_prop_value
, config
);
541 char *dsname
= config
->dsname
;
542 config
->dsname
= NULL
;
546 if (config
->homes_prefix
== NULL
) {
550 size_t len
= ZFS_MAX_DATASET_NAME_LEN
;
551 size_t total_len
= strlen(config
->homes_prefix
) + 1
552 + strlen(config
->username
);
553 if (total_len
> len
) {
556 char *ret
= malloc(len
+ 1);
561 (void) snprintf(ret
, len
+ 1, "%s/%s", config
->homes_prefix
,
567 zfs_key_config_modify_session_counter(pam_handle_t
*pamh
,
568 zfs_key_config_t
*config
, int delta
)
570 const char *runtime_path
= config
->runstatedir
;
571 if (mkdir(runtime_path
, S_IRWXU
) != 0 && errno
!= EEXIST
) {
572 pam_syslog(pamh
, LOG_ERR
, "Can't create runtime path: %d",
576 if (chown(runtime_path
, 0, 0) != 0) {
577 pam_syslog(pamh
, LOG_ERR
, "Can't chown runtime path: %d",
581 if (chmod(runtime_path
, S_IRWXU
) != 0) {
582 pam_syslog(pamh
, LOG_ERR
, "Can't chmod runtime path: %d",
586 size_t runtime_path_len
= strlen(runtime_path
);
587 size_t counter_path_len
= runtime_path_len
+ 1 + 10;
588 char *counter_path
= malloc(counter_path_len
+ 1);
593 strcat(counter_path
, runtime_path
);
594 snprintf(counter_path
+ runtime_path_len
, counter_path_len
, "/%d",
596 const int fd
= open(counter_path
,
597 O_RDWR
| O_CLOEXEC
| O_CREAT
| O_NOFOLLOW
,
601 pam_syslog(pamh
, LOG_ERR
, "Can't open counter file: %d", errno
);
604 if (flock(fd
, LOCK_EX
) != 0) {
605 pam_syslog(pamh
, LOG_ERR
, "Can't lock counter file: %d", errno
);
611 int remaining
= sizeof (counter
) - 1;
613 counter
[sizeof (counter
) - 1] = 0;
614 while (remaining
> 0 && (ret
= read(fd
, pos
, remaining
)) > 0) {
619 long int counter_value
= strtol(counter
, NULL
, 10);
620 counter_value
+= delta
;
621 if (counter_value
< 0) {
624 lseek(fd
, 0, SEEK_SET
);
625 if (ftruncate(fd
, 0) != 0) {
626 pam_syslog(pamh
, LOG_ERR
, "Can't truncate counter file: %d",
631 snprintf(counter
, sizeof (counter
), "%ld", counter_value
);
632 remaining
= strlen(counter
);
634 while (remaining
> 0 && (ret
= write(fd
, pos
, remaining
)) > 0) {
639 return (counter_value
);
642 __attribute__((visibility("default")))
644 pam_sm_authenticate(pam_handle_t
*pamh
, int flags
,
645 int argc
, const char **argv
)
647 (void) flags
, (void) argc
, (void) argv
;
649 if (pw_fetch_lazy(pamh
) == NULL
) {
650 return (PAM_AUTH_ERR
);
653 return (PAM_SUCCESS
);
656 __attribute__((visibility("default")))
658 pam_sm_setcred(pam_handle_t
*pamh
, int flags
,
659 int argc
, const char **argv
)
661 (void) pamh
, (void) flags
, (void) argc
, (void) argv
;
662 return (PAM_SUCCESS
);
665 __attribute__((visibility("default")))
667 pam_sm_chauthtok(pam_handle_t
*pamh
, int flags
,
668 int argc
, const char **argv
)
670 if (geteuid() != 0) {
671 pam_syslog(pamh
, LOG_ERR
,
672 "Cannot zfs_mount when not being root.");
673 return (PAM_PERM_DENIED
);
675 zfs_key_config_t config
;
676 if (zfs_key_config_load(pamh
, &config
, argc
, argv
) == -1) {
677 return (PAM_SERVICE_ERR
);
679 if (config
.uid
< 1000) {
680 zfs_key_config_free(&config
);
681 return (PAM_SUCCESS
);
684 if (pam_zfs_init(pamh
) != 0) {
685 zfs_key_config_free(&config
);
686 return (PAM_SERVICE_ERR
);
688 char *dataset
= zfs_key_config_get_dataset(&config
);
691 zfs_key_config_free(&config
);
692 return (PAM_SERVICE_ERR
);
694 int key_loaded
= is_key_loaded(pamh
, dataset
);
695 if (key_loaded
== -1) {
698 zfs_key_config_free(&config
);
699 return (PAM_SERVICE_ERR
);
704 pam_syslog(pamh
, LOG_ERR
,
705 "key not loaded, returning try_again");
706 zfs_key_config_free(&config
);
707 return (PAM_PERM_DENIED
);
711 if ((flags
& PAM_UPDATE_AUTHTOK
) != 0) {
712 const pw_password_t
*token
= pw_get(pamh
);
714 zfs_key_config_free(&config
);
715 return (PAM_SERVICE_ERR
);
717 if (pam_zfs_init(pamh
) != 0) {
718 zfs_key_config_free(&config
);
719 return (PAM_SERVICE_ERR
);
721 char *dataset
= zfs_key_config_get_dataset(&config
);
724 zfs_key_config_free(&config
);
725 return (PAM_SERVICE_ERR
);
727 if (change_key(pamh
, dataset
, token
->value
) == -1) {
730 zfs_key_config_free(&config
);
731 return (PAM_SERVICE_ERR
);
735 zfs_key_config_free(&config
);
736 if (pw_clear(pamh
) == -1) {
737 return (PAM_SERVICE_ERR
);
740 zfs_key_config_free(&config
);
742 return (PAM_SUCCESS
);
746 pam_sm_open_session(pam_handle_t
*pamh
, int flags
,
747 int argc
, const char **argv
)
751 if (geteuid() != 0) {
752 pam_syslog(pamh
, LOG_ERR
,
753 "Cannot zfs_mount when not being root.");
754 return (PAM_SUCCESS
);
756 zfs_key_config_t config
;
757 if (zfs_key_config_load(pamh
, &config
, argc
, argv
) != 0) {
758 return (PAM_SESSION_ERR
);
761 if (config
.uid
< 1000) {
762 zfs_key_config_free(&config
);
763 return (PAM_SUCCESS
);
766 int counter
= zfs_key_config_modify_session_counter(pamh
, &config
, 1);
768 zfs_key_config_free(&config
);
769 return (PAM_SUCCESS
);
772 const pw_password_t
*token
= pw_get(pamh
);
774 zfs_key_config_free(&config
);
775 return (PAM_SESSION_ERR
);
777 if (pam_zfs_init(pamh
) != 0) {
778 zfs_key_config_free(&config
);
779 return (PAM_SERVICE_ERR
);
781 char *dataset
= zfs_key_config_get_dataset(&config
);
784 zfs_key_config_free(&config
);
785 return (PAM_SERVICE_ERR
);
787 if (decrypt_mount(pamh
, dataset
, token
->value
) == -1) {
790 zfs_key_config_free(&config
);
791 return (PAM_SERVICE_ERR
);
795 zfs_key_config_free(&config
);
796 if (pw_clear(pamh
) == -1) {
797 return (PAM_SERVICE_ERR
);
799 return (PAM_SUCCESS
);
803 __attribute__((visibility("default")))
805 pam_sm_close_session(pam_handle_t
*pamh
, int flags
,
806 int argc
, const char **argv
)
810 if (geteuid() != 0) {
811 pam_syslog(pamh
, LOG_ERR
,
812 "Cannot zfs_mount when not being root.");
813 return (PAM_SUCCESS
);
815 zfs_key_config_t config
;
816 if (zfs_key_config_load(pamh
, &config
, argc
, argv
) != 0) {
817 return (PAM_SESSION_ERR
);
819 if (config
.uid
< 1000) {
820 zfs_key_config_free(&config
);
821 return (PAM_SUCCESS
);
824 int counter
= zfs_key_config_modify_session_counter(pamh
, &config
, -1);
826 zfs_key_config_free(&config
);
827 return (PAM_SUCCESS
);
830 if (config
.unmount_and_unload
) {
831 if (pam_zfs_init(pamh
) != 0) {
832 zfs_key_config_free(&config
);
833 return (PAM_SERVICE_ERR
);
835 char *dataset
= zfs_key_config_get_dataset(&config
);
838 zfs_key_config_free(&config
);
839 return (PAM_SESSION_ERR
);
841 if (unmount_unload(pamh
, dataset
) == -1) {
844 zfs_key_config_free(&config
);
845 return (PAM_SESSION_ERR
);
851 zfs_key_config_free(&config
);
852 return (PAM_SUCCESS
);