97
0
3
Java Swing应用集成Google Authenticator双因素认证完整教程
双因素认证 (2FA) 是提升应用安全性的重要手段，本教程将详细介绍如何在 Java Swing 桌面应用中集成 Google Authenticator 兼容的 TOTP(基于时间的一次性密码)认证功能。
一、TOTP认证原理简介
TOTP(Time-based One-Time Password) 是 RFC 6238 定义的标准算法，Google Authenticator 等应用都实现了这一标准。其工作原理是：
服务端和客户端共享一个密钥
双方基于当前时间和密钥生成 6 位验证码
验证码每 30 秒变化一次
用户输入验证码后，服务端验证其有效性
二、开发环境准备
1. 所需依赖
在 pom.xml 中添加以下依赖：
<dependency>
<groupId>com.eatthepath</groupId>
<artifactId>java-otp</artifactId>
<version>0.4.0</version>
</dependency>
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.15</version>
</dependency>
<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>javase</artifactId>
<version>3.4.1</version>
</dependency>
2. 数据库表设计
创建用户表存储 TOTP 密钥：
CREATE TABLE users (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(50) NOT NULL UNIQUE,
password_hash VARCHAR(64) NOT NULL,
totp_secret VARCHAR(32),
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
三、核心功能实现
1. 生成TOTP密钥
public static String generateTotpSecret() {
KeyGenerator keyGenerator;
try {
keyGenerator = KeyGenerator.getInstance("HmacSHA1");
keyGenerator.init(160); // TOTP标准推荐160位密钥
Base32 base32 = new Base32();
return base32.encodeToString(keyGenerator.generateKey().getEncoded());
} catch (NoSuchAlgorithmException e) {
throw new RuntimeException("生成TOTP密钥失败", e);
}
}
2. 生成OTP认证URL
public static String generateOtpAuthUrl(String username, String secret, String issuer) {
return String.format("otpauth://totp/%s:%s?secret=%s&issuer=%s",
issuer, username, secret, issuer);
}
3. 生成二维码图片
public static BufferedImage generateQRCode(String text, int width, int height) {
try {
Map<EncodeHintType, Object> hints = new HashMap<>();
hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
hints.put(EncodeHintType.MARGIN, 1);
BitMatrix matrix = new MultiFormatWriter()
.encode(text, BarcodeFormat.QR_CODE, width, height, hints);
BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);
for (int x = 0; x < width; x++) {
for (int y = 0; y < height; y++) {
image.setRGB(x, y, matrix.get(x, y) ? 0xFF000000 : 0xFFFFFFFF);
}
}
return image;
} catch (Exception e) {
throw new RuntimeException("生成二维码失败", e);
}
}
4. 验证TOTP代码
public static boolean verifyTotpCode(String secret, String code) {
try {
Base32 base32 = new Base32();
byte[] secretBytes = base32.decode(secret);
Key key = new SecretKeySpec(secretBytes, "HmacSHA1");
TimeBasedOneTimePasswordGenerator totp =
new TimeBasedOneTimePasswordGenerator(Duration.ofSeconds(30), 6);
Instant now = Instant.now();
return code.equals(totp.generateOneTimePasswordString(key, now)) ||
code.equals(totp.generateOneTimePasswordString(key, now.minus(Duration.ofSeconds(30)))) ||
code.equals(totp.generateOneTimePasswordString(key, now.plus(Duration.ofSeconds(30))));
} catch (Exception e) {
return false;
}
}
四、Swing界面集成
1. 用户注册界面
private JPanel createRegistrationPanel() {
JPanel panel = new JPanel(new BorderLayout());
// 表单组件
JTextField usernameField = new JTextField(20);
JPasswordField passwordField = new JPasswordField(20);
JButton registerBtn = new JButton("注册");
// 二维码显示区域
JLabel qrCodeLabel = new JLabel();
qrCodeLabel.setHorizontalAlignment(JLabel.CENTER);
registerBtn.addActionListener(e -> {
String username = usernameField.getText();
String password = new String(passwordField.getPassword());
// 生成TOTP密钥
String totpSecret = generateTotpSecret();
// 保存用户到数据库
saveUser(username, password, totpSecret);
// 生成并显示二维码
String otpAuthUrl = generateOtpAuthUrl(username, totpSecret, "MyApp");
BufferedImage qrImage = generateQRCode(otpAuthUrl, 200, 200);
qrCodeLabel.setIcon(new ImageIcon(qrImage));
});
// 组装界面...
return panel;
}
2. 登录界面
private JPanel createLoginPanel() {
JPanel panel = new JPanel(new GridLayout(0, 1, 5, 5));
JTextField usernameField = new JTextField();
JPasswordField passwordField = new JPasswordField();
JTextField totpField = new JTextField();
JButton loginBtn = new JButton("登录");
loginBtn.addActionListener(e -> {
String username = usernameField.getText();
String password = new String(passwordField.getPassword());
String totpCode = totpField.getText();
// 验证用户凭据
if (verifyUser(username, password, totpCode)) {
JOptionPane.showMessageDialog(this, "登录成功");
} else {
JOptionPane.showMessageDialog(this, "用户名、密码或验证码错误", "错误", JOptionPane.ERROR_MESSAGE);
}
});
// 组装界面...
return panel;
}
五、测试与部署
1. 测试流程
运行应用，注册新用户
使用 Google Authenticator 扫描二维码
尝试使用生成的验证码登录
验证 30 秒后验证码是否失效
2. 部署注意事项
确保服务器时间准确（NTP 同步）
密钥存储要加密
提供备用验证方式（如备用代码）
记录审计日志
六、完整代码结构
src/
├── main/
│ ├── java/
│ │ └── com/
│ │ └── example/
│ │ ├── auth/
│ │ │ ├── TotpUtil.java # TOTP工具类
│ │ │ └── UserService.java # 用户服务
│ │ ├── ui/
│ │ │ ├── LoginFrame.java # 登录窗口
│ │ │ └── RegisterDialog.java # 注册对话框
│ │ └── MainApp.java # 主应用
│ └── resources/
│ └── icons/ # 图标资源
七、安全增强建议
密钥保护：
使用 HSM 或 KeyStore 加密存储密钥
不在日志中输出密钥
限流保护：
限制验证尝试次数
实现锁定机制防暴力破解
备用方案：
生成并安全存储备用代码
实现 SMS 备用验证通道
用户体验：
提供清晰的用户指引
支持多设备绑定
实现紧急访问功能