Files
nyaterm/docs-site/docs/guide/otp-and-auth.md
T
Kang f7875d7871 refactor: Update references from Dragonfly to NyaTerm across documentation and codebase
This commit replaces all instances of "Dragonfly" with "NyaTerm" in various files, including documentation, configuration, and UI elements. The changes ensure consistency in branding and improve clarity for users transitioning from the previous version. Additionally, updates to the changelog and README reflect the new application name and its features.
2026-05-05 20:05:53 +08:00

2.5 KiB
Raw Blame History

sidebar_position
sidebar_position
6

OTP 与认证

NyaTerm 把 OTP 管理和 SSH 认证流程结合在了一起:你既可以把 OTP 当作一个独立的验证码仓库来管理,也可以把它直接绑定到 SSH 连接中,减少重复输入。

支持的 OTP 类型

当前支持:

  • TOTP
  • HOTP

创建或编辑 OTP 条目时,可以配置:

  • issuer
  • username
  • secret
  • 算法(SHA-1 / SHA-256 / SHA-512)
  • 位数
  • 周期(TOTP)
  • 计数器(HOTP)

在哪里管理 OTP

请打开 Security/Auth 面板中的 OTP 标签页。

你可以在这里:

  • 新建 OTP 条目
  • 编辑已有条目
  • 删除条目
  • 查看验证码
  • 从二维码图片导入

从二维码导入

如果你已经有 MFA / 2FA 的二维码,可以直接导入图片文件。

典型流程:

  1. 在 OTP 面板中点击二维码导入
  2. 选择本地图片文件
  3. NyaTerm 解析后自动填充 issuer、username、secret 等信息
  4. 确认后保存为一个 OTP 条目

这比手动抄写 secret 更适合日常管理,也更适合批量整理认证资料。

绑定到 SSH 连接

在 SSH 连接表单的高级区域中,可以为连接选择一个已保存的 OTP 条目。

绑定后你可以:

  • 在认证时快速查看当前验证码
  • 在支持的交互流程中启用 自动填充 OTP

这非常适合需要“密码 / 私钥 + 二次验证码”组合认证的环境。

认证弹窗中的 OTP 交互

当 SSH 服务器进入 keyboard-interactive / OTP 流程时,NyaTerm 会弹出 OTP 对话框。

对话框中会显示:

  • 当前连接名称
  • 服务端要求输入的提示项
  • 如果该连接绑定了 OTP,还会显示验证码面板

你可以:

  • 手动输入验证码
  • 直接把当前 OTP 验证码发送到输入框
  • 提交或取消本次认证

自动填充 OTP

如果某个 SSH 连接已经绑定了 OTP 条目,还可以启用 自动填充 OTP。

适合场景:

  • 固定资产环境
  • 跳板机 / 堡垒机需要验证码
  • 高频重复登录的运维场景

建议只对你明确掌握认证流程的连接开启,避免在不兼容的交互提示上产生误填。

与密码 / 私钥的关系

OTP 不是替代密码或私钥,而是和它们配合使用:

  • 密码 + OTP
  • 私钥 + OTP

因此更推荐的管理方式是:

  1. 在 Security/Auth 中先分别整理好密码、私钥、OTP
  2. 再在具体 SSH 连接中绑定这些材料

这样连接配置会更干净,也更方便后续统一替换认证信息。