Flutter密码处理插件password_dart的使用

Flutter密码处理插件password_dart的使用

password_dart 是一个用于在Flutter和Dart项目中安全地哈希和验证密码的库。它是 password 库的分支，并且支持null safety。该库基于 PointyCastle 提供了一组高级API，用于安全地处理密码。它的设计灵感来源于PHP的密码哈希函数。

安装

首先，在 pubspec.yaml 文件中添加 password_dart 依赖：

dependencies:
  password_dart: ^2.0.0

然后运行 flutter pub get 来安装依赖。

API

1. Password.hash

Password.hash 方法用于生成密码的哈希值。它接受两个参数：密码字符串和哈希算法（如 PBKDF2）。默认情况下，PBKDF2 使用 SHA-512 摘要算法、64字节的块大小、32字节的盐、10000次迭代和64字节的密钥长度。

示例代码：

import 'package:password_dart/password.dart';

void main() {
  final password = 'secret';
  final algorithm = PBKDF2();
  final hash = Password.hash(password, algorithm);

  print('生成的哈希值: $hash');
}

输出示例：

生成的哈希值: $pcks$64,10000,64$530f8afbc74536b9a963b4f1c4cb738bcea7403d4d606b6e074ec5d3baf39d18$56158864e365bd78f6afda27f9a239bcb3f2b7a4773d4c0d0858c86266119d1e35aae9ca1a4777ed3d85c42caeed0c57cc7e09fe7d152d5d4d4ee08506c2b41a

2. Password.verify

Password.verify 方法用于验证给定的密码是否与存储的哈希值匹配。它接受两个参数：待验证的密码和之前生成的哈希值。

示例代码：

import 'package:password_dart/password.dart';

void main() {
  final password = 'secret';
  final algorithm = PBKDF2();
  final hash = Password.hash(password, algorithm);

  // 验证正确密码
  bool isCorrect = Password.verify(password, hash);
  print('密码是否正确: $isCorrect');  // 输出: true

  // 验证错误密码
  bool isIncorrect = Password.verify('wrongpass', hash);
  print('密码是否正确: $isIncorrect');  // 输出: false
}

输出示例：

密码是否正确: true
密码是否正确: false

默认配置

在大多数情况下，建议使用默认的随机数生成器（PRNG）来生成盐。它是加密安全的，并且每个密码都是唯一的。同时，建议根据硬件性能调整迭代次数。

PBKDF2 默认配置

完整示例Demo

以下是一个完整的示例，展示了如何在Flutter应用中使用 password_dart 插件来处理密码的哈希和验证。

import 'package:flutter/material.dart';
import 'package:password_dart/password.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Password Dart Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: PasswordScreen(),
    );
  }
}

class PasswordScreen extends StatefulWidget {
  [@override](/user/override)
  _PasswordScreenState createState() => _PasswordScreenState();
}

class _PasswordScreenState extends State<PasswordScreen> {
  final TextEditingController _passwordController = TextEditingController();
  final TextEditingController _confirmPasswordController = TextEditingController();
  String _hashedPassword = '';
  String _verificationResult = '';

  void _hashPassword() {
    final password = _passwordController.text;
    if (password.isNotEmpty) {
      final algorithm = PBKDF2();
      final hash = Password.hash(password, algorithm);
      setState(() {
        _hashedPassword = hash;
      });
    }
  }

  void _verifyPassword() {
    final confirmPassword = _confirmPasswordController.text;
    if (confirmPassword.isNotEmpty && _hashedPassword.isNotEmpty) {
      final isVerified = Password.verify(confirmPassword, _hashedPassword);
      setState(() {
        _verificationResult = isVerified ? '密码正确' : '密码错误';
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Password Dart Demo'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            TextField(
              controller: _passwordController,
              obscureText: true,
              decoration: InputDecoration(
                labelText: '输入密码',
              ),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _hashPassword,
              child: Text('生成哈希'),
            ),
            SizedBox(height: 20),
            Text(
              '生成的哈希值: $_hashedPassword',
              style: TextStyle(fontSize: 12),
            ),
            SizedBox(height: 20),
            TextField(
              controller: _confirmPasswordController,
              obscureText: true,
              decoration: InputDecoration(
                labelText: '确认密码',
              ),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _verifyPassword,
              child: Text('验证密码'),
            ),
            SizedBox(height: 20),
            Text(
              '验证结果: $_verificationResult',
              style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
            ),
          ],
        ),
      ),
    );
  }
}