如何用CMake构建SoftHSM2并链接其PKCS#11接口至自定义应用？

前提条件 #

确保SoftHSM已完成安装，系统中存在PKCS#11的头文件（通常为pkcs11.h）和SoftHSM的PKCS#11库文件（常见名称为libsofthsm2.so或libpkcs11.so）。如果是手动编译安装的SoftHSM，注意记录安装路径（比如/opt/softhsm）。

方法一：使用pkg-config（推荐） #

如果SoftHSM安装后提供了.pc配置文件，用pkg-config可以简化CMake配置：

# 确保pkg-config可用
find_package(PkgConfig REQUIRED)

# 查找SoftHSM的PKCS#11包
pkg_check_modules(PKCS11 REQUIRED IMPORTED_TARGET softhsm2)

# 定义你的自定义应用目标
add_executable(your_custom_app main.cpp)

# 将PKCS#11库链接到目标应用
target_link_libraries(your_custom_app PRIVATE PkgConfig::PKCS11)

方法二：手动查找库和头文件 #

如果没有pkg-config支持，可手动指定查找路径：

# 查找PKCS#11头文件
find_path(PKCS11_INCLUDE_DIR NAMES pkcs11.h
          PATHS /usr/include /usr/local/include /opt/softhsm/include)

# 查找SoftHSM的PKCS#11库文件
find_library(PKCS11_LIBRARY NAMES softhsm2 pkcs11
             PATHS /usr/lib /usr/local/lib /opt/softhsm/lib)

# 验证查找结果
if(NOT PKCS11_INCLUDE_DIR)
    message(FATAL_ERROR "未找到PKCS#11头文件pkcs11.h")
endif()
if(NOT PKCS11_LIBRARY)
    message(FATAL_ERROR "未找到SoftHSM的PKCS#11库文件")
endif()

# 定义应用目标
add_executable(your_custom_app main.cpp)

# 添加头文件目录
target_include_directories(your_custom_app PRIVATE ${PKCS11_INCLUDE_DIR})

# 链接库文件
target_link_libraries(your_custom_app PRIVATE ${PKCS11_LIBRARY})

运行时库路径配置 #

为避免运行时找不到库的问题，可设置目标的运行时搜索路径：

set_target_properties(your_custom_app PROPERTIES
                      INSTALL_RPATH ${PKCS11_LIBRARY_DIRS}
                      BUILD_WITH_INSTALL_RPATH TRUE)

常见问题排查 #

• 如果找不到库或头文件，检查find_path和find_library的PATHS参数，替换为你的SoftHSM实际安装路径。
• 确认编译SoftHSM时未禁用PKCS#11接口（默认启用）。
• 链接时出现未定义符号，检查代码是否正确调用PKCS#11的标准接口，或者SoftHSM库版本是否匹配。

内容的提问来源于stack exchange，提问作者Shreenivas C Boodi