Figma 无密码登录(Passkey / WebAuthn)、生物识别(Face ID / 指纹)与安全认证组件交付实战:多端系统弹窗对齐、错误降级状态机与 Dev Mode 交付指南

2026 年 11 月 22 日

随着苹果、Google、微软以及国内外金融与头部 SaaS 平台全面普及 Passkey(通行密钥,基于 FIDO2 / WebAuthn 标准),无密码生物识别登录已成为高安全业务的标准配置。但在实际产品研发过程中,许多设计师在 Figma 中画 Passkey 与 Face ID / Touch ID / 指纹登录界面时,最容易踩中三个致命误区:

  1. 在画布上“强行自画”系统级生物识别弹窗:花费大量时间手绘一个苹果 Face ID 扫描框或浏览器 Passkey 选择器,结果交付给开发后才被告知 iOS / Android / Chrome 的系统鉴权窗由操作系统内核或浏览器全权托管,App 与网页既不能修改其圆角和文案,也无法拦截点击事件;
  2. 只画了“验证成功直接进首页”的理想路径:完全遗漏了“用户取消系统弹窗”“换了新手机还没同步通行密钥”“电脑没配指纹只能用手机蓝牙跨设备扫码(Hybrid Transport)”等真实高频分支;
  3. 按钮图标与加载态抖动错位:点击“使用 Passkey 登录”后按钮变为 Loading 状态,由于未对 Auto Layout(自动布局) 做好固定宽度与双态切换约束,整个登录卡片宽度突然坍缩跳变。

要在 Figma 中打造一套既符合安全规范、又能让前后端与客户端工程师零歧义落地的 Passkey / 生物识别登录体系,必须明确 “自定义 UI 边界 vs 系统托管边界”,并构建完整的 6 态降级状态机。


一、三端系统原生弹窗边界对比:Figma 里哪些能画、哪些只能标? #

在搭建组件库之前,设计师必须先与客户端和前端团队对齐系统接管范围。以下表格清晰界定了不同平台下哪些界面由设计师在 Figma 中可控,哪些属于仅作流程示意(System Sheet Placeholder):

平台环境 系统底层能力 设计师可自定义区域(App / Web UI) 系统强制接管区域(不可自定义样式) Figma 画布推荐表达方式
iOS / iPadOS ASAuthorizationController(Face ID / Touch ID / iCloud 钥匙串) 登录页按钮、引导开通 Banner、生物识别绑定开关、报错提示条 顶部灵动岛 Face ID 识别动画、系统底部 Passkey 账号选择器弹窗 用半透明虚线框或官方 iOS 系统弹窗模板标注 [System Managed Sheet]
Android 14+ Credential Manager(指纹 / 人脸 / Google 密码管理器) 触发按钮、账号选择前引导弹窗、兜底短信/密码页 系统原生 Credential Manager 底部抽屉(同时聚合 Passkey 与密码) 使用 Material 3 底部抽屉占位组件并锁定不可改颜色
桌面/移动浏览器 WebAuthn(navigator.credentials.get/create) Conditional UI(输入框自动填充条) 样式、主登录按钮、二维码触发按钮 浏览器顶部/居中原生密钥弹框(选择本机密钥 / 手机扫码 / 硬件安全密钥) 区分 Modal 模式 与 Autofill 条件提示条 两种原型分支

关键原则:所有标注为 System Managed 的图层,建议在图层树上统一加上 _system_ 前缀,并在 Dev Mode(开发模式) 中写明注释“由系统内核唤起,请勿按图自绘自定义弹窗”,避免外包或初级前端按静态图硬编码出假冒弹窗。


二、实操一:搭建高可用 Passkey 登录组件与防抖动 Auto Layout 架构 #

一个生产级的 Passkey 认证模块,通常包含主触发按钮、条件式输入框自动填充(Conditional UI)以及绑定引导横幅三个核心组件。

