stoken 技术文档

1. 安装指南

依赖项

在 Linux 系统上编译 stoken 前，需要安装以下依赖项：

• libtomcrypt 或 nettle
• libxml2
• libgtk3.0（仅用于 stoken-gui）

如果从 Git 仓库构建，还需要安装 autoconf、automake 和 libtool，并运行 autogen.sh。如果从发布的源代码压缩包构建，则无需执行此步骤。

在 Debian 或 Ubuntu 系统上，以下命令可以满足大多数依赖项：

sudo apt-get install libgtk-3-dev libtomcrypt-dev libxml2-dev autoconf automake libtool build-essential

编译指令

./autogen.sh  # 仅从 Git 仓库构建时需要
./configure
make
make check
make install

2. 项目的使用说明

首先，从原始字符串或 "sdtid" XML 文件导入令牌：

stoken import --token 2000123456...
stoken import --token com.rsa.securid.iphone://ctf?ctfData=2000123456...
stoken import --file mytoken.sdtid

此操作将提示输入可选密码，以便在磁盘上加密种子。

接下来，使用命令行界面或图形界面显示当前的令牌码：

stoken tokencode
stoken-gui &

使用以下命令查看下一个令牌码：

stoken tokencode --next

如果您的令牌需要 PIN 码，stoken 将提示输入。您可以使用 stoken setpin 将 PIN 码缓存到 ~/.stokenrc。这种方法安全性较低，但可能对自动化操作有所帮助。

现代版本的 OpenConnect 会链接到 libstoken 并发送自动生成的令牌码作为密码。按照上述步骤导入令牌后，使用以下命令：

openconnect -u USERNAME --token-mode=rsa HOSTNAME

有关详细信息，请查阅 man 页面：stoken(1)、stoken-gui(1)。

在 examples/ 和 src/stoken.h 中查看使用共享库接口（libstoken）从其他应用程序生成令牌码的信息。

3. 项目 API 使用文档

stoken 项目包含一个共享库接口（libstoken），允许其他软件按需生成令牌码。关于如何使用这个接口的详细信息可以在项目的 examples/ 和 src/stoken.h 文件中找到。

4. 项目安装方式

项目的安装方式已在安装指南中提供，包括依赖项安装、编译和安装步骤。请按照以下步骤进行安装：

./autogen.sh  # 仅从 Git 仓库构建时需要
./configure
make
make check
make install

确保在安装前满足所有依赖项，并根据系统的不同可能需要调整编译参数。