Flutter安全防护插件siarashield_flutter的使用

siarashield_flutter 是一个在 Flutter 应用程序中使用 SiaraShield 进行认证的包。

开始使用

要使用此包，在您的 pubspec.yaml 文件中添加 siarashield_flutter 作为依赖项。

安装

在您的 pubspec.yaml 文件中添加以下行：

dependencies:
  siarashield_flutter: latest_version

然后运行：

flutter pub get

使用

要使用 SiaraShield 进行认证，您需要一个 MasterUrlId，该 ID 可以从 SiaraShield Portal 注册您的包名后获得。

最小化示例

import 'package:siarashield_flutter/siarashield_flutter.dart';

SaraShieldWidget(
  loginTap: (bool isSuccess) {
    if (isSuccess) {
      // 处理成功的认证
      print("认证成功: \$isSuccess");
    } else {
      // 处理认证失败
      print("认证失败");
    }
  },
  cieraModel: CyberCieraModel(
    masterUrlId: 'TEST-CYBERSIARA', // 主URL ID
    requestUrl: 'com.app.testapp', // 包名称
    privateKey: 'TEST-CYBERSIARA', // 私钥
  ),
),

参数

其他信息

更多详细信息，请访问 SiaraShield Portal 或参考官方文档。

注意： 确保您安全地处理认证响应，并遵循存储应用程序敏感凭据的最佳实践。

以下是完整的示例代码，展示了如何在 Flutter 应用程序中使用 siarashield_flutter。

import 'dart:developer';

import 'package:flutter/material.dart';
import 'package:get/get.dart';
import 'package:siarashield_flutter/common/common_widgets.dart';
import 'package:siarashield_flutter/common/extension_widget.dart';
import 'package:siarashield_flutter/constants/app_constant.dart';
import 'package:siarashield_flutter/siarashield_flutter.dart';
import 'package:siarashield_flutter_example/second_screen.dart';

import 'app_colors.dart';

void main() {
  runApp(const GetMaterialApp(home: MyApp()));
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final TextEditingController _txtUsername = TextEditingController();
  final TextEditingController _password = TextEditingController();
  final border = OutlineInputBorder(borderRadius: BorderRadius.circular(5), borderSide: const BorderSide(color: AppColors1.greyColor));
  final TextStyle _hintStyle = const TextStyle(color: AppColors1.greyColor, fontSize: 16, fontWeight: FontWeight.w500);
  final TextStyle _labelStyle = const TextStyle(color: AppColors1.blueColor, fontSize: 16, fontWeight: FontWeight.w500);
  final TextStyle _subtitle = const TextStyle(color: AppColors1.greyColor, fontSize: 15, fontWeight: FontWeight.w400);
  bool isCheck = false;
  bool isSlide = false;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: AppColors1.whiteColor,
      body: Container(
        margin: EdgeInsets.only(top: screenHeight(context) * 0.15, right: 15, left: 15),
        decoration: const BoxDecoration(
            color: AppColors1.whiteColor,
            borderRadius: BorderRadius.only(
              topLeft: Radius.circular(5),
              topRight: Radius.circular(5),
              bottomLeft: Radius.circular(5),
              bottomRight: Radius.circular(5),
            )),
        child: Column(
          children: [
            Center(
                child: Image.asset(
              ImageAssets.logo,
              scale: 1,
              package: 'siarashield_flutter',
            )),
            const SizedBox(
              height: 15,
            ),
            TextFormField(
                controller: _txtUsername,
                cursorColor: AppColors1.blackColor,
                style: _labelStyle,
                textInputAction: TextInputAction.done,
                decoration: InputDecoration(
                    contentPadding: const EdgeInsets.only(left: 10),
                    disabledBorder: border,
                    errorBorder: border,
                    focusedBorder: border,
                    enabledBorder: border,
                    hintText: "Example@email.com",
                    hintStyle: _hintStyle,
                    labelText: "Email",
                    labelStyle: _labelStyle,
                    suffixIcon: Icon(
                      Icons.email_outlined,
                      color: AppColors1.yellowColor,
                    ))).putPadding(15, 15),
            const SizedBox(
              height: 15,
            ),
            TextFormField(
                controller: _password,
                obscureText: true,
                cursorColor: AppColors1.blackColor,
                style: _labelStyle,
                textInputAction: TextInputAction.done,
                decoration: InputDecoration(
                    contentPadding: const EdgeInsets.only(left: 10),
                    disabledBorder: border,
                    errorBorder: border,
                    focusedBorder: border,
                    enabledBorder: border,
                    hintText: "*******",
                    hintStyle: _hintStyle,
                    labelText: "Password",
                    labelStyle: _labelStyle,
                    suffixIcon: Icon(
                      Icons.lock,
                      color: AppColors1.yellowColor,
                    ))).putPadding(15, 15),
            const SizedBox(
              height: 10,
            ),
            Row(
              mainAxisAlignment: MainAxisAlignment.start,
              crossAxisAlignment: CrossAxisAlignment.center,
              children: [
                Checkbox(
                    value: isCheck,
                    onChanged: (val) {
                      isCheck = !isCheck;
                      setState(() {});
                    }),
                Text(
                  "记住密码",
                  style: _subtitle,
                )
              ],
            ).putPadding(15, 15),
            Padding(
              padding: const EdgeInsets.all(15.0),
              child: SaraShieldWidget(
                loginTap: (bool isSuccess) {
                  if (isSuccess) {
                    // 处理成功的认证
                    log("认证成功: \$isSuccess");

                    if (_txtUsername.text.isEmpty) {
                      toast("邮箱不能为空");
                      return;
                    }
                    if (_password.text.isEmpty) {
                      toast("密码不能为空");
                      return;
                    }
                    Get.to(() => const SecondScreen());
                  } else {
                    // 处理认证失败
                    log("认证失败");
                  }
                },
                cieraModel: CyberCieraModel(
                  masterUrlId: 'VYz433DfqQ5LhBcgaamnbw4Wy4K9CyQT', // 主 URL ID
                  requestUrl: 'com.app.cyber_ceiara', // 包名称
                  privateKey: "1AnVf4WsYsbyDRflfBInOe42vTnnMxbu", // 私钥
                ),
              ),
            ),
          ],
        ),
      ),
    );
  }
}