1. Passkey 主按钮与 4 态防抖动配置 #

  1. 新建组件集(Component Set)命名为 Auth/PasskeyButton,设置核心属性(详见 创建与使用变体):
    • State: Default | Hover | Authenticating | Success | Error
    • Platform: Universal(通用钥匙盾徽标)| FaceID(iOS)| Fingerprint(Android)
  2. 防坍缩 Auto Layout 锁宽技巧:
    • 将按钮外层设为水平 Auto Layout,Height 设为固定 48px(满足移动端 44pt / 48dp 触控热区要求),在登录表单场景中将水平尺寸设为 Fill container;
    • 当切换至 Authenticating(等待系统弹窗响应)态时,用居中旋转 Loading 图标替换左侧 Passkey 图标,文案变为“正在验证身份…”,按钮保持禁用态防止用户重复触发 NotAllowedError(并发请求冲突报错)。
  3. 按钮文案规范:禁止在跨平台网页端硬写死“使用 Face ID 登录”(Windows 与部分桌面浏览器用户没有 Face ID),统一使用 “使用通行密钥(Passkey)登录” 或根据 Platform 变量动态切换文案。

2. 浏览器 Conditional UI(输入框免跳转自动识别)组件 #

现代 WebAuthn 最佳实践支持用户在点击传统“邮箱/用户名”输入框时,浏览器直接在下拉列表中展示已保存的 Passkey(无需再单独点“Passkey 登录”按钮):

  1. 基于 安全输入框与校验组件规范 复用标准输入框架;
  2. 使用绝对定位(Absolute Position)在输入框正下方挂载一个高度为 56px 的联想胶囊槽(Passkey Autofill Suggestion),标注浏览器 autocomplete="username webauthn" 属性;
  3. 原型交互上,点击输入框即可直接唤起 Passkey 选项并跳过密码输入步,大幅缩短登录漏斗路径。

三、实操二:6 态异常与降级状态机建模(防止用户被“锁死在门外”) #

Passkey 体验好坏,80% 取决于异常与降级流转是否顺滑。换了新手机、公司电脑禁止蓝牙、用户不小心点了系统弹窗的“取消”——如果这些边界分支没有在 Figma 画布上画全,上线后就会造成大量客服工单。

建议在画布中使用独立 Section 完整串联以下 6 态安全闭环状态机:

状态分支名称 触发条件 / 底层异常码 界面呈现与反馈设计规范 用户下一步安全逃生出口(Fallback)
S1 首次登录成功引导开通(Enrollment Nudge) 用户用密码/验证码成功登录后,检测到设备支持生物识别且尚未绑定 Passkey 弹出非阻塞式引导卡片(展示“下次用面容/指纹 1 秒登录”),明确说明**“密钥仅存本机加密芯片”** 提供“立即开启”与“以后再说(7 天内不再提示)”双出口
S2 用户主动取消系统弹窗 弹窗拉起后用户点击 Cancel 或误触空白关闭(浏览器抛出 NotAllowedError) 绝不要用红色报错弹窗吓唬用户! 按钮立即恢复可点击态,仅在按钮下方展示温和中性灰提示:“已取消验证,可重试或改用密码” 允许立刻再次点击重试,或平滑切换密码/OTP 登录(参考 OTP 验证码组件实战)
S3 当前设备未找到匹配通行密钥 用户在全新电脑/临时设备上点击 Passkey,本机钥匙串无记录 自动引导走 跨设备混合认证(Hybrid / 手机扫码登录) 弹窗,提示“用已登录的手机扫描二维码验证” 一键切回“手机验证码 / 邮箱密码 + 2FA”标准登录
S4 生物识别连续失败(硬件锁死) Face ID 戴口罩遮挡或湿手指纹连续 3~5 次失败 系统内核会自动弹出 输入设备锁屏 PIN 码 / 开机密码 兜底视图,App 内无需自建重试计数 系统锁屏密码校验通过即直接放行,彻底失败才回退应用密码
S5 企业设备策略禁用了蓝牙/通行密钥 公司内网电脑关闭了蓝牙(无法跨设备扫码)或组策略禁用 FIDO2 前端通过 PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable() 探测为 false 后,动态折叠隐藏“本机生物识别”入口 仅保留手机扫码或企业 SSO 登录(详见 企业权限与登录安全合规)
S6 账号安全中心解绑与多设备管理 用户手机丢失、出售旧设备或需要撤销某个浏览器密钥 在个人中心“安全设置 → 通行密钥管理”列表,展示 设备图标 + 创建时间 + 上次使用时间 + 重命名/删除操作 删除最后一个 Passkey 前,强制校验账号当前仍保留密码/手机等至少一种找回方式

