插槽、令牌、会话、对象的层次结构
PKCS 11 的架构，说白了就是一套虚拟的安全硬件模型。我记得刚接触时，光看规范文档差点被那几个术语绕晕。后来自己动手调了一周的 HSM，才真正理解它们是怎么串起来的。
这套模型把物理密码设备抽象成四个层级：插槽 → 令牌 → 会话 → 对象。每一层都有明确的生命周期和职责。我们先从最外层的插槽讲起。
插槽（Slot）—— 物理端口的抽象
插槽就是设备上的一个物理读卡器或 USB 接口。比如一台 HSM 有四个 USB 口，每个口就是一个插槽。你想想看，插槽本身不存密钥，它只是告诉你“这里可以插一个令牌”。
| 特性 | 说明 |
|---|---|
| 身份 | 逻辑编号，从 0 开始 |
| 状态 | 插槽是否可用、是否有令牌 |
| 信息 | 通过 C_GetSlotInfo 获取 |
我个人习惯把插槽当作“插座”。你插进一个 USB 令牌，这个插槽就“激活”了。在项目中，我遇到过同一个插槽掉电再插上后编号不变，但令牌信息会刷新——嗯，这里要注意别缓存插槽状态太久。
令牌（）—— 真正的“保险柜”
令牌才是存密钥的地方。它可以是智能卡芯片、USB 令牌，或者 HSM 里的一个逻辑分区。每个令牌有自己的 PIN 码、存储空间和密钥属性。
为什么把令牌和插槽分开？我举个例子：你在一台机器上插了五个相同的 USB 令牌，每个令牌的 PIN 都是独立的。插槽只是物理位置，令牌才是安全边界。
令牌的初始化需要调用 C_InitToken，而登录验证用的是 C_Login。这里的坑不少——我曾经在生产环境里忘记在 Login 前调用 C_GetTokenInfo 确认令牌状态，结果卡了半天。
会话（Session）—— 一次打开保险柜的操作
会话是你和令牌之间的操作通道。你打开令牌、做加解密、关闭令牌，整个过程就是一个会话。PKCS 11 支持两种会话模式：只读和读写。
- 只读会话（R/O）：只能读取公开对象，不可修改令牌内容
- 读写会话（R/W）：可以创建、删除、修改私有对象
我刚开始写代码时犯过一个错：为了节省资源，多个线程共用一个会话。结果并发操作导致令牌死锁。后来我给每个线程都创建独立的会话，问题就解决了。会话是轻量级的，不要吝啬。
C_CloseSession 关闭。否则会话泄漏会导致令牌拒绝服务。
对象（Object）—— 保险柜里的资产
对象就是密钥、证书、数据。PKCS 11 把对象分成两大类：数据对象和密钥对象。密钥对象又分公钥、私钥、对称密钥。每个对象都有唯一的句柄，以及 CKA_ 开头的属性列表。
| 对象类型 | 典型 CKA 属性 | 存储位置 |
|---|---|---|
| 数据对象 | CKA_LABEL, CKA_VALUE | 公开区 |
| 公钥 | CKA_MODULUS, CKA_PUBLIC_EXPONENT | 公开区 |
| 私钥 | CKA_PRIVATE_EXPONENT, CKA_SENSITIVE | 私有区（需登录） |
| 对称密钥 | CKA_VALUE_LEN, CKA_ENCRYPT | 私有区 |
这里有个坑：私钥对象的 CKA_SENSITIVE 一旦设为 TRUE，你就再也无法通过 API 读取它的原始值了。我在测试时试着调用 C_GetAttributeValue 去读私钥材料，结果只返回空值。这是设计使然——令牌不允许软件层窃取私钥。
层次关系总览
这四个层级的关系非常像文件系统：一个插槽对应一个令牌，一个令牌上可以开多个会话，每个会话里可以创建和操作多个对象。但你不能同时跨插槽操作——每个操作都绑定在指定插槽的指定令牌上。
这张图里，你从应用程序出发，先选择一个插槽，获取对应的令牌，登录后创建会话，最后在会话里操作各种对象。整个过程必须按顺序来，不能跳过。
实践中容易踩的坑
我总结了几个常见问题，你注意一下：
- 忘记关闭会话：
C_CloseSession没调用 → 令牌资源耗尽。我见过一个系统运行三天后所有新会话都返回 CKR_SESSION_COUNT。 - 跨会话使用令牌对象：在会话 A 创建的对象句柄，拿到会话 B 去用 → 返回 CKR_OBJECT_HANDLE_INVALID。
- 插槽编号假设：不要硬编码插槽编号为 0。某些 HSM 在重启后插槽顺序会变化，应该用
C_GetSlotList动态获取。
好了，这一层结构讲清楚了，后面的章节里我们会逐一深入每个层级的 API 调用细节。先把这张层次图刻在脑子里，这是 PKCS 11 的骨架。