toolbelt/oathtool

oathtool

镜像概述

oathtool Docker镜像是基于OATH Toolkit的oathtool工具的容器化版本。oathtool是一款用于生成和验证OATH（开放认证）一次性密码的命令行工具，支持HOTP（基于事件的一次性密码）和TOTP（基于时间的一次性密码）标准。该镜像基于Alpine Linux构建，确保轻量级和高效运行。

核心功能与特性

• 支持标准OATH密码：兼容HOTP（RFC 4226）和TOTP（RFC 6238）标准，可生成和验证两种类型的一次性密码。
• 轻量级基础：基于Alpine Linux构建，镜像体积小，启动速度快。
• 即开即用：无需本地安装OATH Toolkit，通过Docker容器直接运行，简化环境配置。
• 命令行灵活调用：支持丰富的命令行参数，可自定义密钥、时间步长、哈希算法等（详见oathtool手册页）。

使用场景与适用范围

• 双因素认证测试：开发或测试环境中，快速生成TOTP/HOTP密码以验证应用的双因素认证功能。
• 临时密码生成：需要临时获取一次性密码时（如登录无TOTP客户端的设备），通过命令行快速生成。
• 系统集成辅助：在自动化脚本或系统集成中，作为轻量级工具生成或验证OATH密码。

使用方法与配置说明

基本运行

直接运行容器可查看oathtool的帮助信息：

bash
docker run --rm -ti toolbelt/oathtool

生成TOTP密码示例

生成基于时间的一次性密码（TOTP），使用Base32编码的密钥（示例密钥JBSWY3DPEHPK3PXP对应文本HELLOWORLD）：

bash
docker run --rm toolbelt/oathtool --totp -b "JBSWY3DPEHPK3PXP"

参数说明：

• --totp：指定生成TOTP密码
• -b：表示输入的密钥为Base32编码格式

生成HOTP密码示例

生成基于事件的一次性密码（HOTP），使用密钥和计数器值（示例密钥secretkey，计数器1）：

bash
docker run --rm toolbelt/oathtool --hotp -s "secretkey" 1

参数说明：

• --hotp：指定生成HOTP密码
• -s：直接提供密钥字符串（未编码）
• 1：计数器值

验证一次性密码

验证给定的TOTP密码是否正确（示例密钥JBSWY3DPEHPK3PXP，待验证密码123456）：

bash
docker run --rm toolbelt/oathtool --totp -b -v "JBSWY3DPEHPK3PXP" 123456

参数说明：

• -v：验证模式，检查提供的密码是否有效

版权信息

本Docker镜像包含以下组件：

• oathtool
  版权所有 © 2009-2020 Simon Josefsson，授权协议为GNU GPL v3或更高版本。

• Alpine Linux
  由Alpine Linux开发团队维护。