使用Python PKCS11模块时遭遇KeyError: 'PKCS11_MODULE'错误求助

1. 修复PKCS11_MODULE环境变量缺失问题 #

方法一：临时设置环境变量 #

在运行Python脚本的终端中，先执行以下命令（替换为你的PKCS#11库路径，以SoftHSM2为例）：

export PKCS11_MODULE=/usr/lib/softhsm/libsofthsm2.so

之后再运行你的Python脚本。

方法二：永久设置环境变量 #

将环境变量添加到shell配置文件中（比如~/.bashrc）：

echo 'export PKCS11_MODULE=/usr/lib/softhsm/libsofthsm2.so' >> ~/.bashrc
source ~/.bashrc

方法三：直接在代码中指定库路径 #

如果不想依赖环境变量，可以修改代码，直接传入PKCS#11库的绝对路径：

import pkcs11

# 替换为你的PKCS#11库实际路径
lib = pkcs11.lib('/usr/lib/softhsm/libsofthsm2.so')
token = lib.get_token(token_label='DEMO')

# 后续代码保持不变
data = b'INPUT DATA'
with token.open(user_pin='1234') as session:
    pub, priv = session.generate_keypair(pkcs11.KeyType.RSA, 2048)
    crypttext = pub.encrypt(data)

2. 创建并配置DEMO令牌（以SoftHSM2为例） #

如果你的系统中没有名为DEMO的PKCS#11令牌，可以用SoftHSM2（软件模拟的PKCS#11设备）来创建：

• 安装SoftHSM2：

sudo apt update && sudo apt install softhsm2

• 创建令牌存储目录：

mkdir -p ~/softhsm-tokens

• 修改SoftHSM2配置文件，指定令牌目录：
  编辑/etc/softhsm2.conf，添加或修改以下行（替换your-username为你的Ubuntu用户名）：

directories.tokendir = /home/your-username/softhsm-tokens

• 初始化DEMO令牌：

softhsm2-util --init-token --slot 0 --label "DEMO" --pin 1234 --so-pin 123456

• 验证令牌是否存在：

softhsm2-util --show-slots

执行后应该能看到标注label: DEMO的插槽信息。

内容的提问来源于stack exchange，提问作者Mack Osborne