IBio

A DIY FIDO2 key with biometric (fingerprint) verification.

项目概述

IBio 是一个开源的 FIDO2 安全密钥项目，旨在通过生物识别（指纹）验证增强身份认证的安全性。该项目允许用户自行制作一个支持 FIDO2/WebAuthn 标准的硬件安全密钥，用于在各种在线服务中进行无密码认证。

核心特性

• FIDO2/WebAuthn 标准：符合国际认证标准，支持主流浏览器和服务
• 生物识别验证：集成指纹传感器，提供便捷且安全的身份验证
• 开源硬件：硬件设计完全开源，用户可自行制作和定制
• 低成本方案：使用常见的硬件组件，降低制作成本

技术栈

（已确定 - 2026-04-06）

类别	技术选项	型号	状态	成本（预估）
主控芯片	ESP32-S3	ESP32-S3-WROOM-1	已确定	$5-8
指纹传感器	FPM383C	电容式指纹模块	已确定	$10-15
通信接口	USB-C + BLE	内置 USB + BLE 5.0	已确定	$0（内置）
安全芯片	ATECC608A	Microchip 安全芯片	已确定	$1-2
开发语言	C	C11 标准	已确定	-
固件框架	FreeRTOS	ESP-IDF 内置	已确定	-
开发环境	VS Code + PlatformIO	跨平台 IDE	已确定	-

总成本估算：$21-31（核心硬件 + PCB）

项目结构

IBio/
├── LICENSE          # 项目许可证文件
├── README.md        # 项目说明文档
├── docs/            # 设计文档和参考资料（待创建）
├── hardware/        # 硬件设计文件（待创建）
├── firmware/        # 固件源代码（待创建）
├── tests/           # 测试用例（待创建）
└── tools/           # 开发工具和辅助脚本（待创建）

注意：当前项目处于初始化阶段，大部分目录尚未创建，将在后续任务中逐步完善。

开发指南

环境配置

（待补充 - 需要确定技术栈后编写）

构建与运行

（待补充 - 需要确定技术栈后编写）

测试

（待补充 - 需要确定技术栈后编写）

当前任务

任务 1：确定设计架构和硬件选择

状态：已完成 优先级：P1 完成时间：2026-04-06 目标：

• 确定项目的整体架构设计（系统架构、模块划分、数据流）✓
• 选择合适的硬件平台和组件（处理器、指纹传感器、安全芯片、通信模块）✓
• 制定技术选型方案（开发语言、框架、工具链）✓

输出文档：

• docs/HLD.md - 系统架构设计文档
• docs/adr/ADR-001-architecture-choice.md - 架构决策记录
• docs/hardware-list.md - 硬件清单文档
• docs/research/fido2-requirements.md - FIDO2 标准需求分析
• docs/research/hardware-research.md - 硬件平台调研报告
• docs/research/tech-stack-selection.md - 技术栈选型对比

任务规划

任务阶段	主要内容	预计时间
1. 需求分析	理解 FIDO2 标准、分析功能需求	2-3 小时
2. 硬件调研	调研可选硬件组件、评估性能和成本	3-4 小时
3. 架构设计	设计系统架构、模块划分	2-3 小时
4. 文档输出	编写设计文档、硬件清单	1-2 小时

参考资料

• FIDO2 标准
• WebAuthn 规范
• CTAP 协议

许可证

本项目采用开源许可证，具体条款请参见 LICENSE 文件。

贡献指南

欢迎社区贡献！请在提交 PR 前阅读贡献指南（待创建）。

联系方式

• 项目维护者：[待补充]
• GitHub：https://github.com/LineCatOvO/IBio