Repository navigation
Releases
Releases · ayeaaaa/pushotp
v0.1.0
pushotp v0.1.0
通过 pushplus(微信)或 Telegram 发送动态验证码并校验的 Go 模块,可选签发短期 HMAC 令牌。用于替代固定 TOKEN,防止泄露。
特性
- 两种用法:Go 库
github.com/ayeaaaa/pushotp;可选 HTTP 服务pushotpd - 渠道:pushplus、Telegram(接口化设计,可自行注册新渠道)
- 存储:memory / SQLite(纯 Go 无 CGO),配置切换,共享契约测试
- 安全:
crypto/rand发码、加盐 SHA-256 存储、恒定时间比较、一次性使用、冷却 + 每小时配额、原子 CAS 防并发重放 - 可选令牌:校验成功签发 HMAC-SHA256 无状态短期令牌,
VerifyToken离线验签
安装
go get github.com/ayeaaaa/pushotp@v0.1.0预编译二进制
附件为 pushotpd 单文件(CGO_ENABLED=0、已 strip),支持:
| 平台 | 文件 |
|---|---|
| Linux x86_64 | pushotpd_v0.1.0_linux_amd64 |
| Linux arm64 | pushotpd_v0.1.0_linux_arm64 |
| macOS Intel | pushotpd_v0.1.0_darwin_amd64 |
| macOS Apple Silicon | pushotpd_v0.1.0_darwin_arm64 |
| Windows x86_64 | pushotpd_v0.1.0_windows_amd64.exe |
chmod +x pushotpd_v0.1.0_linux_amd64
./pushotpd_v0.1.0_linux_amd64 -config config.yaml配置参考仓库 README;config.example.yaml 复制后填入自己的 pushplus token 或 Telegram bot 凭据即可。
质量说明
- 经过三轮对抗式代码审查(含威胁建模、运行时行为、并发/模糊测试)与 staticcheck / gosec / govulncheck 扫描,已知问题全部修复
- 建议使用最新 Go 补丁版构建(标准库漏洞随补丁修复)
接口速览
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/v1/send |
{receiver, scene, ttl?, length?, data?} → {ticket_id, expires_in} |
| POST | /api/v1/verify |
{ticket_id, code} → {ok, token?, expires_at?} |
| GET | /api/v1/health |
健康检查(含存储可用性) |