katana_auth_firebase

Description:

katana auth firebase

Katana Auth
















[GitHub] | [YouTube] | [Packages] | [Twitter] | [Threads] | [LinkedIn] | [mathru.net]

Introduction #
FirebaseAuthentication for use around authentication is useful.
Various types of authentication can be easily implemented, including authentication by e-mail address, phone number, and SNS accounts.
However, even if Firebase authentication is to be used later, there may be times when you want to implement authentication without connecting to the server when creating a mockup of the application, or when you want to implement authentication in the test code.
Therefore, I have implemented a package that allows switching between Firebase and local authentication using an adapter, just as I did with katana_model.
In addition, the interface has been improved so that it is easy to switch between using Google sign-in and Apple sign-in depending on the application.
Installation #
Import the following packages.
flutter pub add katana_auth
copied to clipboard
If you use Firestore, import the following packages together.
flutter pub add katana_auth_firebase
copied to clipboard
Implementation #
Advance preparation #
Always place the AuthAdapterScope widget near the root of the app.
Pass an AuthAdapter such as RuntimeAuthAdapter as the adapter parameter.
// main.dart
import 'package:flutter/material.dart';
import 'package:katana_auth/katana_auth.dart';

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

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

@override
Widget build(BuildContext context) {
return AuthAdapterScope(
adapter: const RuntimeAuthAdapter(),
child: MaterialApp(
home: const AuthPage(),
title: "Flutter Demo",
theme: ThemeData(
primarySwatch: Colors.blue,
),
),
);
}
}
copied to clipboard
Creating Authentication Objects #
To perform authentication, first create an Authentication and keep it somewhere.
The Authentication object can obtain the following data to check the status of authentication.

isSignedIn：Returns true if authenticated.
isAnonymously：Returns true for anonymous authentication.
userId：Returns the user ID.
userEmail：Returns the user's email address if email authentication, etc. is performed.
userPhoneNumber：Returns the user's phone number if phone number verification is performed.

In addition, since Authentication inherits ChangeNotifier, it is possible to monitor updates by using addListener or riverpod's ChangeNotifierProvider, for example.
// auth_page.dart
import 'package:flutter/material.dart';
import 'package:katana_auth/katana_auth.dart';

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

@override
State<StatefulWidget> createState() => AuthPageState();
}

class AuthPageState extends State<AuthPage> {
final auth = Authentication();

@override
void initState() {
super.initState();
auth.addListener(_handledOnUpdate);
}

void _handledOnUpdate() {
setState(() {});
}

@override
void dispose() {
super.dispose();
auth.removeListener(_handledOnUpdate);
auth.dispose();
}

@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text("App Demo")),
body: ListView(
children: [
ListTile(
title: Text("SignedIn: ${auth.isSignedIn}"),
),
ListTile(
title: Text("Anonymously: ${auth.isAnonymously}"),
),
ListTile(
title: Text("ID: ${auth.userId}"),
),
ListTile(
title: Text("Email: ${auth.userEmail}"),
),
ListTile(
title: Text("Phone: ${auth.userPhoneNumber}"),
),
],
),
);
}
}
copied to clipboard
User Registration & Login #
The auth.register method is used to register users.
RegisterAuthProvider must be passed as the argument.
RegisterAuthProvider should be obtained using an AuthQuery with a register method.
(AuthQuery is discussed below.)
await auth.register(
EmailAndPasswordAuthQuery.register(
email: "[email protected]",
password: "12345678",
),
);
copied to clipboard
Also, use auth.signIn to perform login.
The SignInAuthProvider must be passed as an argument and should be obtained using an AuthQuery with a signIn method.
await auth.signIn(
EmailAndPasswordAuthQuery.signIn(
email: "[email protected]",
password: "12345678",
),
);
copied to clipboard
Use auth.confirmSignIn to confirm authentication, such as to perform mail link authentication or SMS authentication.
await auth.confirmSignIn(
SmsAuthQuery.confirmSignIn(
code: "012345",
),
);
copied to clipboard
Change User Information #
Use auth.change to change user information.
ChangeAuthProvider is passed as an argument, but the AuthQuery method can be changed depending on what is to be changed.

EmailAndPasswordAuthQuery.changeEmail：Change of e-mail address.
EmailAndPasswordAuthQuery.changePassword：Change password.
SmsAuthQuery.changePhoneNumber：Change of telephone number.

await auth.change(
EmailAndPasswordAuthQuery.changeEmail(
email: "[email protected]"
),
);
copied to clipboard
(Only available when logged in.)
Logout #
Use auth.signOut to log out.
Available only at login, no arguments required.
await auth.signOut();
copied to clipboard
AuthAdapter #
It is possible to change the authentication system by passing it when defining the AuthAdapterScope.

RuntimeAuthAdapter：Authentication system that works only when the app is launched. Authentication information is reset when the app is re-launched. Use this system when testing.
LocalAuthAdapter：Authentication system that works only locally on the device. Authentication information remains even if the application is re-launched, but cannot be shared among other devices.
FirebaseAuthAdapter：FirebaseAuthentication system. Allows sharing of authentication information between terminals; requires initial Firebase configuration.

AuthQuery #
AuthQuery is provided for each authentication provider.
By using the AuthQuery method, it is possible to use the functions for authentication provided by the Authentication class.
(Availability is limited by the authentication provider.)

AnonymouslyAuthQuery：AuthQuery for providers offering anonymous authentication.
EmailAndPasswordAuthQuery：AuthQuery for providers that offers authentication by email address and password.
EmailLinkAuthQuery：AuthQuery for providers that offers authentication via email link.
SmsAuthQuery：AuthQuery for providers offering authentication via SMS.
SnsSignInAuthProvider：Abstract class of AuthQuery for providers offering authentication with SNS accounts. Since it is an abstract class, the actual AuthQuery can be used by loading other related packages.

GitHub Sponsors #
Sponsors are always welcome. Thank you for your support!
https://github.com/sponsors/mathrunet