Olares 身份钱包 LarePass:Olares ID 与可验证凭证(VC)的自主管理实战指南
Olares 身份钱包 LarePass:Olares ID 与可验证凭证(VC)的自主管理实战指南
LarePass 是 Olares(Terminus)的官方数字身份钱包应用,承载着基于 Olares ID 的去中心化身份的创建、备份、导入与可验证凭证(VC)管理全流程。本文从自主主权身份(SSI)生态出发,结合仓库源码与官方手册,系统讲解 LarePass 如何管理 Olares ID、签发与呈现 VC,以及与 Olares 系统的无缝交互,帮助你掌握从助记词备份到身份激活的完整安全实践。
什么是身份钱包:SSI 生态的核心工具
数字身份钱包是自主主权身份(SSI)生态的重要基础设施。与依赖中心化机构(如邮箱服务商、身份认证平台)签发、托管身份的传统模式不同,SSI 允许用户无需任何中心化机构即可自主管理三类核心资产:
- 去中心化标识符(DID):全球唯一、可密码学验证、无需中心化注册的标识符;
- 可验证凭证(VC):由签发者(Issuer)签发的、防篡改的声明文件,如学历证书、邮箱归属证明;
- 与数字服务的交互:按需向验证方(Verifier)呈现凭证,验证身份主张。
在 Olares 项目中,这一角色由 LarePass 承担。它是 Olares 的官方身份钱包客户端,为基于 Olares ID 的自托管去中心化操作系统提供安全、便捷的身份管理与访问能力:既可用于创建和管理 Olares ID、激活 Olares,也可在手机和电脑上随时随地访问 Olares 设备(参见 LarePass 概览)。
LarePass 覆盖多个平台:iOS、Android、macOS、Windows、Linux(Beta,仅支持 x86_64 架构且需图形桌面环境),以及 Chrome 浏览器扩展。其中移动端可直接创建新 Olares ID,桌面端与浏览器扩展则支持导入已有账户。
身份技术底座:DID 与 Olares ID
理解 LarePass 的管理功能之前,需要先掌握它背后的两个核心身份模型:DID 与 Olares ID。
DID 的结构与派生
去中心化标识符(DID) 由 W3C DID Core 规范定义,是一种自主管理、全球唯一且无需中心化注册即可验证的标识符,可指向个人、组织、物品、数据模型或抽象实体等任何主体(详见 DID 概念)。一个 DID 由三部分组成:
| 组件 | 说明 |
|---|---|
| DID URI 方案标识 | 指明标识符的格式,固定为 did |
| DID 方法标识 | 指定用于创建 DID 的协议/方法,例如 key、jwk、dht |
| 方法专属标识(Method-Specific ID) | 方法内部唯一标识 |
在仓库的 DID 解析实现 中,可以看到严格遵循 W3C DID Core ABNF 语法规则实现的 DID URI 解析器:它通过正则 ^did:([a-z0-9]+):... 拆解出方法(Method)、方法专属 ID、参数(Params)、路径(Path)、查询(Query)与片段(Fragment),并提供序列化/反序列化能力,是上层凭证签名与身份解析的基础设施。
DID 在 Olares ID 中的派生遵循类似区块链地址的助记词算法,为自生成流程:
助记词 → 私钥 → 公钥 → DID 链上地址
- 助记词(Mnemonic):随机生成的 12 个英文单词,用于派生私钥;
- 私钥(Private Key):由助记词派生,需妥善保管,用于生成公钥与链上地址;
- 公钥与链上地址:由私钥计算得出,可公开分享,链上地址用于 DID 注册。
这一流程在 DID 密钥派生实现 中有完整代码对应:通过 bip39.NewEntropy(128) 生成 128 位熵,进而生成 12 词 BIP39 助记词;NewHDWalletFromMnemonic 基于 BIP39 种子构建 HD 分层确定性钱包;GetPrivateJWKTrustWalletCore 使用 Ed25519 密钥对生成 did:key 格式的 DID(multicodec 标识 0xed + base58btc 编码的公钥),并输出符合 JWK 规范的公私钥对。
Olares ID:人类可读的 DID 外壳
DID 虽然安全,但难以记忆。Olares ID 采用类似邮箱的可读格式(如 alice123@olares.com),为 DID 提供了易读易记、便于分享的封装,同时保持 DID 的加密安全与可验证性(详见 Olares ID 概念)。
Olares ID 由两部分组成:
- 本地名(前缀):如
alice123,长度 8-24 个字符,在域内唯一; - 域名(后缀):如
olares.com,决定 ID 的类型归属。
Olares 提供三类域名:
| 类型 | 说明 |
|---|---|
| 个人域名 | 供个人使用,目前提供默认域名 olares.com |
| 组织域名 | 供企业/组织使用,长度 2-24 个字符,管理员可在成员离职时回收 |
| 实体域名 | 供应用或其他无法归类为个人/组织的实体使用 |
创建 Olares 账户时,系统会先生成 DID 并绑定至新的 Olares ID,二者通过 VC 建立加密关联。
管理 Olares ID:创建、备份、多身份
LarePass 围绕 Olares ID 提供三组核心能力:创建、备份/导入、多身份管理。下图即 LarePass 中 Olares ID 创建与管理界面的示意:
创建 Olares ID
LarePass 支持两种创建方式(详细步骤见 创建 Olares ID):
- 快速创建(无需 VC 绑定):在移动端 LarePass 点击创建账号,设置 ID 后直接生成。适用于对可信身份绑定没有要求的个人场景;
- 高级创建(绑定 VC):通过可验证凭证将现有可信身份(如邮箱)绑定至 Olares ID,目前支持 Gmail Issuer Service。适用于需要证明身份归属、防止抢注的场景。
中国大陆用户需注意:如果手机系统语言为英文,请在高级创建选项中选择 .cn 域名。如需使用自定义域名(组织场景),可参考 使用自定义域名创建 Olares ID。
Gmail Issuer Service 签发流程(详见 Olares 的 VC 流程设计):
- 用户在 LarePass 中通过 Google OAuth 登录 Gmail 账户;
- Google 将 OAuth 凭证返回给 LarePass;
- LarePass 将 OAuth 凭证提交给 Issuer(签发方);
- Issuer 与 Google 服务器确认凭证有效性并检索基本信息(如邮箱名称);
- Issuer 向用户签发与其 Gmail 地址本地部分匹配的 VC,例如
hello@gmail.com最终获得hello@olares.com。
整个过程用户仅向 LarePass 与 Issuer 服务透露凭证授权范围内的基本账户数据,密码与隐私由 Google OAuth 协议保障。
备份与导入:助记词是恢复账户的唯一方式
助记词是由 12 个单词组成的序列,是恢复 Olares ID 的唯一方式。设备丢失或需要在新设备导入 Olares 账号时,只能依靠助记词重新获得访问权限(详见 备份助记词)。
首次导出或备份助记词时,系统会提示为 LarePass 设置本地密码,该密码仅用于解锁当前设备上的 LarePass 服务,同一设备的所有 Olares ID 共用一个本地密码,不同设备间相互独立。设置后还可开启生物识别解锁(面部识别或指纹)。
备份流程:进入设置 > LarePass 设置 > 安全 > 助记词,阅读风险提示后查看 12 个助记词(需输入本地密码验证),按序记录并排列验证。
安全要点:
- 切勿与任何人分享助记词,强烈建议离线备份(如手写存放在保险箱);
- 点击复制保存到剪贴板存在安全风险,应避免;
- 可借助 LarePass 的保险库(Vault)功能在多个设备上加密保存助记词,只有当所有设备都丢失时才可能失去助记词;
- 若查看助记词时提示密码错误,通常是尚未设置本地密码,先进入安全页面设置后再尝试。
多身份管理:导入、切换、删除
LarePass 支持同时管理多个 DID / Olares ID,并可在移动端、桌面端与 Chrome 扩展中随时切换(详见 在 LarePass 中管理账户)。
导入账户:在新设备或其他客户端使用已有 Olares ID 时,通过输入 12 个助记词导入:
- 移动端:点击头像 → 切换账户页面底部添加新账户 → 导入账户 → 输入助记词;
- 桌面端:点击头像 → 切换账户 → 底部添加新账户 → 输入助记词;
- Chrome 扩展:点击工具栏图标 → 导入账户 → 输入助记词(可跳过功能介绍)。
切换账户:移动端从主界面头像或账户创建过程中进入切换账户页面选择账户;桌面端点击头像 → 切换账户;扩展中点击或悬停右下角头像,在账户列表中选择。
删除账户:删除前必须先备份助记词,未备份的账户无法删除:
- 移动端:头像 → 切换账户 → 右上角清单图标 → 选择账户 → 删除图标并确认;
- 桌面端:头像 → 设置 → 账户 → 管理账户 → 删除账户并确认;
- Chrome 扩展:设置(settings)→ Account → Delete → 确认。
管理可验证凭证(VC)
可验证凭证(VC) 是 W3C 已正式推荐的标准:实体在通过 DID 标识自身后,可对自身的多项"声明"提供佐证文件,这些文件即 VC。以学历为例:Alice 的毕业证书由其就读大学(Issuer)签发,可通过密码学方式安全验证;求职时用人单位(Verifier)可在面试中验证该凭证(详见 VC 概念)。
VC 的三个角色
- Issuer(签发者):对主体(Subject)做出声明并签发 VC 的实体,例如大学;
- Holder(持有者):持有一个或多个 VC 并向 Verifier 提交证明的实体,例如 Alice——她通过钱包应用(LarePass)存储与管理 VC;
- Verifier(验证者):通过 Presentation Definition 指定所需证明并验证提交材料的实体,例如面试公司。
六步验证流程
- Issuer 注册 DID:Issuer 将其信息注册到 DID Registry;
- Holder 发起请求:Holder 向 Issuer 发送凭证签发请求;
- Issuer 签发 VC:Issuer 向 Holder 颁发含声明的 VC;
- Holder 存储 VC:Holder 将 VC 安全存储于 LarePass;
- 提交 VP:Holder 生成包含 VC 的 Verifiable Presentation(VP,可验证表述) 并发送给 Verifier;
- Verifier 验签:Verifier 通过 DID Registry 校验 VC 与 VP 的签名,确认声明有效。
需要注意:VC 本身并不存储在区块链上,区块链仅承担 DID 注册与签名校验的锚定角色。
LarePass 的 VC 全流程能力
LarePass 支持绑定至 Olares ID 的 VC 全流程操作:
- 签发与存储:安全保存来自 Issuer 的 VC(例如通过 Gmail Issuer Service 获得的邮箱归属凭证);
- 验证与呈现:按需向 Verifier 提交 Verifiable Presentation(VP);
- 发现与检索:便捷查看各身份对应的 VC 列表,支持多身份维度检索。
从源码层面看,仓库在 VC 数据模型实现 中完整复刻了 W3C Verifiable Credential Data Model:DataModel 包含 @context、type、issuer、credentialSubject、id、issuanceDate、expirationDate、credentialSchema、evidence 等标准字段,基础类型固定为 https://www.w3.org/2018/credentials/v1 上下文与 VerifiableCredential 类型;DID Document 实现 则定义了 verificationMethod、assertionMethod(用于签发 VC 时表达声明)、authentication、keyAgreement 等密钥用途分类;此外仓库还包含 Presentation Exchange 的实现(pexv2 模块),用于按 Presentation Definition 组织凭证呈现。
Olares 端还提供 VC 服务层与验证方服务设计,涵盖 Issuer、Verifier、Credential Manifest、Presentation Definition 等完整术语体系与协议规范,可参见 VC 服务文档。Olares ID 验证方服务在收到用户的 DID、Olares ID 与 VC 打包而成的 VP 后,会依次校验签名有效性、VC 有效性以及 Olares ID 是否可在区块链注册,全部通过后提交链上注册并支付 Gas 费用。
与 Olares 的无缝交互
LarePass 不只是身份钱包,也是连接 Olares 设备的日常入口,其核心交互能力包括:
- 激活与重新激活 Olares:安装 Olares 后,使用 LarePass 点击扫描二维码扫描向导页面二维码完成激活,并重置登录密码(需手机与 Olares 处于同一网络)。重装系统后可用同一 Olares ID 重新激活,无需创建新 ID,流程详见 激活 Olares;
- 随时随地访问:开启 LarePass 专用网络后,应用借助 Tailscale 建立安全连接:居家走局域网(LAN)直连、外出走点对点(P2P)加密隧道;未开启时流量经 Cloudflare 或 FRP 公网转发。连接状态在应用内以 Internet / Intranet / FRP / DERP / P2P / Offline 形式展示,便于诊断网络,详见 通过 LarePass 专用网络访问 Olares;
- 设备管理:在设置 > 我的 Olares 卡片中可查看硬件与系统信息、更新系统、远程重启/关机、切换有线与 Wi-Fi 网络、甚至恢复出厂设置(需输入本地解锁密码),详见 使用 LarePass 管理 Olares;
- Vault 保险库:LarePass 内置 Vault,可加密保存网站密码、数据库密码、区块链私钥等敏感数据;还可作为身份验证应用生成基于时间的一次性密码(TOTP),为 GitHub、OpenAI 等网站提供双因素认证(2FA),详见 生成双因素身份验证代码。
从密钥管理架构看,Olares 将敏感数据按风险等级分层:Vault 项目(密码、私钥等)存于加密 Vault 且每次使用需 LarePass 签名;系统访问凭据存于 Infisical;Pod 级密钥存于 ETCD(详见 密钥管理)。LarePass 的 Vault 正是整个密钥体系中最私密层级的载体。
安全最佳实践
- 助记词即身份:丢失助记词将失去 DID 与 Olares ID 的所有权,且无法访问保险库中加密保存的数据;备份后务必离线保存,切勿截图、拍照或分享;
- 本地密码与生物识别:为 LarePass 设置独立本地密码并开启生物识别解锁,密码只作用于当前设备;
- 删除账户先备份:未备份助记词的账户无法删除,这是系统级的强制安全约束;
- 激活时同网:激活与重新激活 Olares 时,手机与设备须处于同一网络,避免激活失败。
深入阅读
- Olares ID 概念:ID 格式、域名类型与 DID 的绑定关系
- 去中心化标识符(DID):DID 结构与助记词派生流程
- 可验证凭证(VC):角色定义与六步验证流程
- 创建 Olares ID:移动端快速创建与高级创建
- 备份助记词:12 词助记词的备份与恢复
- 在 LarePass 中管理账户:导入、切换与删除账户
- 使用自定义域名创建 Olares ID:组织级身份管理
- VC 服务文档:Issuer / Verifier / PEX 协议体系

