Flutter安全增强插件security_plus的使用

Security Plus

Security Plus 是一个为Flutter应用提供高级安全特性的综合安全插件，包括但不限于Root检测、模拟器检测以及多种安全检查功能。

功能特性

• 高级Root检测
  • 多层检测机制
  • Frida反篡改保护
  • Magisk检测
  • SuperSU检测
  • 常见Root应用检测
• 模拟器检测
  • 全面的模拟器环境检查
  • 构建属性分析
  • 硬件特征验证
• 安全检查
  • 开发模式检测
  • 模拟位置检测
  • 外部存储检查
  • 运行时完整性验证
  • 系统篡改检测

安装与配置

安装

在pubspec.yaml文件中添加以下依赖：

dependencies:
  security_plus: ^3.0.1

平台设置

Android

1. 在AndroidManifest.xml文件中添加如下权限：

   <manifest xmlns:android="http://schemas.android.com/apk/res/android">
       <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
       <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
   </manifest>
   

2. 添加permission_handler用于运行时权限管理：

   dependencies:
     permission_handler: ^10.4.3
   

iOS

在Info.plist文件中添加如下内容：

<key>NSLocationWhenInUseUsageDescription</key>
<string>This app needs access to location when open to verify device security.</string>

使用方法

导入包

在Dart文件中导入security_plus和permission_handler包：

import 'package:security_plus/security_plus.dart';
import 'package:permission_handler/permission_handler.dart';

权限处理与安全检查

以下是一个完整的示例代码，展示了如何进行设备的安全性检查：

import 'dart:async';
import 'dart:developer';
import 'dart:io';

import 'package:flutter/material.dart';
import 'package:security_plus/security_plus.dart';
import 'package:permission_handler/permission_handler.dart';

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> {
  bool _isRooted = false,
      _isDev = false,
      _isExtStorage = false,
      _isEmulator = false;
  bool _isMockLocationEnabled = false;

  @override
  void initState() {
    super.initState();
    _checkPermissionsAndInitialize();
  }

  Future<void> _checkPermissionsAndInitialize() async {
    if (Platform.isAndroid) {
      final locationStatus = await Permission.location.request();
      if (locationStatus.isGranted) {
        await _initializeSecurityChecks();
      } else {
        log('Location permission denied');
        // Handle permission denied case
      }
    } else {
      await _initializeSecurityChecks();
    }
  }

  Future<void> _initializeSecurityChecks() async {
    await isRooted();
    await isExtStorage();
    await isEmulator();
    await isDevelopment();
    await isMockLocationEnabled();
  }

  Future<void> isRooted() async {
    try {
      bool result = Platform.isAndroid
          ? await SecurityPlus.isRooted
          : await SecurityPlus.isJailBroken;
      setState(() {
        _isRooted = result;
      });
    } catch (e) {
      log('\x1B[31m${"=====error======"}\x1B[0m');
      log(e.toString());
    }
  }

  Future<void> isExtStorage() async {
    if (Platform.isAndroid) {
      try {
        bool result = await SecurityPlus.isOnExternalStorage;
        setState(() {
          _isExtStorage = result;
        });
      } catch (e) {
        log('\x1B[31m${"=====error======"}\x1B[0m');
        log(e.toString());
      }
    }
  }

  Future<void> isEmulator() async {
    try {
      bool result = await SecurityPlus.isEmulator;
      setState(() {
        _isEmulator = result;
      });
    } catch (e) {
      log('\x1B[31m${"=====error======"}\x1B[0m');
      log(e.toString());
    }
  }

  Future<void> isDevelopment() async {
    try {
      bool result = await SecurityPlus.isDevelopmentModeEnable;
      setState(() {
        _isDev = result;
      });
    } catch (e) {
      log('\x1B[31m${"=====error======"}\x1B[0m');
      log(e.toString());
    }
  }

  Future<void> isMockLocationEnabled() async {
    if (!Platform.isAndroid) return;
    try {
      bool result = await SecurityPlus.isMockLocationEnabled;
      setState(() {
        _isMockLocationEnabled = result;
      });
    } catch (e) {
      log('\x1B[31m${"=====error======"}\x1B[0m');
      log(e.toString());
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Security Plus Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text('Device is ${_isRooted ? "" : "not"} rooted'),
              if (Platform.isAndroid) ...[
                Text('App is ${_isExtStorage ? "" : "not"} on external storage'),
                Text('Device is ${_isEmulator ? "" : "not"} an emulator'),
                Text('Device is ${_isDev ? "" : "not"} in development mode'),
                Text('Mock location is ${_isMockLocationEnabled ? "enabled" : "disabled"}'),
              ],
              ElevatedButton(
                onPressed: _checkPermissionsAndInitialize,
                child: const Text('Refresh Security Checks'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

个体安全检查

以下是针对不同安全检查的具体实现：

Root检测

try {
  bool isRooted = await SecurityPlus.isRooted;
  if (isRooted) {
    // 处理Root设备
  }
} catch (e) {
  // 错误处理
}

模拟器检测

try {
  bool isEmulator = await SecurityPlus.isEmulator;
  if (isEmulator) {
    // 处理模拟器检测
  }
} catch (e) {
  // 错误处理
}

开发模式检查

try {
  bool isDevelopmentMode = await SecurityPlus.isDevelopmentModeEnable;
  if (isDevelopmentMode) {
    // 处理开发模式
  }
} catch (e) {
  // 错误处理
}

模拟位置检查

try {
  bool isMockLocation = await SecurityPlus.isMockLocationEnabled;
  if (isMockLocation) {
    // 处理模拟位置
  }
} catch (e) {
  // 错误处理
}

外部存储检查

try {
  bool isOnExternalStorage = await SecurityPlus.isOnExternalStorage;
  if (isOnExternalStorage) {
    // 处理外部存储检测
  }
} catch (e) {
  // 错误处理
}

安全特性

• Root检测机制
  • 集成RootBeer库进行基础Root检测
  • 检测Frida相关进程和库
  • 扫描常见Root相关的文件和目录
  • 检测已知的Root管理应用程序
  • 检查系统修改和挂钩
• 防篡改保护
  • 监控已知篡改工具的进程
  • 检测库注入
  • 验证系统属性
  • 运行时完整性检查

示例项目

可以查看 example 目录中的完整示例应用程序，以了解所有特性的演示。

平台支持

贡献

欢迎贡献！如果您发现bug或希望添加新功能，请提交issue。

许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。

作者

由Abdelrahman Bonna创建并维护。

致谢

• RootBeer - 提供Root检测能力
• Flutter团队和社区的杰出工作

免责声明

此插件提供了安全特性，但不应被视为您应用程序的唯一安全措施。始终实施多层次的安全策略，并保持安全措施的更新。