企业官网建设流程全解析

Monica 是一款开源的本地密码管理器（Password Management + 2FA Generator），从 Android 14 开始，它不只是帮你存密码和通行密钥（Passkey）的保险箱，更可以直接注册为系统的Credential Provider（凭据提供者）——在浏览器登录网站时，系统弹窗里会出现 Monica Pass 这个选项，用它来创建、保存和使用通行密钥。本文将带你完整体验这个「本地密码管理器变身系统密钥提供者」的过程。

为什么要把 Monica 变成系统 Passkey 提供者？

普通密码管理器通常只是「记录」通行密钥：你在系统里注册完，它把信息存下来。而注册成 Android Credential Provider 后，Monica 直接参与整个流程：

简单来说：你的通行密钥不再「散落在系统里」，而是收进 Monica 的本地库里，随密码一起管理。

Monica 是如何接入 Android 14 凭据系统的？

对感兴趣的同学，Monica 的接入非常标准，核心是三处配置：

1. 注册 Credential Provider 服务：在 AndroidManifest.xml 中声明了MonicaCredentialProviderService，监听系统动作android.service.credentials.CredentialProviderService。
2. 声明能力（capabilities）：配置文件 credential_provider_config.xml 里声明了两类能力——TYPE_PASSWORD_CREDENTIAL（密码自动填充）和TYPE_PUBLIC_KEY_CREDENTIAL（WebAuthn 通行密钥），这是 Google Credential Manager 识别「这是个 Passkey 提供者」的依据。
3. 创建与认证界面：
   • 注册通行密钥时弹出 PasskeyCreateActivity.kt 确认页；
   • 登录验证时由 PasskeyAuthActivity.kt 完成本地签名；
   • 系统「设置 → 密码 → 密码选项」里会显示 Monica 的入口，对应 PasskeySettingsActivity.kt。

此外，Monica 使用固定的 AAGUID6d6f6e69-6361-4d33-a001-706173736b79（即 "Monica Pass"）作为认证器身份，品牌图标与说明见 docs/passkey-provider/README.md 与 aaguid.json。

实战第一步：用 Monica 在网站注册通行密钥

前提：手机为 Android 14（API 34）及以上版本，已安装 Monica 并解锁。

1. 打开支持通行密钥的网站（如 Adobe、Dropbox、Bitwarden 等），点击「使用通行密钥登录/注册」。
2. 系统弹出凭据选择器时，选择 Monica Pass（带彩色应用图标）。
3. Monica 弹出创建确认页：显示网站域名（RP ID）与账号，输入备注名后确认。
4. 完成指纹/面部验证，通行密钥即写入 Monica 本地库——私钥保存在 Android Keystore，公钥返回给网站。

注册成功后，该通行密钥会出现在 Monica 的「通行密钥」列表页，可以像密码一样搜索、移动文件夹、批量管理。

实战第二步：用 Passkey 无密码登录

再次登录同一网站时：

1. 网站发起 WebAuthn 认证请求，系统凭据管理框架把请求发给 Monica。
2. 系统登录选择器中显示 Monica Pass 条目，选中后进入 Monica 的认证确认页。
3. 通过指纹/人脸解锁，Monica 在本地用 Android Keystore 中的私钥完成签名，网站即验证通过。

整个过程中密码从未离开设备，网站拿到的只是一次性的签名证明——这正是通行密钥抗钓鱼的原理：签名与域名绑定，假网站无法复用。

进阶：管理、迁移与跨设备限制

兼容性标记：通行密钥列表会在格式旁显示三种状态标签——

• 仅本地：私钥绑定设备、不可导出；
• 跨端受限：如签名计数非零、备份资格受限，换设备登录将失败；
• 密钥不可用：缺失私钥。

详情里会解释具体原因，相关修复与验证记录见 PASSKEY-COMPATIBILITY-VERIFICATION-2026-10-10.md。

筛选与整理：通行密钥页支持按数据库、文件夹筛选（本地库、MDBX 文件夹、KeePass 分组、Bitwarden/Vaultwarden 文件夹），并支持移动、复制、去重，验证文档见 PASSKEY-FILTER-VERIFICATION-2026-10-10.md。

附近设备同步：同一局域网内可扫码配对，把通行密钥随本地库一起同步给另一台 Monica——不可导出的系统密钥只同步凭据信息，可导出密钥会在接收端重新加密保存，签名计数非零的 Passkey 会被跳过以保证合规。

权限白名单：Monica 还内置了浏览器签名白名单 passkey_privileged_apps.json，校验 Chrome 等浏览器包的 SHA-256 签名指纹，防止伪装应用发起凭据请求。

常见问题 FAQ

Q1：Android 13 或以下能用吗？不能。Credential Provider 是 Android 14（API 34）引入的系统 API，低版本设备不会出现 Monica 选项，但 Monica 仍可正常作为密码管理器使用。

Q2：系统弹窗里 Monica 图标是通用钥匙？这是旧版问题，已修复为彩色 Monica 应用图标（见 testing/passkey-provider-branding.md），升级最新版即可。

Q3：换手机后 Passkey 还能用吗？取决于密钥类型：仅本地/跨端受限的密钥无法在新设备上完成登录（可重新注册）；可导出的密钥通过附近同步、KeePass 或云端库迁移后仍可用。

Q4：与 Google 密码管理器等冲突吗？不冲突。系统凭据选择器会同时列出所有已安装的提供者，由你自由选择；Monica 的凭据交换功能与 Android 8+ 的 Credential Transfer 是两条独立通道，说明见 credential-exchange.md。

小结

Monica 把「通行密钥」从系统黑盒变成了可管理、可迁移、可审计的本地资产。如果你的设备是 Android 14+，强烈建议打开试一次：注册一个网站 Passkey，再用它无密码登录一次，你会明白什么叫真正的一键安全登录。