Flutter安全认证插件uae_pass_flutter的使用

Flutter安全认证插件uae_pass_flutter的使用

插件简介

uae_pass_flutter 是一个非官方的用于 Android 和 iOS 的 UAE Pass 插件。它可以帮助开发者集成 UAE Pass 认证服务到他们的应用中。

安装插件

1. 将插件添加到 pubspec.yaml 文件中：

uae_pass_flutter: ^0.0.1

或通过 Git 添加：

uae_pass_flutter:
  git:
    url: https://github.com/Faisalkc4u/uae_pass.git
    ref: main

1. 运行 flutter pub get 获取插件：

flutter pub get

1. 导入插件：

import 'package:uae_pass/uae_pass.dart';
final _uaePassPlugin = UaePass();

初始化插件

• 沙盒环境：

await _uaePassPlugin.setUpSandbox();

• 生产环境：

await _uaePassPlugin.setUpEnvironment(
                  "< client Id here >",
                  "< client secret here >",
                  "< redirect url scheme here >",
                  isProduction: true, // set to false for sandbox
                  redirect_url: "< redirect url here >",
                  scope: "< scope here >",// by default urn:uae:digitalid:profile
                );

认证流程

1. 调用 authenticate 方法进行认证：

final result = await _uaePassPlugin.signIn();

1. 检查结果：

if (result != null) {
  if (result is UaePassError) {
    print("Error: ${result.message}");
  } else if (result is UaePassSuccess) {
    print("Success: ${result.accessToken}");
  }
}

iOS 设置

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

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>uaepass</string>
  <string>uaepassqa</string>
  <string>uaepassdev</string>
  <string>uaepassstg</string>
</array>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>Your App URL Scheme here</string> // e.g. uaepassdemoappDS (use for Sandbox )
    <key>CFBundleURLSchemes</key>
    <array>
      <string>Your App URL Scheme here</string> // e.g. uaepassdemoappDS (same as above)
    </array>
  </dict>
</array>

Android 设置

1. 更新 AndroidManifest.xml 文件中的 android:launchMode="singleTask"：

<activity
    android:name=".MainActivity"
    android:exported="true"

    android:launchMode="singleTask"

    android:theme="@style/LaunchTheme"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    android:hardwareAccelerated="true"
    android:windowSoftInputMode="adjustResize">
    .....

</activity>

1. 在 AndroidManifest.xml 文件中设置意图过滤器：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:host="success" android:scheme="&lt;Your App Scheme&gt;" />
    <data android:host="failure" android:scheme="&lt;Your App Scheme&gt;" />
</intent-filter>

注意：如果遇到 Kotlin 错误，请在 build.gradle 文件中添加以下内容：

buildscript {
    ext.kotlin_version = '1.7.10'
}

获取访问令牌

1. 使用 sign in 方法获取访问令牌：

curl --location --request POST 'https://stg-id.uaepass.ae/idshub/token?grant_type=authorization_code&redirect_uri=https://stg-selfcare.uaepass.ae&code=bfe96299-83f4-3ee9-80e4-56c24f5265d3' \
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Basic c2FuZGJveF9zdGFnZTpzYW5kYm94X3N0YWdl'

1. 访问用户数据：

curl --location 'https://stg-id.uaepass.ae/idshub/userinfo' \
--header 'Authorization: Bearer token_here'

示例代码

import 'package:flutter/material.dart';

import 'my_app.dart';

void main() {
  print("main called");
  runApp(const MyApp2());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: Home(),
    );
  }
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: ElevatedButton(
            onPressed: () {
              Navigator.push(context,
                  MaterialPageRoute(builder: (context) => const MyApp()));
            },
            child: const Text("go Now")),
      ),
    );
  }
}