Flutter身份验证插件flutter_authgear的使用

Authgear SDK for Flutter #

通过Authgear SDK for Flutter，您可以轻松地将身份验证功能集成到您的Flutter应用中。通常情况下，只需要几行代码就可以启用多种身份验证方法，例如社交登录、无密码登录、生物识别登录、短信/WhatsApp验证码以及多因素认证（MFA）。

快速链接 - 📚 文档 🏁 开始使用 🛠️ 疑难解答 👥 贡献

什么是Authgear？ #

Authgear 是一个高度可适应的身份即服务（IDaaS）平台，适用于Web和移动应用程序。Authgear通过将其集成到各种类型的应用程序中（从单页Web应用到移动应用再到API服务）来简化用户身份验证的实现。

关键特性 #

• 使用OpenID Connect（OIDC）标准的零信任身份验证架构。
• 包含电子邮件、电话、用户名作为登录ID，以及密码、一次性密码（OTP）、魔法链接等的易于使用的注册和登录界面。
• 支持广泛的身份提供商，如Google、Apple和Azure Active Directory（AD）。
• 支持移动设备上的生物识别登录、Passkeys和多因素认证（MFA），如基于短信/邮件的验证和TOTP认证器应用。

文档 #

• 查看SDK API参考: https://authgear.github.io/authgear-sdk-flutter/
• 了解如何通过管理门户或管理API管理用户。

查看其他Authgear文档: https://docs.authgear.com/

开始使用 #

请遵循以下简单步骤开始使用：

• 使用Authgear Flutter SDK开始

疑难解答 #

请查看我们的求助以获取常见安装问题和其他问题的解决方案。

提出问题 #

若要提供反馈或报告错误，请在问题跟踪器上提出问题。

贡献 #

任何希望为本项目做出贡献的人都非常欢迎，无论是文档、功能、错误修复、代码清理、测试还是代码审查。只需在Authgear Discord服务器（#trouble）或GitHub Authgear的讨论板上举手加入。

如果您不熟悉如何为GitHub项目做贡献，可以查阅入门指南。一套完整的贡献指南及相关模板正在筹备中。

支持和维护 #

Authgear是一个高度可适应的身份即服务（IDaaS）平台，适用于Web和移动应用程序。了解更多请访问[网站](https://www.authgear.com/)

完整示例代码

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Authgear Flutter Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () async {
                  // 初始化Authgear SDK
                  await Authgear.init(
                    authgearUrl: 'https://<your-authgear-instance>.authgearapp.com',
                    clientId: '<your-client-id>',
                    clientSecret: '<your-client-secret>',
                  );

                  // 登录
                  try {
                    var result = await Authgear.signIn();
                    print('User signed in: $result');
                  } catch (e) {
                    print('Login failed: $e');
                  }
                },
                child: Text('Sign In'),
              ),
              ElevatedButton(
                onPressed: () async {
                  // 注销
                  try {
                    await Authgear.signOut();
                    print('User signed out');
                  } catch (e) {
                    print('Sign out failed: $e');
                  }
                },
                child: Text('Sign Out'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

说明

1. 初始化Authgear SDK:

   await Authgear.init(
     authgearUrl: 'https://<your-authgear-instance>.authgearapp.com',
     clientId: '<your-client-id>',
     clientSecret: '<your-client-secret>',
   );
   

   这一步需要替换authgearUrl、clientId和clientSecret为您的实际值。

2. 登录:

   var result = await Authgear.signIn();
   print('User signed in: $result');
   

   这会触发用户登录流程。登录成功后，您可以处理返回的结果。

3. 注销:

   await Authgear.signOut();
   print('User signed out');