四、Variables 语义状态变量与 Dev Mode WebAuthn 代码对齐 #

为了在 Figma 中一键预览上述安全分支并确保前端准确实现,建议配合 Variables(变量) 与 Dev Mode Annotations 完成以下交付配置:

1. 构建 Auth_Flow_State 调试变量集 #

在本地变量集合中建立以下控制变量,方便产品与测试同学在 Figma 原型里一键演示各种边界场景:

  • auth/passkey-supported(Boolean):控制当前画布是否显示“一键 Passkey 登录”推荐按钮;
  • auth/error-code(String):枚举 none / user_canceled / no_credential / hardware_locked,直接绑定提示文本组件(Alert Banner)的显隐与状态文本;
  • auth/device-count(Number):控制安全管理页中已绑定 Passkey 数量,当减至 1 时自动把“删除按钮”切换为二次确认警告态。

2. Dev Mode 前端 WebAuthn 核心契约标注 #

在登录按钮与输入框的 Dev Mode Annotations 中,为前端开发附上关键浏览器 API 与数据结构对齐说明:

// 1. 探测当前设备是否支持本地生物识别通行密钥(决定 UI 是否优先展示按钮)
const isAvailable =
  window.PublicKeyCredential &&
  (await PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable());

// 2. 登录鉴权时务必通过 AbortController 控制取消与防重复点击
const controller = new AbortController();
try {
  const credential = await navigator.credentials.get({
    publicKey: serverChallengeOptions,
    mediation: isConditionalUI ? 'conditional' : 'optional', // 输入框自动填充 vs 按钮主动触发
    signal: controller.signal,
  });
  // 将 credential 提交后端校验,校验中按钮保持 Authenticating Loading 态
} catch (err) {
  if (err.name === 'NotAllowedError') {
    // 对应状态机 S2:用户取消或超时,恢复按钮可用态,切勿弹红色异常阻断框
  }
}

五、Passkey 设计交付常见踩坑自查表 #

自查检查项 常见设计错误 正确工程化交付标准
是否在设计稿里画了自定义弹窗遮住系统验证框? 点击登录后先自己弹一个仿 iOS Face ID 提示窗,结果真机连弹两次框 禁止二次包装系统弹窗;按钮点击后直接置为 Loading 态,交由系统原生弹窗接管
网页端“注销账号/敏感转账”二次验证是否漏画? 仅在登录页画了 Passkey,删库、修改收款卡或导出密钥等高危确认仍在用老旧短信验证码 高危二次鉴权(Step-up Auth)同样可复用 Auth/PasskeyButton 组件,在无短信信号海外场景尤其关键
错误提示文案是否暴露了用户隐私(枚举攻击风险)? 未注册邮箱点击 Passkey 时提示“该邮箱尚未绑定通行密钥,请先注册” 安全合规要求不得暴露账号是否存在;应统一提示**“无法完成通行密钥验证,请使用手机扫码或其它方式登录”**
多端图标混用导致用户认知困惑? 在 Android 网页端显示苹果 Face ID 微笑人脸图标 iOS 专属界面用 Face ID / Touch ID,Android 用指纹,Web 通用端统一使用 FIDO 标准钥匙人形徽标(Passkey Icon)

通过将 系统宿主与自定义 UI 的边界清晰切分、用 Auto Layout 锁定多态按钮防坍缩,并在画布中完整沉淀 6 态安全降级状态机与 Variables 变量集,设计师与研发团队就能一次性交付兼具极致体验与金融级安全合规的 Passkey 认证系统;如需进一步完善账号权限与企业安全防线,可配合查阅 权限管理指南、Variables 入门 与 常见报错与疑难故障诊断手册。

❓ 常见问题与答疑 (FAQ)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。