66 #ifndef __PKCS11H_BASE_H
67 #define __PKCS11H_BASE_H
72 #include <pkcs11-helper-1.0/pkcs11h-version.h>
76 #if defined(__cplusplus)
87 #define PKCS11H_FEATURE_MASK_ENGINE_CRYPTO_OPENSSL (1<< 0)
89 #define PKCS11H_FEATURE_MASK_ENGINE_CRYPTO_GNUTLS (1<< 1)
91 #define PKCS11H_FEATURE_MASK_ENGINE_CRYPTO_CRYPTOAPI (1<< 2)
96 #define PKCS11H_FEATURE_MASK_ENGINE_CRYPTO_WIN32 (1<< 2)
98 #define PKCS11H_FEATURE_MASK_DEBUG (1<< 3)
100 #define PKCS11H_FEATURE_MASK_THREADING (1<< 4)
102 #define PKCS11H_FEATURE_MASK_TOKEN (1<< 5)
104 #define PKCS11H_FEATURE_MASK_DATA (1<< 6)
106 #define PKCS11H_FEATURE_MASK_CERTIFICATE (1<< 7)
108 #define PKCS11H_FEATURE_MASK_SLOTEVENT (1<< 8)
110 #define PKCS11H_FEATURE_MASK_OPENSSL (1<< 9)
112 #define PKCS11H_FEATURE_MASK_ENGINE_CRYPTO_POLARSSL (1<< 10)
114 #define PKCS11H_FEATURE_MASK_ENGINE_CRYPTO_MBEDTLS (1<< 10)
124 #define PKCS11H_LOG_DEBUG2 5
126 #define PKCS11H_LOG_DEBUG1 4
128 #define PKCS11H_LOG_INFO 3
130 #define PKCS11H_LOG_WARN 2
132 #define PKCS11H_LOG_ERROR 1
134 #define PKCS11H_LOG_QUIET 0
138 #define PKCS11H_PIN_CACHE_INFINITE -1
146 #define PKCS11H_PRIVATEMODE_MASK_AUTO (0)
148 #define PKCS11H_PRIVATEMODE_MASK_SIGN (1<<0)
150 #define PKCS11H_PRIVATEMODE_MASK_RECOVER (1<<1)
152 #define PKCS11H_PRIVATEMODE_MASK_DECRYPT (1<<2)
154 #define PKCS11H_PRIVATEMODE_MASK_UNWRAP (1<<3)
163 #define PKCS11H_SLOTEVENT_METHOD_AUTO 0
165 #define PKCS11H_SLOTEVENT_METHOD_TRIGGER 1
167 #define PKCS11H_SLOTEVENT_METHOD_POLL 2
169 #define PKCS11H_SLOTEVENT_METHOD_FETCH 3
178 #define PKCS11H_PROMPT_MASK_ALLOW_PIN_PROMPT (1<<0)
180 #define PKCS11H_PROMPT_MASK_ALLOW_TOKEN_PROMPT (1<<1)
182 #define PKCS11H_PROMPT_MASK_ALLOW_KEY_PROMPT (1<<2)
184 #define PKCS11H_PROMPT_MASK_ALLOW_ALL ( \
185 PKCS11H_PROMPT_MASK_ALLOW_PIN_PROMPT | \
186 PKCS11H_PROMPT_MASK_ALLOW_TOKEN_PROMPT | \
187 PKCS11H_PROMPT_MASK_ALLOW_KEY_PROMPT | \
198 #define PKCS11H_ENUM_METHOD_CACHE 0
200 #define PKCS11H_ENUM_METHOD_CACHE_EXIST 1
202 #define PKCS11H_ENUM_METHOD_RELOAD 2
217 #define PKCS11H_PROPERTY_LOG_LEVEL 0
231 #define PKCS11H_PROPERTY_FORK_MODE 1
237 #define PKCS11H_PROPERTY_LOG_HOOK 2
243 #define PKCS11H_PROPERTY_LOG_HOOK_DATA 3
253 #define PKCS11H_PROPERTY_SLOT_EVENT_HOOK 4
259 #define PKCS11H_PROPERTY_SLOT_EVENT_HOOK_DATA 5
267 #define PKCS11H_PROPERTY_TOKEN_PROMPT_HOOK 6
273 #define PKCS11H_PROPERTY_TOKEN_PROMPT_HOOK_DATA 7
281 #define PKCS11H_PROPERTY_PIN_PROMPT_HOOK 8
287 #define PKCS11H_PROPERTY_PIN_PROMPT_HOOK_DATA 9
294 #define PKCS11H_PROPERTY_ALLOW_PROTECTED_AUTHENTICATION 10
301 #define PKCS11H_PROPERTY_PIN_CACHE_PERIOD 11
308 #define PKCS11H_PROPERTY_MAX_LOGIN_RETRIES 12
316 #define PKCS11H_PROPERTY_KEY_PROMPT_HOOK 13
322 #define PKCS11H_PROPERTY_KEY_PROMPT_HOOK_DATA 14
336 #define PKCS11H_PROVIDER_PROPERTY_LOCATION 0
342 #define PKCS11H_PROVIDER_PROPERTY_ALLOW_PROTECTED_AUTH 1
348 #define PKCS11H_PROVIDER_PROPERTY_MASK_PRIVATE_MODE 2
354 #define PKCS11H_PROVIDER_PROPERTY_SLOT_EVENT_METHOD 3
360 #define PKCS11H_PROVIDER_PROPERTY_SLOT_POLL_INTERVAL 4
366 #define PKCS11H_PROVIDER_PROPERTY_CERT_IS_PRIVATE 5
373 #define PKCS11H_PROVIDER_PROPERTY_INIT_ARGS 6
379 #define PKCS11H_PROVIDER_PROPERTY_PROVIDER_DESTRUCT_HOOK 7
385 #define PKCS11H_PROVIDER_PROPERTY_PROVIDER_DESTRUCT_HOOK_DATA 8
388 #define _PKCS11H_PROVIDER_PROPERTY_LAST 9
407 IN
void *
const global_data,
408 IN
const unsigned flags,
409 IN
const char *
const format,
418 IN
void *
const global_data
430 IN
void *
const global_data,
431 IN
void *
const user_data,
433 IN
const unsigned retry
447 IN
void *
const global_data,
448 IN
void *
const user_data,
450 IN
const unsigned retry,
451 OUT
char *
const pin,
452 IN
const size_t pin_max
467 IN
void *
const global_data,
468 IN
void *
const user_data,
470 IN
const char *
const label,
471 IN
const unsigned retry,
472 OUT
char *
const pin,
473 IN
const size_t pin_max
476 typedef void (*pkcs11h_provider_destruct_hook_t)(
477 IN
void *
const global_data,
478 IN
const char *
const reference
490 char model[
sizeof (((CK_TOKEN_INFO *)NULL)->model)+1];
494 char label[
sizeof (((CK_TOKEN_INFO *)NULL)->label)+1];
548 IN
const unsigned property,
549 OUT
void *
const value,
550 IN OUT
size_t *
const value_size
563 IN
const unsigned property,
564 IN
const void *
const value,
565 IN
const size_t value_size
574 IN
const unsigned flags
598 IN
const PKCS11H_BOOL safe
610 IN
void *
const global_data
627 IN
void *
const global_data
641 IN
void *
const global_data
655 IN
void *
const global_data
666 IN
const PKCS11H_BOOL allow_protected_auth
677 IN
const int pin_cache_period
688 IN
const unsigned max_retries
706 IN
const char *
const reference,
707 IN
const char *
const provider_location,
708 IN
const PKCS11H_BOOL allow_protected_auth,
709 IN
const unsigned mask_private_mode,
710 IN
const unsigned slot_event_method,
711 IN
const unsigned slot_poll_interval,
712 IN
const PKCS11H_BOOL cert_is_private
722 IN
const char *
const reference
733 IN
const char *
const reference,
734 IN
const char *
const property_str,
735 IN
const char *
const value_str
749 IN
const char *
const reference,
750 IN
const unsigned property,
751 IN
const void * value,
752 IN
const size_t value_size
764 IN
const char *
const reference
775 IN
const char *
const reference
PKCS11H_BOOL(* pkcs11h_hook_key_prompt_t)(IN void *const global_data, IN void *const user_data, IN const pkcs11h_token_id_t token, IN const char *const label, IN const unsigned retry, OUT char *const pin, IN const size_t pin_max)
Key prompt hook.
Definition: pkcs11h-core.h:466
CK_RV pkcs11h_setProtectedAuthentication(IN const PKCS11H_BOOL allow_protected_auth)
Set global protected authentication mode.
CK_RV pkcs11h_setForkMode(IN const PKCS11H_BOOL safe)
How does the foked process bahaves after POSIX fork()
CK_RV pkcs11h_setTokenPromptHook(IN const pkcs11h_hook_token_prompt_t hook, IN void *const global_data)
Set a token prompt callback.
struct pkcs11h_token_id_s * pkcs11h_token_id_t
Token identifier.
Definition: pkcs11h-core.h:397
CK_RV pkcs11h_getProperty(IN const unsigned property, OUT void *const value, IN OUT size_t *const value_size)
Get library property.
CK_RV pkcs11h_logout(void)
Logout from all sessions.
PKCS11H_BOOL(* pkcs11h_hook_pin_prompt_t)(IN void *const global_data, IN void *const user_data, IN const pkcs11h_token_id_t token, IN const unsigned retry, OUT char *const pin, IN const size_t pin_max)
PIN prompt hook.
Definition: pkcs11h-core.h:446
CK_RV pkcs11h_setProviderProperty(IN const char *const reference, IN const unsigned property, IN const void *value, IN const size_t value_size)
Set PKCS#11 provider property.
CK_RV pkcs11h_setSlotEventHook(IN const pkcs11h_hook_slotevent_t hook, IN void *const global_data)
Set a slot event callback.
CK_RV pkcs11h_setProviderPropertyByName(IN const char *const reference, IN const char *const property_str, IN const char *const value_str)
Set PKCS#11 provider property by name.
unsigned int pkcs11h_getFeatures(void)
Get features of library.
PKCS11H_BOOL(* pkcs11h_hook_token_prompt_t)(IN void *const global_data, IN void *const user_data, IN const pkcs11h_token_id_t token, IN const unsigned retry)
Token prompt hook.
Definition: pkcs11h-core.h:429
CK_RV pkcs11h_forkFixup(void)
Handle special case of POSIX fork()
const char * pkcs11h_getMessage(IN const CK_RV rv)
Get message by return value.
void(* pkcs11h_hook_log_t)(IN void *const global_data, IN const unsigned flags, IN const char *const format, IN va_list args)
Log hook.
Definition: pkcs11h-core.h:406
CK_RV pkcs11h_terminate(void)
Terminate helper interface.
CK_RV pkcs11h_setPINCachePeriod(IN const int pin_cache_period)
Set global PIN cache timeout.
unsigned pkcs11h_getLogLevel(void)
Get current log level.
void pkcs11h_setLogLevel(IN const unsigned flags)
Set current log level of the helper.
CK_RV pkcs11h_setPINPromptHook(IN const pkcs11h_hook_pin_prompt_t hook, IN void *const global_data)
Set a pin prompt callback.
CK_RV pkcs11h_setMaxLoginRetries(IN const unsigned max_retries)
Set global login retries attempts.
CK_RV pkcs11h_removeProvider(IN const char *const reference)
Delete a PKCS#11 provider.
CK_RV pkcs11h_initialize(void)
Inititalize helper interface.
CK_RV pkcs11h_registerProvider(IN const char *const reference)
Register a PKCS#11 provider.
CK_RV pkcs11h_initializeProvider(IN const char *const reference)
Initialize a PKCS#11 provider.
void(* pkcs11h_hook_slotevent_t)(IN void *const global_data)
Slotevent hook.
Definition: pkcs11h-core.h:417
unsigned int pkcs11h_getVersion(void)
Get version of library.
CK_RV pkcs11h_setProperty(IN const unsigned property, IN const void *const value, IN const size_t value_size)
Set library property.
CK_RV pkcs11h_setLogHook(IN const pkcs11h_hook_log_t hook, IN void *const global_data)
Set a log callback.
CK_RV pkcs11h_plugAndPlay(void)
Handle slot rescan.
CK_RV pkcs11h_addProvider(IN const char *const reference, IN const char *const provider_location, IN const PKCS11H_BOOL allow_protected_auth, IN const unsigned mask_private_mode, IN const unsigned slot_event_method, IN const unsigned slot_poll_interval, IN const PKCS11H_BOOL cert_is_private)
Register, configure and initialize a PKCS#11 provider.
pkcs11-helper core definitions.
pkcs11-helper engines definitions.
Token identifier.
Definition: pkcs11h-core.h:484
char label[sizeof(((CK_TOKEN_INFO *) NULL) ->label)+1]
Definition: pkcs11h-core.h:494
char manufacturerID[sizeof(((CK_TOKEN_INFO *) NULL) ->manufacturerID)+1]
Definition: pkcs11h-core.h:488
char model[sizeof(((CK_TOKEN_INFO *) NULL) ->model)+1]
Definition: pkcs11h-core.h:490
char serialNumber[sizeof(((CK_TOKEN_INFO *) NULL) ->serialNumber)+1]
Definition: pkcs11h-core.h:492
char display[1024]
Definition: pkcs11h-core.h:486