Flutter加密解密插件cryptography_plus的使用

概览

cryptography_plus 是一个为Dart/Flutter开发者提供的流行密码学算法包。它由gohilla.com维护，后因缺乏维护而迁移至emz-hanauer/dart-cryptography。该包在Apache License 2.0下授权。

• GitHub项目
• 问题追踪
• Pub包
• API参考

开始使用

如果你使用Flutter，建议（但不是必须）同时导入我们的姊妹包cryptography_flutter_plus，它会在可能的情况下委托调用给Android、iOS或Mac OS X的操作系统API。

在pubspec.yaml中添加依赖：

dependencies:
  cryptography_plus: ^2.7.0
  cryptography_flutter_plus: ^2.3.2 # 如果你不使用Flutter可以移除这一行

示例代码

数字签名示例

以下是使用Ed25519进行数字签名和验证的示例：

import 'package:cryptography_plus/cryptography_plus.dart';

Future<void> main() async {
  // 要签名的消息
  final message = <int>[1, 2, 3];

  // 生成密钥对
  final algorithm = Ed25519();
  final keyPair = await algorithm.newKeyPair();

  // 签名
  final signature = await algorithm.sign(
    message,
    keyPair: keyPair,
  );
  print('Signature: ${signature.bytes}');
  print('Public key: ${signature.publicKey.bytes}');

  // 验证签名
  final isSignatureCorrect = await algorithm.verify(
    message,
    signature: signature,
  );
  print('Correct signature: $isSignatureCorrect');
}

密钥协商示例

以下是一个使用X25519进行密钥协商的示例：

import 'package:cryptography_plus/cryptography_plus.dart';

Future<void> main() async {
  final algorithm = X25519();

  // Alice选择她的密钥对
  final aliceKeyPair = await algorithm.newKeyPair();

  // Alice知道Bob的公钥
  final bobKeyPair = await algorithm.newKeyPair();
  final bobPublicKey = await bobKeyPair.extractPublicKey();

  // Alice计算共享的秘密
  final sharedSecret = await algorithm.sharedSecretKey(
    keyPair: aliceKeyPair,
    remotePublicKey: bobPublicKey,
  );
  final sharedSecretBytes = await sharedSecret.extractBytes();
  print('Shared secret: $sharedSecretBytes');
}

认证加密示例

以下是一个使用AesGcm进行认证加密和解密的示例：

import 'dart:convert';
import 'package:cryptography_plus/cryptography_plus.dart';

Future<void> main() async {
  // 选择加密算法
  final algorithm = AesGcm.with256bits();

  // 生成随机密钥
  final secretKey = await algorithm.newSecretKey();
  final secretKeyBytes = await secretKey.extractBytes();
  print('Secret key: ${secretKeyBytes}');

  // 加密
  final secretBox = await algorithm.encryptString(
    'Hello!',
    secretKey: secretKey,
  );
  print('Nonce: ${secretBox.nonce}'); // 自动生成的随机nonce
  print('Ciphertext: ${secretBox.cipherText}'); // 加密后的消息
  print('MAC: ${secretBox.mac}'); // 消息认证码

  // 如果你要发送secretBox，可以将所有部分连接起来：
  final concatenatedBytes = secretBox.concatenation();
  print('All three parts concatenated: $concatenatedBytes');

  // 解密
  final clearText = await algorithm.decryptString(
    secretBox,
    secretKey: secretKey,
  );
  print('Cleartext: $clearText'); // Hello!
}

密码哈希示例

以下是一个使用Argon2id进行密码哈希的示例：

import 'package:cryptography_plus/cryptography_plus.dart';

Future<void> main() async {
  final algorithm = Argon2id(
    memory: 10 * 1000, // 10 MB
    parallelism: 2, // 使用最多两个CPU核心
    iterations: 1, // 为了更高的安全性，通常应增加memory参数而不是iterations
    hashLength: 32, // 返回哈希的字节数
  );

  final secretKey = await algorithm.deriveKeyFromPassword(
    password: 'qwerty',
    nonce: [1, 2, 3],
  );
  final secretKeyBytes = await secretKey.extractBytes();

  print('Hash: ${secretKeyBytes}');
}

哈希示例

以下是一个使用Sha256进行哈希的示例：

import 'package:cryptography_plus/cryptography_plus.dart';

Future<void> main() async {
  final sink = Sha256().newHashSink();

  // 添加所有部分的认证消息
  sink.add([1, 2, 3]);
  sink.add([4, 5]);
  sink.add([6]);

  // 计算哈希
  sink.close();
  final hash = await sink.hash();

  print('SHA-256 hash: ${hash.bytes}');
}

通过这些示例，你可以更好地理解如何在Flutter应用中使用cryptography_plus包进行加密、解密和其他密码学操作。希望这些信息对你有帮助！如果有任何问题，请随时提问。