1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
5 #include "ask-password-api.h"
6 #include "dlfcn-util.h"
10 #include "format-table.h"
12 #include "memory-util.h"
14 #include "openssl-util.h"
16 #include "pkcs11-util.h"
17 #include "random-util.h"
18 #include "string-util.h"
21 bool pkcs11_uri_valid(const char *uri
) {
24 /* A very superficial checker for RFC7512 PKCS#11 URI syntax */
29 p
= startswith(uri
, "pkcs11:");
36 if (!in_charset(p
, ALPHANUMERICAL
".~/-_?;&%="))
44 static void *p11kit_dl
= NULL
;
46 char *(*sym_p11_kit_module_get_name
)(CK_FUNCTION_LIST
*module
);
47 void (*sym_p11_kit_modules_finalize_and_release
)(CK_FUNCTION_LIST
**modules
);
48 CK_FUNCTION_LIST
**(*sym_p11_kit_modules_load_and_initialize
)(int flags
);
49 const char *(*sym_p11_kit_strerror
)(CK_RV rv
);
50 int (*sym_p11_kit_uri_format
)(P11KitUri
*uri
, P11KitUriType uri_type
, char **string
);
51 void (*sym_p11_kit_uri_free
)(P11KitUri
*uri
);
52 CK_ATTRIBUTE_PTR (*sym_p11_kit_uri_get_attributes
)(P11KitUri
*uri
, CK_ULONG
*n_attrs
);
53 CK_INFO_PTR (*sym_p11_kit_uri_get_module_info
)(P11KitUri
*uri
);
54 CK_SLOT_INFO_PTR (*sym_p11_kit_uri_get_slot_info
)(P11KitUri
*uri
);
55 CK_TOKEN_INFO_PTR (*sym_p11_kit_uri_get_token_info
)(P11KitUri
*uri
);
56 int (*sym_p11_kit_uri_match_token_info
)(const P11KitUri
*uri
, const CK_TOKEN_INFO
*token_info
);
57 const char *(*sym_p11_kit_uri_message
)(int code
);
58 P11KitUri
*(*sym_p11_kit_uri_new
)(void);
59 int (*sym_p11_kit_uri_parse
)(const char *string
, P11KitUriType uri_type
, P11KitUri
*uri
);
61 int dlopen_p11kit(void) {
62 return dlopen_many_sym_or_warn(
64 "libp11-kit.so.0", LOG_DEBUG
,
65 DLSYM_ARG(p11_kit_module_get_name
),
66 DLSYM_ARG(p11_kit_modules_finalize_and_release
),
67 DLSYM_ARG(p11_kit_modules_load_and_initialize
),
68 DLSYM_ARG(p11_kit_strerror
),
69 DLSYM_ARG(p11_kit_uri_format
),
70 DLSYM_ARG(p11_kit_uri_free
),
71 DLSYM_ARG(p11_kit_uri_get_attributes
),
72 DLSYM_ARG(p11_kit_uri_get_module_info
),
73 DLSYM_ARG(p11_kit_uri_get_slot_info
),
74 DLSYM_ARG(p11_kit_uri_get_token_info
),
75 DLSYM_ARG(p11_kit_uri_match_token_info
),
76 DLSYM_ARG(p11_kit_uri_message
),
77 DLSYM_ARG(p11_kit_uri_new
),
78 DLSYM_ARG(p11_kit_uri_parse
));
81 int uri_from_string(const char *p
, P11KitUri
**ret
) {
82 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
*uri
= NULL
;
92 uri
= sym_p11_kit_uri_new();
96 if (sym_p11_kit_uri_parse(p
, P11_KIT_URI_FOR_ANY
, uri
) != P11_KIT_URI_OK
)
103 P11KitUri
*uri_from_module_info(const CK_INFO
*info
) {
108 if (dlopen_p11kit() < 0)
111 uri
= sym_p11_kit_uri_new();
115 *sym_p11_kit_uri_get_module_info(uri
) = *info
;
119 P11KitUri
*uri_from_slot_info(const CK_SLOT_INFO
*slot_info
) {
124 if (dlopen_p11kit() < 0)
127 uri
= sym_p11_kit_uri_new();
131 *sym_p11_kit_uri_get_slot_info(uri
) = *slot_info
;
135 P11KitUri
*uri_from_token_info(const CK_TOKEN_INFO
*token_info
) {
140 if (dlopen_p11kit() < 0)
143 uri
= sym_p11_kit_uri_new();
147 *sym_p11_kit_uri_get_token_info(uri
) = *token_info
;
151 CK_RV
pkcs11_get_slot_list_malloc(
153 CK_SLOT_ID
**ret_slotids
,
154 CK_ULONG
*ret_n_slotids
) {
160 assert(ret_n_slotids
);
162 for (unsigned tries
= 0; tries
< 16; tries
++) {
163 _cleanup_free_ CK_SLOT_ID
*slotids
= NULL
;
164 CK_ULONG n_slotids
= 0;
166 rv
= m
->C_GetSlotList(0, NULL
, &n_slotids
);
169 if (n_slotids
== 0) {
175 slotids
= new(CK_SLOT_ID
, n_slotids
);
177 return CKR_HOST_MEMORY
;
179 rv
= m
->C_GetSlotList(0, slotids
, &n_slotids
);
181 *ret_slotids
= TAKE_PTR(slotids
);
182 *ret_n_slotids
= n_slotids
;
186 if (rv
!= CKR_BUFFER_TOO_SMALL
)
189 /* Hu? Maybe somebody plugged something in and things changed? Let's try again */
192 return CKR_BUFFER_TOO_SMALL
;
195 char *pkcs11_token_label(const CK_TOKEN_INFO
*token_info
) {
198 /* The label is not NUL terminated and likely padded with spaces, let's make a copy here, so that we
200 t
= strndup((char*) token_info
->label
, sizeof(token_info
->label
));
208 char *pkcs11_token_manufacturer_id(const CK_TOKEN_INFO
*token_info
) {
211 t
= strndup((char*) token_info
->manufacturerID
, sizeof(token_info
->manufacturerID
));
219 char *pkcs11_token_model(const CK_TOKEN_INFO
*token_info
) {
222 t
= strndup((char*) token_info
->model
, sizeof(token_info
->model
));
230 int pkcs11_token_login_by_pin(
232 CK_SESSION_HANDLE session
,
233 const CK_TOKEN_INFO
*token_info
,
234 const char *token_label
,
248 if (FLAGS_SET(token_info
->flags
, CKF_PROTECTED_AUTHENTICATION_PATH
)) {
249 rv
= m
->C_Login(session
, CKU_USER
, NULL
, 0);
251 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
252 "Failed to log into security token '%s': %s", token_label
, sym_p11_kit_strerror(rv
));
254 log_info("Successfully logged into security token '%s' via protected authentication path.", token_label
);
258 if (!FLAGS_SET(token_info
->flags
, CKF_LOGIN_REQUIRED
)) {
259 log_info("No login into security token '%s' required.", token_label
);
266 rv
= m
->C_Login(session
, CKU_USER
, (CK_UTF8CHAR
*) pin
, pin_size
);
268 log_info("Successfully logged into security token '%s'.", token_label
);
272 if (rv
== CKR_PIN_LOCKED
)
273 return log_error_errno(SYNTHETIC_ERRNO(EPERM
),
274 "PIN has been locked, please reset PIN of security token '%s'.", token_label
);
275 if (!IN_SET(rv
, CKR_PIN_INCORRECT
, CKR_PIN_LEN_RANGE
))
276 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
277 "Failed to log into security token '%s': %s", token_label
, sym_p11_kit_strerror(rv
));
279 return log_notice_errno(SYNTHETIC_ERRNO(ENOLCK
),
280 "PIN for token '%s' is incorrect, please try again.",
284 int pkcs11_token_login(
286 CK_SESSION_HANDLE session
,
288 const CK_TOKEN_INFO
*token_info
,
289 const char *friendly_name
,
290 const char *icon_name
,
291 const char *key_name
,
292 const char *credential_name
,
294 AskPasswordFlags ask_password_flags
,
296 char **ret_used_pin
) {
298 _cleanup_free_
char *token_uri_string
= NULL
, *token_uri_escaped
= NULL
, *id
= NULL
, *token_label
= NULL
;
299 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
*token_uri
= NULL
;
300 CK_TOKEN_INFO updated_token_info
;
311 token_label
= pkcs11_token_label(token_info
);
315 token_uri
= uri_from_token_info(token_info
);
319 uri_result
= sym_p11_kit_uri_format(token_uri
, P11_KIT_URI_FOR_ANY
, &token_uri_string
);
320 if (uri_result
!= P11_KIT_URI_OK
)
321 return log_warning_errno(SYNTHETIC_ERRNO(EAGAIN
), "Failed to format slot URI: %s", sym_p11_kit_uri_message(uri_result
));
323 r
= pkcs11_token_login_by_pin(m
, session
, token_info
, token_label
, /* pin= */ NULL
, 0);
324 if (r
== 0 && ret_used_pin
)
325 *ret_used_pin
= NULL
;
327 if (r
!= -ENOANO
) /* pin required */
330 token_uri_escaped
= cescape(token_uri_string
);
331 if (!token_uri_escaped
)
334 id
= strjoin("pkcs11:", token_uri_escaped
);
338 for (unsigned tries
= 0; tries
< 3; tries
++) {
339 _cleanup_strv_free_erase_
char **passwords
= NULL
;
340 _cleanup_(erase_and_freep
) char *envpin
= NULL
;
342 r
= getenv_steal_erase("PIN", &envpin
);
344 return log_error_errno(r
, "Failed to acquire PIN from environment: %m");
346 passwords
= strv_new(envpin
);
351 return log_error_errno(SYNTHETIC_ERRNO(ENOPKG
), "PIN querying disabled via 'headless' option. Use the 'PIN' environment variable.");
353 _cleanup_free_
char *text
= NULL
;
355 if (FLAGS_SET(token_info
->flags
, CKF_USER_PIN_FINAL_TRY
))
357 "Please enter correct PIN for security token '%s' in order to unlock %s (final try):",
358 token_label
, friendly_name
);
359 else if (FLAGS_SET(token_info
->flags
, CKF_USER_PIN_COUNT_LOW
))
361 "PIN has been entered incorrectly previously, please enter correct PIN for security token '%s' in order to unlock %s:",
362 token_label
, friendly_name
);
365 "Please enter PIN for security token '%s' in order to unlock %s:",
366 token_label
, friendly_name
);
369 "Please enter PIN for security token '%s' in order to unlock %s (try #%u):",
370 token_label
, friendly_name
, tries
+1);
374 /* We never cache PINs, simply because it's fatal if we use wrong PINs, since usually there are only 3 tries */
375 r
= ask_password_auto(text
, icon_name
, id
, key_name
, credential_name
, until
, ask_password_flags
, &passwords
);
377 return log_error_errno(r
, "Failed to query PIN for security token '%s': %m", token_label
);
380 STRV_FOREACH(i
, passwords
) {
381 r
= pkcs11_token_login_by_pin(m
, session
, token_info
, token_label
, *i
, strlen(*i
));
382 if (r
== 0 && ret_used_pin
) {
395 /* Refresh the token info, so that we can prompt knowing the new flags if they changed. */
396 rv
= m
->C_GetTokenInfo(slotid
, &updated_token_info
);
398 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
399 "Failed to acquire updated security token information for slot %lu: %s",
400 slotid
, sym_p11_kit_strerror(rv
));
402 token_info
= &updated_token_info
;
406 return log_error_errno(SYNTHETIC_ERRNO(EPERM
), "Too many attempts to log into token '%s'.", token_label
);
409 int pkcs11_token_find_x509_certificate(
411 CK_SESSION_HANDLE session
,
412 P11KitUri
*search_uri
,
413 CK_OBJECT_HANDLE
*ret_object
) {
415 bool found_class
= false, found_certificate_type
= false;
416 _cleanup_free_ CK_ATTRIBUTE
*attributes_buffer
= NULL
;
417 CK_ULONG n_attributes
, a
, n_objects
;
418 CK_ATTRIBUTE
*attributes
= NULL
;
419 CK_OBJECT_HANDLE objects
[2];
431 attributes
= sym_p11_kit_uri_get_attributes(search_uri
, &n_attributes
);
432 for (a
= 0; a
< n_attributes
; a
++) {
434 /* We use the URI's included match attributes, but make them more strict. This allows users
435 * to specify a token URL instead of an object URL and the right thing should happen if
436 * there's only one suitable key on the token. */
438 switch (attributes
[a
].type
) {
443 if (attributes
[a
].ulValueLen
!= sizeof(c
))
444 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Invalid PKCS#11 CKA_CLASS attribute size.");
446 memcpy(&c
, attributes
[a
].pValue
, sizeof(c
));
447 if (c
!= CKO_CERTIFICATE
)
448 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Selected PKCS#11 object is not an X.509 certificate, refusing.");
454 case CKA_CERTIFICATE_TYPE
: {
455 CK_CERTIFICATE_TYPE t
;
457 if (attributes
[a
].ulValueLen
!= sizeof(t
))
458 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Invalid PKCS#11 CKA_CERTIFICATE_TYPE attribute size.");
460 memcpy(&t
, attributes
[a
].pValue
, sizeof(t
));
462 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Selected PKCS#11 object is not an X.509 certificate, refusing.");
464 found_certificate_type
= true;
469 if (!found_class
|| !found_certificate_type
) {
470 /* Hmm, let's slightly extend the attribute list we search for */
472 attributes_buffer
= new(CK_ATTRIBUTE
, n_attributes
+ !found_class
+ !found_certificate_type
);
473 if (!attributes_buffer
)
476 memcpy(attributes_buffer
, attributes
, sizeof(CK_ATTRIBUTE
) * n_attributes
);
479 static const CK_OBJECT_CLASS
class = CKO_CERTIFICATE
;
481 attributes_buffer
[n_attributes
++] = (CK_ATTRIBUTE
) {
483 .pValue
= (CK_OBJECT_CLASS
*) &class,
484 .ulValueLen
= sizeof(class),
488 if (!found_certificate_type
) {
489 static const CK_CERTIFICATE_TYPE type
= CKC_X_509
;
491 attributes_buffer
[n_attributes
++] = (CK_ATTRIBUTE
) {
492 .type
= CKA_CERTIFICATE_TYPE
,
493 .pValue
= (CK_CERTIFICATE_TYPE
*) &type
,
494 .ulValueLen
= sizeof(type
),
498 attributes
= attributes_buffer
;
501 rv
= m
->C_FindObjectsInit(session
, attributes
, n_attributes
);
503 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
504 "Failed to initialize object find call: %s", sym_p11_kit_strerror(rv
));
506 rv
= m
->C_FindObjects(session
, objects
, ELEMENTSOF(objects
), &n_objects
);
507 rv2
= m
->C_FindObjectsFinal(session
);
509 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
510 "Failed to find objects: %s", sym_p11_kit_strerror(rv
));
512 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
513 "Failed to finalize object find call: %s", sym_p11_kit_strerror(rv
));
515 return log_error_errno(SYNTHETIC_ERRNO(ENOENT
),
516 "Failed to find selected X509 certificate on token.");
518 return log_error_errno(SYNTHETIC_ERRNO(ENOTUNIQ
),
519 "Configured URI matches multiple certificates, refusing.");
521 *ret_object
= objects
[0];
526 int pkcs11_token_read_x509_certificate(
528 CK_SESSION_HANDLE session
,
529 CK_OBJECT_HANDLE object
,
532 _cleanup_free_
void *buffer
= NULL
;
533 _cleanup_free_
char *t
= NULL
;
534 CK_ATTRIBUTE attribute
= {
538 _cleanup_(X509_freep
) X509
*x509
= NULL
;
539 X509_NAME
*name
= NULL
;
540 const unsigned char *p
;
547 rv
= m
->C_GetAttributeValue(session
, object
, &attribute
, 1);
549 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
550 "Failed to read X.509 certificate size off token: %s", sym_p11_kit_strerror(rv
));
552 buffer
= malloc(attribute
.ulValueLen
);
556 attribute
.pValue
= buffer
;
558 rv
= m
->C_GetAttributeValue(session
, object
, &attribute
, 1);
560 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
561 "Failed to read X.509 certificate data off token: %s", sym_p11_kit_strerror(rv
));
563 p
= attribute
.pValue
;
564 x509
= d2i_X509(NULL
, &p
, attribute
.ulValueLen
);
566 return log_error_errno(SYNTHETIC_ERRNO(EBADMSG
), "Failed parse X.509 certificate.");
568 name
= X509_get_subject_name(x509
);
570 return log_error_errno(SYNTHETIC_ERRNO(EBADMSG
), "Failed to acquire X.509 subject name.");
572 t
= X509_NAME_oneline(name
, NULL
, 0);
574 return log_error_errno(SYNTHETIC_ERRNO(EIO
), "Failed to format X.509 subject name as string.");
576 log_debug("Using X.509 certificate issued for '%s'.", t
);
578 *ret_cert
= TAKE_PTR(x509
);
583 int pkcs11_token_find_private_key(
585 CK_SESSION_HANDLE session
,
586 P11KitUri
*search_uri
,
587 CK_OBJECT_HANDLE
*ret_object
) {
589 bool found_decrypt
= false, found_class
= false, found_key_type
= false;
590 _cleanup_free_ CK_ATTRIBUTE
*attributes_buffer
= NULL
;
591 CK_ULONG n_attributes
, a
, n_objects
;
592 CK_ATTRIBUTE
*attributes
= NULL
;
593 CK_OBJECT_HANDLE objects
[2];
605 attributes
= sym_p11_kit_uri_get_attributes(search_uri
, &n_attributes
);
606 for (a
= 0; a
< n_attributes
; a
++) {
608 /* We use the URI's included match attributes, but make them more strict. This allows users
609 * to specify a token URL instead of an object URL and the right thing should happen if
610 * there's only one suitable key on the token. */
612 switch (attributes
[a
].type
) {
617 if (attributes
[a
].ulValueLen
!= sizeof(c
))
618 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Invalid PKCS#11 CKA_CLASS attribute size.");
620 memcpy(&c
, attributes
[a
].pValue
, sizeof(c
));
621 if (c
!= CKO_PRIVATE_KEY
)
622 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
623 "Selected PKCS#11 object is not a private key, refusing.");
632 if (attributes
[a
].ulValueLen
!= sizeof(b
))
633 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Invalid PKCS#11 CKA_DECRYPT attribute size.");
635 memcpy(&b
, attributes
[a
].pValue
, sizeof(b
));
637 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
),
638 "Selected PKCS#11 object is not suitable for decryption, refusing.");
640 found_decrypt
= true;
647 if (attributes
[a
].ulValueLen
!= sizeof(t
))
648 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Invalid PKCS#11 CKA_KEY_TYPE attribute size.");
650 memcpy(&t
, attributes
[a
].pValue
, sizeof(t
));
652 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Selected PKCS#11 object is not an RSA key, refusing.");
654 found_key_type
= true;
659 if (!found_decrypt
|| !found_class
|| !found_key_type
) {
660 /* Hmm, let's slightly extend the attribute list we search for */
662 attributes_buffer
= new(CK_ATTRIBUTE
, n_attributes
+ !found_decrypt
+ !found_class
+ !found_key_type
);
663 if (!attributes_buffer
)
666 memcpy(attributes_buffer
, attributes
, sizeof(CK_ATTRIBUTE
) * n_attributes
);
668 if (!found_decrypt
) {
669 static const CK_BBOOL yes
= true;
671 attributes_buffer
[n_attributes
++] = (CK_ATTRIBUTE
) {
673 .pValue
= (CK_BBOOL
*) &yes
,
674 .ulValueLen
= sizeof(yes
),
679 static const CK_OBJECT_CLASS
class = CKO_PRIVATE_KEY
;
681 attributes_buffer
[n_attributes
++] = (CK_ATTRIBUTE
) {
683 .pValue
= (CK_OBJECT_CLASS
*) &class,
684 .ulValueLen
= sizeof(class),
688 if (!found_key_type
) {
689 static const CK_KEY_TYPE type
= CKK_RSA
;
691 attributes_buffer
[n_attributes
++] = (CK_ATTRIBUTE
) {
692 .type
= CKA_KEY_TYPE
,
693 .pValue
= (CK_KEY_TYPE
*) &type
,
694 .ulValueLen
= sizeof(type
),
698 attributes
= attributes_buffer
;
701 rv
= m
->C_FindObjectsInit(session
, attributes
, n_attributes
);
703 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
704 "Failed to initialize object find call: %s", sym_p11_kit_strerror(rv
));
706 rv
= m
->C_FindObjects(session
, objects
, ELEMENTSOF(objects
), &n_objects
);
707 rv2
= m
->C_FindObjectsFinal(session
);
709 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
710 "Failed to find objects: %s", sym_p11_kit_strerror(rv
));
712 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
713 "Failed to finalize object find call: %s", sym_p11_kit_strerror(rv
));
715 return log_error_errno(SYNTHETIC_ERRNO(ENOENT
),
716 "Failed to find selected private key suitable for decryption on token.");
718 return log_error_errno(SYNTHETIC_ERRNO(ENOTUNIQ
),
719 "Configured private key URI matches multiple keys, refusing.");
721 *ret_object
= objects
[0];
725 int pkcs11_token_decrypt_data(
727 CK_SESSION_HANDLE session
,
728 CK_OBJECT_HANDLE object
,
729 const void *encrypted_data
,
730 size_t encrypted_data_size
,
731 void **ret_decrypted_data
,
732 size_t *ret_decrypted_data_size
) {
734 static const CK_MECHANISM mechanism
= {
735 .mechanism
= CKM_RSA_PKCS
737 _cleanup_(erase_and_freep
) CK_BYTE
*dbuffer
= NULL
;
738 CK_ULONG dbuffer_size
= 0;
743 assert(encrypted_data
);
744 assert(encrypted_data_size
> 0);
745 assert(ret_decrypted_data
);
746 assert(ret_decrypted_data_size
);
752 rv
= m
->C_DecryptInit(session
, (CK_MECHANISM
*) &mechanism
, object
);
754 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
755 "Failed to initialize decryption on security token: %s", sym_p11_kit_strerror(rv
));
757 dbuffer_size
= encrypted_data_size
; /* Start with something reasonable */
758 dbuffer
= malloc(dbuffer_size
);
762 rv
= m
->C_Decrypt(session
, (CK_BYTE
*) encrypted_data
, encrypted_data_size
, dbuffer
, &dbuffer_size
);
763 if (rv
== CKR_BUFFER_TOO_SMALL
) {
764 erase_and_free(dbuffer
);
766 dbuffer
= malloc(dbuffer_size
);
770 rv
= m
->C_Decrypt(session
, (CK_BYTE
*) encrypted_data
, encrypted_data_size
, dbuffer
, &dbuffer_size
);
773 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
774 "Failed to decrypt key on security token: %s", sym_p11_kit_strerror(rv
));
776 log_info("Successfully decrypted key with security token.");
778 *ret_decrypted_data
= TAKE_PTR(dbuffer
);
779 *ret_decrypted_data_size
= dbuffer_size
;
783 int pkcs11_token_acquire_rng(
785 CK_SESSION_HANDLE session
) {
787 _cleanup_free_
void *buffer
= NULL
;
798 /* While we are at it, let's read some RNG data from the PKCS#11 token and pass it to the kernel
799 * random pool. This should be cheap if we are talking to the device already. Note that we don't
800 * credit any entropy, since we don't know about the quality of the pkcs#11 token's RNG. Why bother
801 * at all? There are two sides to the argument whether to generate private keys on tokens or on the
802 * host. By crediting some data from the token RNG to the host's pool we at least can say that any
803 * key generated from it is at least as good as both sources individually. */
805 rps
= random_pool_size();
807 buffer
= malloc(rps
);
811 rv
= m
->C_GenerateRandom(session
, buffer
, rps
);
813 return log_debug_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
814 "Failed to generate RNG data on security token: %s", sym_p11_kit_strerror(rv
));
816 r
= random_write_entropy(-1, buffer
, rps
, false);
818 return log_debug_errno(r
, "Failed to write PKCS#11 acquired random data to /dev/urandom: %m");
820 log_debug("Successfully written %zu bytes random data acquired via PKCS#11 to kernel random pool.", rps
);
825 static int token_process(
828 const CK_SLOT_INFO
*slot_info
,
829 const CK_TOKEN_INFO
*token_info
,
830 P11KitUri
*search_uri
,
831 pkcs11_find_token_callback_t callback
,
834 _cleanup_free_
char *token_label
= NULL
;
835 CK_SESSION_HANDLE session
;
843 token_label
= pkcs11_token_label(token_info
);
847 rv
= m
->C_OpenSession(slotid
, CKF_SERIAL_SESSION
, NULL
, NULL
, &session
);
849 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
850 "Failed to create session for security token '%s': %s", token_label
, sym_p11_kit_strerror(rv
));
853 r
= callback(m
, session
, slotid
, slot_info
, token_info
, search_uri
, userdata
);
855 r
= 1; /* if not callback was specified, just say we found what we were looking for */
857 rv
= m
->C_CloseSession(session
);
859 log_warning("Failed to close session on PKCS#11 token, ignoring: %s", sym_p11_kit_strerror(rv
));
864 static int slot_process(
867 P11KitUri
*search_uri
,
868 pkcs11_find_token_callback_t callback
,
871 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
* slot_uri
= NULL
, *token_uri
= NULL
;
872 _cleanup_free_
char *token_uri_string
= NULL
;
873 CK_TOKEN_INFO token_info
;
874 CK_SLOT_INFO slot_info
;
884 /* We return -EAGAIN for all failures we can attribute to a specific slot in some way, so that the
885 * caller might try other slots before giving up. */
887 rv
= m
->C_GetSlotInfo(slotid
, &slot_info
);
889 log_warning("Failed to acquire slot info for slot %lu, ignoring slot: %s", slotid
, sym_p11_kit_strerror(rv
));
893 slot_uri
= uri_from_slot_info(&slot_info
);
898 _cleanup_free_
char *slot_uri_string
= NULL
;
900 uri_result
= sym_p11_kit_uri_format(slot_uri
, P11_KIT_URI_FOR_ANY
, &slot_uri_string
);
901 if (uri_result
!= P11_KIT_URI_OK
) {
902 log_warning("Failed to format slot URI, ignoring slot: %s", sym_p11_kit_uri_message(uri_result
));
906 log_debug("Found slot with URI %s", slot_uri_string
);
909 rv
= m
->C_GetTokenInfo(slotid
, &token_info
);
910 if (rv
== CKR_TOKEN_NOT_PRESENT
) {
911 return log_debug_errno(SYNTHETIC_ERRNO(EAGAIN
),
912 "Token not present in slot, ignoring.");
913 } else if (rv
!= CKR_OK
) {
914 log_warning("Failed to acquire token info for slot %lu, ignoring slot: %s", slotid
, sym_p11_kit_strerror(rv
));
918 token_uri
= uri_from_token_info(&token_info
);
922 uri_result
= sym_p11_kit_uri_format(token_uri
, P11_KIT_URI_FOR_ANY
, &token_uri_string
);
923 if (uri_result
!= P11_KIT_URI_OK
) {
924 log_warning("Failed to format slot URI: %s", sym_p11_kit_uri_message(uri_result
));
928 if (search_uri
&& !sym_p11_kit_uri_match_token_info(search_uri
, &token_info
))
929 return log_debug_errno(SYNTHETIC_ERRNO(EAGAIN
),
930 "Found non-matching token with URI %s.",
933 log_debug("Found matching token with URI %s.", token_uri_string
);
935 return token_process(
945 static int module_process(
947 P11KitUri
*search_uri
,
948 pkcs11_find_token_callback_t callback
,
951 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
* module_uri
= NULL
;
952 _cleanup_free_
char *name
= NULL
, *module_uri_string
= NULL
;
953 _cleanup_free_ CK_SLOT_ID
*slotids
= NULL
;
954 CK_ULONG n_slotids
= 0;
967 /* We ignore most errors from modules here, in order to skip over faulty modules: one faulty module
968 * should not have the effect that we don't try the others anymore. We indicate such per-module
969 * failures with -EAGAIN, which let's the caller try the next module. */
971 name
= sym_p11_kit_module_get_name(m
);
975 log_debug("Trying PKCS#11 module %s.", name
);
977 rv
= m
->C_GetInfo(&info
);
979 log_warning("Failed to get info on PKCS#11 module, ignoring module: %s", sym_p11_kit_strerror(rv
));
983 module_uri
= uri_from_module_info(&info
);
987 uri_result
= sym_p11_kit_uri_format(module_uri
, P11_KIT_URI_FOR_ANY
, &module_uri_string
);
988 if (uri_result
!= P11_KIT_URI_OK
) {
989 log_warning("Failed to format module URI, ignoring module: %s", sym_p11_kit_uri_message(uri_result
));
993 log_debug("Found module with URI %s", module_uri_string
);
995 rv
= pkcs11_get_slot_list_malloc(m
, &slotids
, &n_slotids
);
997 log_warning("Failed to get slot list, ignoring module: %s", sym_p11_kit_strerror(rv
));
1001 return log_debug_errno(SYNTHETIC_ERRNO(EAGAIN
),
1002 "This module has no slots? Ignoring module.");
1004 for (k
= 0; k
< n_slotids
; k
++) {
1018 int pkcs11_find_token(
1019 const char *pkcs11_uri
,
1020 pkcs11_find_token_callback_t callback
,
1023 _cleanup_(sym_p11_kit_modules_finalize_and_releasep
) CK_FUNCTION_LIST
**modules
= NULL
;
1024 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
*search_uri
= NULL
;
1027 r
= dlopen_p11kit();
1031 /* Execute the specified callback for each matching token found. If nothing is found returns
1032 * -EAGAIN. Logs about all errors, except for EAGAIN, which the caller has to log about. */
1035 r
= uri_from_string(pkcs11_uri
, &search_uri
);
1037 return log_error_errno(r
, "Failed to parse PKCS#11 URI '%s': %m", pkcs11_uri
);
1040 modules
= sym_p11_kit_modules_load_and_initialize(0);
1042 return log_error_errno(SYNTHETIC_ERRNO(EIO
), "Failed to initialize pkcs11 modules");
1044 for (CK_FUNCTION_LIST
**i
= modules
; *i
; i
++) {
1058 struct pkcs11_acquire_certificate_callback_data
{
1061 const char *askpw_friendly_name
, *askpw_icon_name
;
1062 AskPasswordFlags askpw_flags
;
1066 static void pkcs11_acquire_certificate_callback_data_release(struct pkcs11_acquire_certificate_callback_data
*data
) {
1067 erase_and_free(data
->pin_used
);
1068 X509_free(data
->cert
);
1071 static int pkcs11_acquire_certificate_callback(
1072 CK_FUNCTION_LIST
*m
,
1073 CK_SESSION_HANDLE session
,
1075 const CK_SLOT_INFO
*slot_info
,
1076 const CK_TOKEN_INFO
*token_info
,
1080 _cleanup_(erase_and_freep
) char *pin_used
= NULL
;
1081 struct pkcs11_acquire_certificate_callback_data
*data
= ASSERT_PTR(userdata
);
1082 CK_OBJECT_HANDLE object
;
1090 /* Called for every token matching our URI */
1092 r
= pkcs11_token_login(
1097 data
->askpw_friendly_name
,
1098 data
->askpw_icon_name
,
1108 r
= pkcs11_token_find_x509_certificate(m
, session
, uri
, &object
);
1112 r
= pkcs11_token_read_x509_certificate(m
, session
, object
, &data
->cert
);
1116 /* Let's read some random data off the token and write it to the kernel pool before we generate our
1117 * random key from it. This way we can claim the quality of the RNG is at least as good as the
1118 * kernel's and the token's pool */
1119 (void) pkcs11_token_acquire_rng(m
, session
);
1121 data
->pin_used
= TAKE_PTR(pin_used
);
1125 int pkcs11_acquire_certificate(
1127 const char *askpw_friendly_name
,
1128 const char *askpw_icon_name
,
1130 char **ret_pin_used
) {
1132 _cleanup_(pkcs11_acquire_certificate_callback_data_release
) struct pkcs11_acquire_certificate_callback_data data
= {
1133 .askpw_friendly_name
= askpw_friendly_name
,
1134 .askpw_icon_name
= askpw_icon_name
,
1141 r
= pkcs11_find_token(uri
, pkcs11_acquire_certificate_callback
, &data
);
1142 if (r
== -EAGAIN
) /* pkcs11_find_token() doesn't log about this error, but all others */
1143 return log_error_errno(SYNTHETIC_ERRNO(ENXIO
),
1144 "Specified PKCS#11 token with URI '%s' not found.",
1149 *ret_cert
= TAKE_PTR(data
.cert
);
1152 *ret_pin_used
= TAKE_PTR(data
.pin_used
);
1158 static int list_callback(
1159 CK_FUNCTION_LIST
*m
,
1160 CK_SESSION_HANDLE session
,
1162 const CK_SLOT_INFO
*slot_info
,
1163 const CK_TOKEN_INFO
*token_info
,
1167 _cleanup_free_
char *token_uri_string
= NULL
, *token_label
= NULL
, *token_manufacturer_id
= NULL
, *token_model
= NULL
;
1168 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
*token_uri
= NULL
;
1169 Table
*t
= userdata
;
1175 r
= dlopen_p11kit();
1179 /* We only care about hardware devices here with a token inserted. Let's filter everything else
1180 * out. (Note that the user can explicitly specify non-hardware tokens if they like, but during
1181 * enumeration we'll filter those, since software tokens are typically the system certificate store
1182 * and such, and it's typically not what people want to bind their home directories to.) */
1183 if (!FLAGS_SET(slot_info
->flags
, CKF_HW_SLOT
|CKF_TOKEN_PRESENT
))
1186 token_label
= pkcs11_token_label(token_info
);
1190 token_manufacturer_id
= pkcs11_token_manufacturer_id(token_info
);
1191 if (!token_manufacturer_id
)
1194 token_model
= pkcs11_token_model(token_info
);
1198 token_uri
= uri_from_token_info(token_info
);
1202 uri_result
= sym_p11_kit_uri_format(token_uri
, P11_KIT_URI_FOR_ANY
, &token_uri_string
);
1203 if (uri_result
!= P11_KIT_URI_OK
)
1204 return log_warning_errno(SYNTHETIC_ERRNO(EAGAIN
), "Failed to format slot URI: %s", sym_p11_kit_uri_message(uri_result
));
1208 TABLE_STRING
, token_uri_string
,
1209 TABLE_STRING
, token_label
,
1210 TABLE_STRING
, token_manufacturer_id
,
1211 TABLE_STRING
, token_model
);
1213 return table_log_add_error(r
);
1215 return -EAGAIN
; /* keep scanning */
1219 int pkcs11_list_tokens(void) {
1221 _cleanup_(table_unrefp
) Table
*t
= NULL
;
1224 t
= table_new("uri", "label", "manufacturer", "model");
1228 r
= pkcs11_find_token(NULL
, list_callback
, t
);
1229 if (r
< 0 && r
!= -EAGAIN
)
1232 if (table_get_rows(t
) <= 1) {
1233 log_info("No suitable PKCS#11 tokens found.");
1237 r
= table_print(t
, stdout
);
1239 return log_error_errno(r
, "Failed to show device table: %m");
1243 return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
1244 "PKCS#11 tokens not supported on this build.");
1249 static int auto_callback(
1250 CK_FUNCTION_LIST
*m
,
1251 CK_SESSION_HANDLE session
,
1253 const CK_SLOT_INFO
*slot_info
,
1254 const CK_TOKEN_INFO
*token_info
,
1258 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
*token_uri
= NULL
;
1259 char **t
= userdata
;
1265 r
= dlopen_p11kit();
1269 if (!FLAGS_SET(token_info
->flags
, CKF_HW_SLOT
|CKF_TOKEN_PRESENT
))
1273 return log_error_errno(SYNTHETIC_ERRNO(ENOTUNIQ
),
1274 "More than one suitable PKCS#11 token found.");
1276 token_uri
= uri_from_token_info(token_info
);
1280 uri_result
= sym_p11_kit_uri_format(token_uri
, P11_KIT_URI_FOR_ANY
, t
);
1281 if (uri_result
!= P11_KIT_URI_OK
)
1282 return log_warning_errno(SYNTHETIC_ERRNO(EAGAIN
), "Failed to format slot URI: %s", sym_p11_kit_uri_message(uri_result
));
1288 int pkcs11_find_token_auto(char **ret
) {
1292 r
= pkcs11_find_token(NULL
, auto_callback
, ret
);
1294 return log_error_errno(SYNTHETIC_ERRNO(ENODEV
), "No suitable PKCS#11 tokens found.");
1300 return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
1301 "PKCS#11 tokens not supported on this build.");
1306 void pkcs11_crypt_device_callback_data_release(pkcs11_crypt_device_callback_data
*data
) {
1307 erase_and_free(data
->decrypted_key
);
1309 if (data
->free_encrypted_key
)
1310 free(data
->encrypted_key
);
1313 int pkcs11_crypt_device_callback(
1314 CK_FUNCTION_LIST
*m
,
1315 CK_SESSION_HANDLE session
,
1317 const CK_SLOT_INFO
*slot_info
,
1318 const CK_TOKEN_INFO
*token_info
,
1322 pkcs11_crypt_device_callback_data
*data
= ASSERT_PTR(userdata
);
1323 CK_OBJECT_HANDLE object
;
1331 /* Called for every token matching our URI */
1333 r
= pkcs11_token_login(
1338 data
->friendly_name
,
1341 "cryptsetup.pkcs11-pin",
1349 /* We are likely called during early boot, where entropy is scarce. Mix some data from the PKCS#11
1350 * token, if it supports that. It should be cheap, given that we already are talking to it anyway and
1351 * shouldn't hurt. */
1352 (void) pkcs11_token_acquire_rng(m
, session
);
1354 r
= pkcs11_token_find_private_key(m
, session
, uri
, &object
);
1358 r
= pkcs11_token_decrypt_data(
1362 data
->encrypted_key
,
1363 data
->encrypted_key_size
,
1364 &data
->decrypted_key
,
1365 &data
->decrypted_key_size
);