YubiKey个性化工具技术文档

1. 安装指南

1.1 依赖关系

YubiKey个性化工具依赖于以下软件包：

• Yubico-c：用于与YubiKey交互的库和命令行工具。
• libusb 或 libusb-1：用于与YubiKey硬件通信的库。
• json-c：可选依赖，用于生成美观的JSON输出。

根据您的操作系统，安装依赖关系的方法会有所不同。以下是一些常见操作系统的安装示例：

• Debian/Ubuntu：使用 apt-get 安装依赖。

  apt-get install libyubikey-dev libusb-1.0-0-dev libjson-c-dev
  apt-get install pkg-config asciidoc xsltproc docbook-xsl
  apt-get install autoconf automake libtool
  

• Fedora：使用 dnf 安装依赖。

  dnf install libyubikey-devel libusb-devel json-c-devel
  

1.2 从Git构建

如果您使用的是Git版本，可以执行以下命令克隆仓库：

git clone https://github.com/Yubico/yubikey-personalization.git
cd yubikey-personalization
autoreconf --install
./configure
make check install

2. 项目使用说明

YubiKey个性化工具用于设置YubiKey的AES密钥。请注意，使用此工具将破坏YubiKey中的AES密钥，使其无法对抗Yubico的验证服务器。

在运行需要访问YubiKey的任何工具时，您需要以root用户身份运行，或者确保当前用户有权访问设备。这可以通过复制udev规则文件（69-yubikey.rules 和 70-yubikey.rules）到 /etc/udev/rules.d/ 来实现。

3. 项目API使用文档

以下是YubiKey个性化工具的一些使用示例：

3.1 编程YubiKey

使用以下命令为YubiKey设置一个全零的AES密钥和虚拟前缀：

./ykpersonalize -1 -ofixed=cccccccccccc -a00000000000000000000000000000000

3.2 静态模式编程

要使用静态模式编程YubiKey，可以使用 -ostatic-ticket 选项：

./ykpersonalize -1 -ofixed=cccccccccccc -a00000000000000000000000000000000 -ostatic-ticket

3.3 设置锁码

要为YubiKey设置锁码，可以使用 -oaccess= 选项：

./ykpersonalize -1 -ofixed=vvvecdcedvjj -a00000000000000000000000000000000 -oaccess=001100001100

4. 项目安装方式

请遵循以下步骤安装YubiKey个性化工具：

1. 安装依赖项。
2. 从Git克隆项目。
3. 构建和安装项目。

git clone https://github.com/Yubico/yubikey-personalization.git
cd yubikey-personalization
autoreconf --install
./configure
make check install