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 uint_fast8_t n_objects
= 0;
590 bool found_class
= false;
591 _cleanup_free_ CK_ATTRIBUTE
*attributes_buffer
= NULL
;
592 CK_OBJECT_HANDLE object
, candidate
;
593 static const CK_OBJECT_CLASS
class = CKO_PRIVATE_KEY
;
594 CK_BBOOL decrypt_value
, derive_value
;
595 CK_ATTRIBUTE optional_attributes
[] = {
596 { CKA_DECRYPT
, &decrypt_value
, sizeof(decrypt_value
) },
597 { CKA_DERIVE
, &derive_value
, sizeof(derive_value
) }
605 CK_ULONG n_attributes
;
606 CK_ATTRIBUTE
*attributes
= sym_p11_kit_uri_get_attributes(search_uri
, &n_attributes
);
607 for (CK_ULONG i
= 0; i
< n_attributes
; i
++) {
609 /* We use the URI's included match attributes, but make them more strict. This allows users
610 * to specify a token URL instead of an object URL and the right thing should happen if
611 * there's only one suitable key on the token. */
613 switch (attributes
[i
].type
) {
617 if (attributes
[i
].ulValueLen
!= sizeof(c
))
618 return log_error_errno(SYNTHETIC_ERRNO(EINVAL
), "Invalid PKCS#11 CKA_CLASS attribute size.");
620 memcpy(&c
, attributes
[i
].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.");
631 /* Hmm, let's slightly extend the attribute list we search for */
633 attributes_buffer
= new(CK_ATTRIBUTE
, n_attributes
+ 1);
634 if (!attributes_buffer
)
637 memcpy(attributes_buffer
, attributes
, sizeof(CK_ATTRIBUTE
) * n_attributes
);
639 attributes_buffer
[n_attributes
++] = (CK_ATTRIBUTE
) {
641 .pValue
= (CK_OBJECT_CLASS
*) &class,
642 .ulValueLen
= sizeof(class),
645 attributes
= attributes_buffer
;
648 rv
= m
->C_FindObjectsInit(session
, attributes
, n_attributes
);
650 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
651 "Failed to initialize object find call: %s", sym_p11_kit_strerror(rv
));
655 rv
= m
->C_FindObjects(session
, &candidate
, 1, &b
);
657 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
658 "Failed to find objects: %s", sym_p11_kit_strerror(rv
));
663 bool can_decrypt
= false, can_derive
= false;
664 optional_attributes
[0].ulValueLen
= sizeof(decrypt_value
);
665 optional_attributes
[1].ulValueLen
= sizeof(derive_value
);
667 rv
= m
->C_GetAttributeValue(session
, candidate
, optional_attributes
, ELEMENTSOF(optional_attributes
));
668 if (rv
!= CKR_OK
&& rv
!= CKR_ATTRIBUTE_TYPE_INVALID
)
669 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
670 "Failed to get attributes of a selected private key: %s", sym_p11_kit_strerror(rv
));
672 if (optional_attributes
[0].ulValueLen
!= CK_UNAVAILABLE_INFORMATION
&& decrypt_value
== CK_TRUE
)
675 if (optional_attributes
[1].ulValueLen
!= CK_UNAVAILABLE_INFORMATION
&& derive_value
== CK_TRUE
)
678 if (can_decrypt
|| can_derive
) {
686 rv
= m
->C_FindObjectsFinal(session
);
688 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
689 "Failed to finalize object find call: %s", sym_p11_kit_strerror(rv
));
692 return log_error_errno(SYNTHETIC_ERRNO(ENOENT
),
693 "Failed to find selected private key suitable for decryption or derivation on token.");
696 return log_error_errno(SYNTHETIC_ERRNO(ENOTUNIQ
),
697 "Configured private key URI matches multiple keys, refusing.");
699 *ret_object
= object
;
703 /* Since EC keys doesn't support encryption directly, we use ECDH protocol to derive shared secret here.
704 * We use PKCS#11 C_DeriveKey function to derive a shared secret with a private key stored in the token and
705 * a public key saved on enrollment. */
706 static int pkcs11_token_decrypt_data_ecc(
708 CK_SESSION_HANDLE session
,
709 CK_OBJECT_HANDLE object
,
710 const void *encrypted_data
,
711 size_t encrypted_data_size
,
712 void **ret_decrypted_data
,
713 size_t *ret_decrypted_data_size
) {
715 static const CK_BBOOL yes
= CK_TRUE
, no
= CK_FALSE
;
716 static const CK_OBJECT_CLASS shared_secret_class
= CKO_SECRET_KEY
;
717 static const CK_KEY_TYPE shared_secret_type
= CKK_GENERIC_SECRET
;
718 static const CK_ATTRIBUTE shared_secret_template
[] = {
719 { CKA_TOKEN
, (void*) &no
, sizeof(no
) },
720 { CKA_CLASS
, (void*) &shared_secret_class
, sizeof(shared_secret_class
) },
721 { CKA_KEY_TYPE
, (void*) &shared_secret_type
, sizeof(shared_secret_type
) },
722 { CKA_SENSITIVE
, (void*) &no
, sizeof(no
) },
723 { CKA_EXTRACTABLE
, (void*) &yes
, sizeof(yes
) }
725 CK_ECDH1_DERIVE_PARAMS params
= {
727 .pPublicData
= (void*) encrypted_data
,
728 .ulPublicDataLen
= encrypted_data_size
730 CK_MECHANISM mechanism
= {
731 .mechanism
= CKM_ECDH1_DERIVE
,
732 .pParameter
= ¶ms
,
733 .ulParameterLen
= sizeof(params
)
735 CK_OBJECT_HANDLE shared_secret_handle
;
738 rv
= m
->C_DeriveKey(session
, &mechanism
, object
, (CK_ATTRIBUTE
*) shared_secret_template
, ELEMENTSOF(shared_secret_template
), &shared_secret_handle
);
740 return log_error_errno(SYNTHETIC_ERRNO(EIO
), "Failed to derive a shared secret: %s", sym_p11_kit_strerror(rv
));
742 CK_ATTRIBUTE shared_secret_attr
= { CKA_VALUE
, NULL_PTR
, 0};
744 rv
= m
->C_GetAttributeValue(session
, shared_secret_handle
, &shared_secret_attr
, 1);
746 rv2
= m
->C_DestroyObject(session
, shared_secret_handle
);
748 log_warning("Failed to destroy a shared secret, ignoring: %s", sym_p11_kit_strerror(rv2
));
749 return log_error_errno(SYNTHETIC_ERRNO(EIO
), "Failed to retrieve shared secret length: %s", sym_p11_kit_strerror(rv
));
752 shared_secret_attr
.pValue
= malloc(shared_secret_attr
.ulValueLen
);
753 if (!shared_secret_attr
.pValue
)
756 rv
= m
->C_GetAttributeValue(session
, shared_secret_handle
, &shared_secret_attr
, 1);
757 rv2
= m
->C_DestroyObject(session
, shared_secret_handle
);
759 log_warning("Failed to destroy a shared secret, ignoring: %s", sym_p11_kit_strerror(rv2
));
762 erase_and_free(shared_secret_attr
.pValue
);
763 return log_error_errno(SYNTHETIC_ERRNO(EIO
), "Failed to retrieve a shared secret: %s", sym_p11_kit_strerror(rv
));
766 log_info("Successfully derived key with security token.");
768 *ret_decrypted_data
= shared_secret_attr
.pValue
;
769 *ret_decrypted_data_size
= shared_secret_attr
.ulValueLen
;
773 static int pkcs11_token_decrypt_data_rsa(
775 CK_SESSION_HANDLE session
,
776 CK_OBJECT_HANDLE object
,
777 const void *encrypted_data
,
778 size_t encrypted_data_size
,
779 void **ret_decrypted_data
,
780 size_t *ret_decrypted_data_size
) {
782 static const CK_MECHANISM mechanism
= {
783 .mechanism
= CKM_RSA_PKCS
785 _cleanup_(erase_and_freep
) CK_BYTE
*dbuffer
= NULL
;
786 CK_ULONG dbuffer_size
= 0;
789 rv
= m
->C_DecryptInit(session
, (CK_MECHANISM
*) &mechanism
, object
);
791 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
792 "Failed to initialize decryption on security token: %s", sym_p11_kit_strerror(rv
));
794 dbuffer_size
= encrypted_data_size
; /* Start with something reasonable */
795 dbuffer
= malloc(dbuffer_size
);
799 rv
= m
->C_Decrypt(session
, (CK_BYTE
*) encrypted_data
, encrypted_data_size
, dbuffer
, &dbuffer_size
);
800 if (rv
== CKR_BUFFER_TOO_SMALL
) {
801 erase_and_free(dbuffer
);
803 dbuffer
= malloc(dbuffer_size
);
807 rv
= m
->C_Decrypt(session
, (CK_BYTE
*) encrypted_data
, encrypted_data_size
, dbuffer
, &dbuffer_size
);
810 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
811 "Failed to decrypt key on security token: %s", sym_p11_kit_strerror(rv
));
813 log_info("Successfully decrypted key with security token.");
815 *ret_decrypted_data
= TAKE_PTR(dbuffer
);
816 *ret_decrypted_data_size
= dbuffer_size
;
820 int pkcs11_token_decrypt_data(
822 CK_SESSION_HANDLE session
,
823 CK_OBJECT_HANDLE object
,
824 const void *encrypted_data
,
825 size_t encrypted_data_size
,
826 void **ret_decrypted_data
,
827 size_t *ret_decrypted_data_size
) {
829 CK_KEY_TYPE key_type
;
830 CK_ATTRIBUTE key_type_template
= { CKA_KEY_TYPE
, &key_type
, sizeof(key_type
) };
834 assert(encrypted_data
);
835 assert(encrypted_data_size
> 0);
836 assert(ret_decrypted_data
);
837 assert(ret_decrypted_data_size
);
839 rv
= m
->C_GetAttributeValue(session
, object
, &key_type_template
, 1);
841 return log_error_errno(SYNTHETIC_ERRNO(EIO
), "Failed to retrieve private key type");
846 return pkcs11_token_decrypt_data_rsa(m
, session
, object
, encrypted_data
, encrypted_data_size
, ret_decrypted_data
, ret_decrypted_data_size
);
849 return pkcs11_token_decrypt_data_ecc(m
, session
, object
, encrypted_data
, encrypted_data_size
, ret_decrypted_data
, ret_decrypted_data_size
);
852 return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
), "Unsupported private key type: %lu", key_type
);
856 int pkcs11_token_acquire_rng(
858 CK_SESSION_HANDLE session
) {
860 _cleanup_free_
void *buffer
= NULL
;
871 /* While we are at it, let's read some RNG data from the PKCS#11 token and pass it to the kernel
872 * random pool. This should be cheap if we are talking to the device already. Note that we don't
873 * credit any entropy, since we don't know about the quality of the pkcs#11 token's RNG. Why bother
874 * at all? There are two sides to the argument whether to generate private keys on tokens or on the
875 * host. By crediting some data from the token RNG to the host's pool we at least can say that any
876 * key generated from it is at least as good as both sources individually. */
878 rps
= random_pool_size();
880 buffer
= malloc(rps
);
884 rv
= m
->C_GenerateRandom(session
, buffer
, rps
);
886 return log_debug_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
887 "Failed to generate RNG data on security token: %s", sym_p11_kit_strerror(rv
));
889 r
= random_write_entropy(-1, buffer
, rps
, false);
891 return log_debug_errno(r
, "Failed to write PKCS#11 acquired random data to /dev/urandom: %m");
893 log_debug("Successfully written %zu bytes random data acquired via PKCS#11 to kernel random pool.", rps
);
898 static int token_process(
901 const CK_SLOT_INFO
*slot_info
,
902 const CK_TOKEN_INFO
*token_info
,
903 P11KitUri
*search_uri
,
904 pkcs11_find_token_callback_t callback
,
907 _cleanup_free_
char *token_label
= NULL
;
908 CK_SESSION_HANDLE session
;
916 token_label
= pkcs11_token_label(token_info
);
920 rv
= m
->C_OpenSession(slotid
, CKF_SERIAL_SESSION
, NULL
, NULL
, &session
);
922 return log_error_errno(SYNTHETIC_ERRNO(EIO
),
923 "Failed to create session for security token '%s': %s", token_label
, sym_p11_kit_strerror(rv
));
926 r
= callback(m
, session
, slotid
, slot_info
, token_info
, search_uri
, userdata
);
928 r
= 1; /* if not callback was specified, just say we found what we were looking for */
930 rv
= m
->C_CloseSession(session
);
932 log_warning("Failed to close session on PKCS#11 token, ignoring: %s", sym_p11_kit_strerror(rv
));
937 static int slot_process(
940 P11KitUri
*search_uri
,
941 pkcs11_find_token_callback_t callback
,
944 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
* slot_uri
= NULL
, *token_uri
= NULL
;
945 _cleanup_free_
char *token_uri_string
= NULL
;
946 CK_TOKEN_INFO token_info
;
947 CK_SLOT_INFO slot_info
;
957 /* We return -EAGAIN for all failures we can attribute to a specific slot in some way, so that the
958 * caller might try other slots before giving up. */
960 rv
= m
->C_GetSlotInfo(slotid
, &slot_info
);
962 log_warning("Failed to acquire slot info for slot %lu, ignoring slot: %s", slotid
, sym_p11_kit_strerror(rv
));
966 slot_uri
= uri_from_slot_info(&slot_info
);
971 _cleanup_free_
char *slot_uri_string
= NULL
;
973 uri_result
= sym_p11_kit_uri_format(slot_uri
, P11_KIT_URI_FOR_ANY
, &slot_uri_string
);
974 if (uri_result
!= P11_KIT_URI_OK
) {
975 log_warning("Failed to format slot URI, ignoring slot: %s", sym_p11_kit_uri_message(uri_result
));
979 log_debug("Found slot with URI %s", slot_uri_string
);
982 rv
= m
->C_GetTokenInfo(slotid
, &token_info
);
983 if (rv
== CKR_TOKEN_NOT_PRESENT
) {
984 return log_debug_errno(SYNTHETIC_ERRNO(EAGAIN
),
985 "Token not present in slot, ignoring.");
986 } else if (rv
!= CKR_OK
) {
987 log_warning("Failed to acquire token info for slot %lu, ignoring slot: %s", slotid
, sym_p11_kit_strerror(rv
));
991 token_uri
= uri_from_token_info(&token_info
);
995 uri_result
= sym_p11_kit_uri_format(token_uri
, P11_KIT_URI_FOR_ANY
, &token_uri_string
);
996 if (uri_result
!= P11_KIT_URI_OK
) {
997 log_warning("Failed to format slot URI: %s", sym_p11_kit_uri_message(uri_result
));
1001 if (search_uri
&& !sym_p11_kit_uri_match_token_info(search_uri
, &token_info
))
1002 return log_debug_errno(SYNTHETIC_ERRNO(EAGAIN
),
1003 "Found non-matching token with URI %s.",
1006 log_debug("Found matching token with URI %s.", token_uri_string
);
1008 return token_process(
1018 static int module_process(
1019 CK_FUNCTION_LIST
*m
,
1020 P11KitUri
*search_uri
,
1021 pkcs11_find_token_callback_t callback
,
1024 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
* module_uri
= NULL
;
1025 _cleanup_free_
char *name
= NULL
, *module_uri_string
= NULL
;
1026 _cleanup_free_ CK_SLOT_ID
*slotids
= NULL
;
1027 CK_ULONG n_slotids
= 0;
1036 r
= dlopen_p11kit();
1040 /* We ignore most errors from modules here, in order to skip over faulty modules: one faulty module
1041 * should not have the effect that we don't try the others anymore. We indicate such per-module
1042 * failures with -EAGAIN, which let's the caller try the next module. */
1044 name
= sym_p11_kit_module_get_name(m
);
1048 log_debug("Trying PKCS#11 module %s.", name
);
1050 rv
= m
->C_GetInfo(&info
);
1052 log_warning("Failed to get info on PKCS#11 module, ignoring module: %s", sym_p11_kit_strerror(rv
));
1056 module_uri
= uri_from_module_info(&info
);
1060 uri_result
= sym_p11_kit_uri_format(module_uri
, P11_KIT_URI_FOR_ANY
, &module_uri_string
);
1061 if (uri_result
!= P11_KIT_URI_OK
) {
1062 log_warning("Failed to format module URI, ignoring module: %s", sym_p11_kit_uri_message(uri_result
));
1066 log_debug("Found module with URI %s", module_uri_string
);
1068 rv
= pkcs11_get_slot_list_malloc(m
, &slotids
, &n_slotids
);
1070 log_warning("Failed to get slot list, ignoring module: %s", sym_p11_kit_strerror(rv
));
1074 return log_debug_errno(SYNTHETIC_ERRNO(EAGAIN
),
1075 "This module has no slots? Ignoring module.");
1077 for (k
= 0; k
< n_slotids
; k
++) {
1091 int pkcs11_find_token(
1092 const char *pkcs11_uri
,
1093 pkcs11_find_token_callback_t callback
,
1096 _cleanup_(sym_p11_kit_modules_finalize_and_releasep
) CK_FUNCTION_LIST
**modules
= NULL
;
1097 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
*search_uri
= NULL
;
1100 r
= dlopen_p11kit();
1104 /* Execute the specified callback for each matching token found. If nothing is found returns
1105 * -EAGAIN. Logs about all errors, except for EAGAIN, which the caller has to log about. */
1108 r
= uri_from_string(pkcs11_uri
, &search_uri
);
1110 return log_error_errno(r
, "Failed to parse PKCS#11 URI '%s': %m", pkcs11_uri
);
1113 modules
= sym_p11_kit_modules_load_and_initialize(0);
1115 return log_error_errno(SYNTHETIC_ERRNO(EIO
), "Failed to initialize pkcs11 modules");
1117 for (CK_FUNCTION_LIST
**i
= modules
; *i
; i
++) {
1131 struct pkcs11_acquire_certificate_callback_data
{
1134 const char *askpw_friendly_name
, *askpw_icon_name
;
1135 AskPasswordFlags askpw_flags
;
1139 static void pkcs11_acquire_certificate_callback_data_release(struct pkcs11_acquire_certificate_callback_data
*data
) {
1140 erase_and_free(data
->pin_used
);
1141 X509_free(data
->cert
);
1144 static int pkcs11_acquire_certificate_callback(
1145 CK_FUNCTION_LIST
*m
,
1146 CK_SESSION_HANDLE session
,
1148 const CK_SLOT_INFO
*slot_info
,
1149 const CK_TOKEN_INFO
*token_info
,
1153 _cleanup_(erase_and_freep
) char *pin_used
= NULL
;
1154 struct pkcs11_acquire_certificate_callback_data
*data
= ASSERT_PTR(userdata
);
1155 CK_OBJECT_HANDLE object
;
1163 /* Called for every token matching our URI */
1165 r
= pkcs11_token_login(
1170 data
->askpw_friendly_name
,
1171 data
->askpw_icon_name
,
1181 r
= pkcs11_token_find_x509_certificate(m
, session
, uri
, &object
);
1185 r
= pkcs11_token_read_x509_certificate(m
, session
, object
, &data
->cert
);
1189 /* Let's read some random data off the token and write it to the kernel pool before we generate our
1190 * random key from it. This way we can claim the quality of the RNG is at least as good as the
1191 * kernel's and the token's pool */
1192 (void) pkcs11_token_acquire_rng(m
, session
);
1194 data
->pin_used
= TAKE_PTR(pin_used
);
1198 int pkcs11_acquire_certificate(
1200 const char *askpw_friendly_name
,
1201 const char *askpw_icon_name
,
1203 char **ret_pin_used
) {
1205 _cleanup_(pkcs11_acquire_certificate_callback_data_release
) struct pkcs11_acquire_certificate_callback_data data
= {
1206 .askpw_friendly_name
= askpw_friendly_name
,
1207 .askpw_icon_name
= askpw_icon_name
,
1214 r
= pkcs11_find_token(uri
, pkcs11_acquire_certificate_callback
, &data
);
1215 if (r
== -EAGAIN
) /* pkcs11_find_token() doesn't log about this error, but all others */
1216 return log_error_errno(SYNTHETIC_ERRNO(ENXIO
),
1217 "Specified PKCS#11 token with URI '%s' not found.",
1222 *ret_cert
= TAKE_PTR(data
.cert
);
1225 *ret_pin_used
= TAKE_PTR(data
.pin_used
);
1231 static int list_callback(
1232 CK_FUNCTION_LIST
*m
,
1233 CK_SESSION_HANDLE session
,
1235 const CK_SLOT_INFO
*slot_info
,
1236 const CK_TOKEN_INFO
*token_info
,
1240 _cleanup_free_
char *token_uri_string
= NULL
, *token_label
= NULL
, *token_manufacturer_id
= NULL
, *token_model
= NULL
;
1241 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
*token_uri
= NULL
;
1242 Table
*t
= userdata
;
1248 r
= dlopen_p11kit();
1252 /* We only care about hardware devices here with a token inserted. Let's filter everything else
1253 * out. (Note that the user can explicitly specify non-hardware tokens if they like, but during
1254 * enumeration we'll filter those, since software tokens are typically the system certificate store
1255 * and such, and it's typically not what people want to bind their home directories to.) */
1256 if (!FLAGS_SET(slot_info
->flags
, CKF_HW_SLOT
|CKF_TOKEN_PRESENT
))
1259 token_label
= pkcs11_token_label(token_info
);
1263 token_manufacturer_id
= pkcs11_token_manufacturer_id(token_info
);
1264 if (!token_manufacturer_id
)
1267 token_model
= pkcs11_token_model(token_info
);
1271 token_uri
= uri_from_token_info(token_info
);
1275 uri_result
= sym_p11_kit_uri_format(token_uri
, P11_KIT_URI_FOR_ANY
, &token_uri_string
);
1276 if (uri_result
!= P11_KIT_URI_OK
)
1277 return log_warning_errno(SYNTHETIC_ERRNO(EAGAIN
), "Failed to format slot URI: %s", sym_p11_kit_uri_message(uri_result
));
1281 TABLE_STRING
, token_uri_string
,
1282 TABLE_STRING
, token_label
,
1283 TABLE_STRING
, token_manufacturer_id
,
1284 TABLE_STRING
, token_model
);
1286 return table_log_add_error(r
);
1288 return -EAGAIN
; /* keep scanning */
1292 int pkcs11_list_tokens(void) {
1294 _cleanup_(table_unrefp
) Table
*t
= NULL
;
1297 t
= table_new("uri", "label", "manufacturer", "model");
1301 r
= pkcs11_find_token(NULL
, list_callback
, t
);
1302 if (r
< 0 && r
!= -EAGAIN
)
1305 if (table_get_rows(t
) <= 1) {
1306 log_info("No suitable PKCS#11 tokens found.");
1310 r
= table_print(t
, stdout
);
1312 return log_error_errno(r
, "Failed to show device table: %m");
1316 return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
1317 "PKCS#11 tokens not supported on this build.");
1322 static int auto_callback(
1323 CK_FUNCTION_LIST
*m
,
1324 CK_SESSION_HANDLE session
,
1326 const CK_SLOT_INFO
*slot_info
,
1327 const CK_TOKEN_INFO
*token_info
,
1331 _cleanup_(sym_p11_kit_uri_freep
) P11KitUri
*token_uri
= NULL
;
1332 char **t
= userdata
;
1338 r
= dlopen_p11kit();
1342 if (!FLAGS_SET(token_info
->flags
, CKF_HW_SLOT
|CKF_TOKEN_PRESENT
))
1346 return log_error_errno(SYNTHETIC_ERRNO(ENOTUNIQ
),
1347 "More than one suitable PKCS#11 token found.");
1349 token_uri
= uri_from_token_info(token_info
);
1353 uri_result
= sym_p11_kit_uri_format(token_uri
, P11_KIT_URI_FOR_ANY
, t
);
1354 if (uri_result
!= P11_KIT_URI_OK
)
1355 return log_warning_errno(SYNTHETIC_ERRNO(EAGAIN
), "Failed to format slot URI: %s", sym_p11_kit_uri_message(uri_result
));
1361 int pkcs11_find_token_auto(char **ret
) {
1365 r
= pkcs11_find_token(NULL
, auto_callback
, ret
);
1367 return log_error_errno(SYNTHETIC_ERRNO(ENODEV
), "No suitable PKCS#11 tokens found.");
1373 return log_error_errno(SYNTHETIC_ERRNO(EOPNOTSUPP
),
1374 "PKCS#11 tokens not supported on this build.");
1379 void pkcs11_crypt_device_callback_data_release(pkcs11_crypt_device_callback_data
*data
) {
1380 erase_and_free(data
->decrypted_key
);
1382 if (data
->free_encrypted_key
)
1383 free(data
->encrypted_key
);
1386 int pkcs11_crypt_device_callback(
1387 CK_FUNCTION_LIST
*m
,
1388 CK_SESSION_HANDLE session
,
1390 const CK_SLOT_INFO
*slot_info
,
1391 const CK_TOKEN_INFO
*token_info
,
1395 pkcs11_crypt_device_callback_data
*data
= ASSERT_PTR(userdata
);
1396 CK_OBJECT_HANDLE object
;
1404 /* Called for every token matching our URI */
1406 r
= pkcs11_token_login(
1411 data
->friendly_name
,
1414 "cryptsetup.pkcs11-pin",
1422 /* We are likely called during early boot, where entropy is scarce. Mix some data from the PKCS#11
1423 * token, if it supports that. It should be cheap, given that we already are talking to it anyway and
1424 * shouldn't hurt. */
1425 (void) pkcs11_token_acquire_rng(m
, session
);
1427 r
= pkcs11_token_find_private_key(m
, session
, uri
, &object
);
1431 r
= pkcs11_token_decrypt_data(
1435 data
->encrypted_key
,
1436 data
->encrypted_key_size
,
1437 &data
->decrypted_key
,
1438 &data
->decrypted_key_size
);