Flutter安全存储插件secure_enclave的使用

什么是Secure Enclave? 👮

Secure Enclave是Apple系统芯片（SoC）中集成的一个专用安全子系统。它与主处理器隔离，提供额外的安全层，即使应用处理器内核被攻破，也能确保敏感用户数据的安全。

功能集 ✨

• ✅ 检查标签状态
• ✅ 生成密钥对
• ✅ 获取公钥
• ✅ 加密
• ✅ 使用公钥加密
• ✅ 解密
• ✅ 签名
• ✅ 验证
• ✅ 标志（参考链接）
  • devicePasscode ✅
  • biometryAny ✅
  • biometryCurrentSet ✅
  • userPresence ✅
  • watch ✅
  • and ✅
  • or ✅
  • applicationPassword ✅
  • privateKeyUsage ✅

如何使用 🚀

示例项目结构

以下是一个完整的Flutter应用程序示例，演示如何使用secure_enclave插件进行各种操作。

主文件 lib/main.dart

import 'package:flutter/material.dart';
import 'dashboard.dart';

final _messangerKey = GlobalKey<ScaffoldMessengerState>();

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      scaffoldMessengerKey: _messangerKey,
      home: const Dashboard(),
    );
  }
}

仪表盘文件 lib/dashboard.dart

import 'package:flutter/material.dart';
import 'package:secure_enclave/secure_enclave.dart';

class Dashboard extends StatelessWidget {
  const Dashboard({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Secure Enclave Demo')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                final secureEnclavePlugin = SecureEnclave();

                // 检查标签状态
                final bool status = (await secureEnclavePlugin.isKeyCreated(tag: 'kota')).value;
                print('Tag Status: $status');

                // 生成密钥对
                ResultModel res = await secureEnclavePlugin.generateKeyPair(
                  accessControl: AccessControlModel(
                    password: 'jakarta123',
                    options: [
                      AccessControlOption.applicationPassword,
                      AccessControlOption.privateKeyUsage,
                    ],
                    tag: 'kota',
                  ),
                );

                if (res.error != null) {
                  print(res.error!.desc.toString());
                } else {
                  print('Key Pair Generated');
                }

                // 获取公钥
                res = await secureEnclavePlugin.getPublicKey(tag: 'kota');
                if (res.error != null) {
                  print(res.error!.desc.toString());
                } else {
                  print('Public Key: ${res.value}');
                }

                // 加密
                res = await secureEnclavePlugin.encrypt(
                  message: 'hello jakarta',
                  tag: 'kota',
                  password: 'jakarta123',
                );

                if (res.error != null) {
                  print(res.error!.desc.toString());
                } else {
                  print('Encrypted Message: ${res.value}');
                }

                // 解密
                res = await secureEnclavePlugin.decrypt(
                  message: Uint8List.fromList(hex.decode('iasjfoiaj2EL3EL')),
                  tag: 'kota',
                  password: 'jakarta123',
                );

                if (res.error != null) {
                  print(res.error!.desc.toString());
                } else {
                  print('Decrypted Message: ${res.value}');
                }

                // 签名
                res = await secureEnclavePlugin.sign(
                  message: Uint8List.fromList('hello jakarta'.codeUnits),
                  tag: 'kota',
                  password: 'jakarta123',
                );

                if (res.error != null) {
                  print(res.error!.desc.toString());
                } else {
                  print('Signature: ${res.value}');
                }

                // 验证
                res = await secureEnclavePlugin.verify(
                  plainText: 'hello jakarta',
                  signature: 'fDrPlGl48R8DPCGNTsAticYfx3RoWPKxEHQ2pHWrBDGk887UwWYGVTSSUj6LciietChBULEs ',
                  tag: 'kota',
                  password: 'jakarta123',
                );

                if (res.error != null) {
                  print(res.error!.desc.toString());
                } else {
                  print('Verification Success: ${res.value}');
                }
              },
              child: const Text('Run Secure Enclave Operations'),
            ),
          ],
        ),
      ),
    );
  }
}

以上代码展示了如何在Flutter应用中使用secure_enclave插件执行各种安全操作，包括检查标签状态、生成密钥对、获取公钥、加密、解密、签名和验证。

这个Markdown文档提供了关于如何使用Flutter的`secure_enclave`插件的详细指南，并包含了一个完整的示例程序来展示其功能。