Yubico libfido2 安装与配置指南

Yubico libfido2 安装与配置指南

1. 项目基础介绍

libfido2 是一个开源项目，由 Yubico 维护，为 FIDO2 设备提供库功能，支持通过 USB 或 NFC 与设备通信，并验证签名。该库支持 FIDO U2F (CTAP 1) 和 FIDO2 (CTAP 2) 协议。项目的主要编程语言是 C。

2. 项目使用的关键技术和框架

libfido2 使用以下关键技术：

• CBOR（ Concise Binary Object Representation）：用于在 FIDO 设备和主机之间传输数据。
• OpenSSL：用于加密和安全性相关的操作。
• zlib：用于数据压缩。
• hidapi：用于与 HID 设备通信。
• libudev（Linux 系统）：用于设备管理。

3. 项目安装和配置的准备工作与详细步骤

准备工作

在开始安装前，请确保您的系统已经安装了以下依赖项：

• CMake：用于构建项目。
• gcc 或 clang：用于编译 C 代码。
• make：用于构建项目。
• OpenSSL 1.1 或更高版本：用于加密功能。
• zlib：用于数据压缩。
• 对于 Linux 系统，还需要 libudev。

安装步骤

以下是在不同操作系统上安装 libfido2 的步骤：

Fedora 34 及以上版本

sudo dnf install libfido2 libfido2-devel fido2-tools

Ubuntu 20.04 (Focal) 及以上版本

sudo apt install libfido2-1 libfido2-dev libfido2-doc fido2-tools

对于 Ubuntu 18.04 (Bionic)，需要添加 Yubico 的 PPA：

sudo apt install software-properties-common
sudo apt-add-repository ppa:yubico/stable
sudo apt update
sudo apt install libfido2-1 libfido2-dev libfido2-doc fido2-tools

macOS

使用 Homebrew 安装：

brew install libfido2

Windows

请访问 Yubico 的发布页面获取适用于 ARM, ARM64, Win32 和 Win64 的安装包。

从源代码构建

对于类 UNIX 系统：

cmake -B build
make -C build
sudo make -C build install

根据平台不同，可能需要安装 pkg-config 或设置 PKG_CONFIG_PATH 环境变量。

完成以上步骤后，您就可以开始使用 libfido2 库进行开发了。如果遇到任何问题，请查看项目文档或在 GitHub 上创建一个 Issue。