Skip to content
This repository has been archived by the owner on Mar 26, 2023. It is now read-only.

Latest commit

 

History

History
68 lines (48 loc) · 2.45 KB

README.md

File metadata and controls

68 lines (48 loc) · 2.45 KB

firebase_auth_oauth

A Flutter plugin that makes it easy to perform OAuth sign in flows using FirebaseAuth. It also includes support for Sign in by Apple for Firebase. This plugin supports Android, iOS and Web. OAuth flows are performed by opening pop-up on top of the application to allow the user to authenticate or the native flow in the case of sign in by apple.

Usage

You need to set up Firebase for your project first before using this plugin. Instructions can be found here.

  • In your pubspec.yaml add
dependencies:
  flutter:
    sdk: flutter
  firebase_auth: ^4.1.1
  firebase_core: ^2.1.1
  firebase_auth_oauth: ^1.2.2
  • Then in your project just call

FirebaseUser user = await FirebaseAuthOAuth().openSignInFlow("A provider ID", [list of scopes], {custom parameters map});

// Sign-in by Apple example
User user = await FirebaseAuthOAuth()
          .openSignInFlow("apple.com", ["email"], {"locale": "en"});

// Or you can link an existing logged-in user
User user = await FirebaseAuthOAuth()
          .linkExistingUserWithCredentials("apple.com", ["email"], {"locale": "en"});

// Or if the OAuth credential result is needed, you can fetch provider auth result with one of the following
OAuthCredential credential = await FirebaseAuthOAuth().signInOAuth("apple.com", ["email"], {"locale": "en"});
OAuthCredential credential = await FirebaseAuthOAuth().linkWithOAuth("apple.com", ["email"], {"locale": "en"});
USer user = FirebaseAuth.instance.currentUser;

Checkout the example Widget.

Auth Providers Support

Name Supported
Apple ✅ (Android, Web & iOS 13)
Twitter
Github
Microsoft
Yahoo
Facebook 🚫

This plugin supports OAuth operations using OAuthProvider only with the exception to Sign in by Apple on iOS 13 where it uses the native AuthenticationService.

Error Handling

Below are the error codes you might receive when using this plugin

Code Meaning
FirebaseAuthError An error coming from FirebaseAuth SDK
PluginError An error coming from this plugin. e.g. Invalid arguments or null items
PlatformError An error coming from the native platform