当前位置：首页 > news >正文

如何为Solo1编写扩展应用：完整开发教程与实例

news 2026/4/18 21:35:43

如何为Solo1编写扩展应用：完整开发教程与实例

【免费下载链接】solo1Solo 1 firmware in C项目地址: https://gitcode.com/gh_mirrors/so/solo1

Solo1是一款开源的安全密钥设备，其固件采用C语言编写。本教程将带您了解如何为Solo1安全密钥开发自定义扩展应用，从环境搭建到代码实现，轻松掌握扩展开发的核心技巧。

扩展开发准备工作

在开始编写Solo1扩展之前，需要准备以下开发环境和工具：

硬件准备：
- Solo1安全密钥设备
- Nucleo开发板（如STM32L432型号）
- USB数据线
图：Solo1开发环境中的Nucleo开发板连接示意图
软件环境：
- Git工具（用于克隆代码仓库）
- C语言开发工具链（如GCC）
- 嵌入式开发工具（如OpenOCD）

获取源代码：

git clone https://gitcode.com/gh_mirrors/so/solo1

扩展开发核心步骤

步骤1：了解扩展架构

Solo1的扩展功能主要通过FIDO2协议实现，相关代码位于fido2/extensions/目录下。核心文件包括：

extensions.h：扩展功能的头文件定义
extensions.c：扩展功能的实现代码

步骤2：注册扩展标识符

要创建新扩展，首先需要在CTAP信息中注册扩展标识符，让设备能够识别新扩展。修改ctap.c文件中的ctap_get_info函数：

uint8_t ctap_get_info(CborEncoder * encoder){ // ... 现有代码 ... ret = cbor_encoder_create_array(&map, &array, 3); // 修改数组大小为实际扩展数量 check_ret(ret); { ret = cbor_encode_text_stringz(&array, "hmac-secret"); check_ret(ret); ret = cbor_encode_text_stringz(&array, "credProtect"); check_ret(ret); // 添加自定义扩展标识符 ret = cbor_encode_text_stringz(&array, "ping-pong"); check_ret(ret); } // ... 现有代码 ... }

步骤3：定义扩展数据结构

在ctap.h中扩展CTAP_extensions结构体，添加自定义扩展所需的字段：

typedef struct { uint8_t hmac_secret_present; CTAP_hmac_secret hmac_secret; uint32_t cred_protect; // 添加自定义扩展字段 uint8_t ping_pong_present; char ping_pong_response[4]; } CTAP_extensions;

步骤4：实现扩展解析逻辑

修改ctap_parse.c中的ctap_parse_extensions函数，添加自定义扩展的解析逻辑：

uint8_t ctap_parse_extensions(CborValue * val, CTAP_extensions * ext){ // ... 现有代码 ... else if (strncmp(key, "ping-pong",9) == 0) { if (cbor_value_get_type(&map) == CborTextStringType) { uint8_t txt[5]; sz = sizeof(txt); ret = cbor_value_copy_text_string(&map, (char *)txt, &sz, NULL); check_ret(ret); if(strcmp((const char*)txt, "ping") == 0) { ext->ping_pong_present = 0x01; strcpy((char *)ext->ping_pong_response, "pong"); }else if(strcmp((const char*)txt, "pong") == 0) { ext->ping_pong_present = 0x01; strcpy((char *)ext->ping_pong_response, "ping"); }else{ printf2(TAG_ERR, "Wrong parameter requested. Got %s.\r\n", txt); return CTAP2_ERR_INVALID_OPTION; } }else{ printf1(TAG_RED, "warning: ping-pong request ignored for being wrong type\r\n"); } } // ... 现有代码 ... }

步骤5：构建扩展响应

修改ctap.c中的ctap_make_extensions函数，实现自定义扩展的响应构建：

static int ctap_make_extensions(CTAP_extensions * ext, uint8_t * ext_encoder_buf, unsigned int * ext_encoder_buf_size){ // ... 现有代码 ... if(ext->ping_pong_present){ extensions_used += 1; ping_pong_is_valid = 1; } // ... 现有代码 ... if (ping_pong_is_valid) { { ret = cbor_encode_text_stringz(&extension_output_map, "ping-pong"); check_ret(ret); // 设置响应消息 ret = cbor_encode_text_stringz(&extension_output_map, (const char*)ext->ping_pong_response); check_ret(ret); } } // ... 现有代码 ... }