Code Monkey home page Code Monkey logo

cordova-plugin-firebase-authentication's Introduction

Cordova plugin for Firebase Authentication

NPM version NPM downloads

Index

Installation

cordova plugin add @medyx/cordova-plugin-firebase-authentication --save

Use variable FIREBASE_AUTH_VERSION to override dependency version on Android.

To use phone number authentication on iOS, your app must be able to receive silent APNs notifications from Firebase. For iOS 8.0 and above silent notifications do not require explicit user consent and is therefore unaffected by a user declining to receive APNs notifications in the app. Thus, the app does not need to request user permission to receive push notifications when implementing Firebase phone number auth.

Supported Platforms

  • iOS
  • Android

User authorization

Unlike v1 of the plugin in v2 you must register onAuthStateChanged callback to be notified when signIn* or signOut methods are completed.

onAuthStateChanged(callback)

Registers a block as an auth state did change listener. To be invoked when:

  • The block is registered as a listener,
  • A user with a different UID from the current user has signed in, or
  • The current user has signed out.
cordova.plugins.firebase.auth.onAuthStateChanged(function(userInfo) {
    if (userInfo) {
        // user was signed in
    } else {
        // user was signed out
    }
});

createUserWithEmailAndPassword(email, password)

Tries to create a new user account with the given email address and password.

cordova.plugins.firebase.auth.createUserWithEmailAndPassword("[email protected]", "pa55w0rd");

sendEmailVerification()

Initiates email verification for the current user.

cordova.plugins.firebase.auth.sendEmailVerification();

sendPasswordResetEmail(email)

Triggers the Firebase Authentication backend to send a password-reset email to the given email address, which must correspond to an existing user of your app.

cordova.plugins.firebase.auth.sendPasswordResetEmail("[email protected]");

signInWithEmailAndPassword(email, password)

Asynchronously signs in using an email and password.

cordova.plugins.firebase.auth.signInWithEmailAndPassword("[email protected]", "pa55w0rd");

verifyPhoneNumber(phoneNumber, timeout)

Starts the phone number verification process for the given phone number.

NOTE: Android supports auto-verify and instant device verification. Therefore in that cases it doesn't make sense to ask for sms code. It's recommended to register onAuthStateChanged callback to be notified on auto sign-in.

timeout [milliseconds] is the maximum amount of time you are willing to wait for SMS auto-retrieval to be completed by the library. Maximum allowed value is 2 minutes. Use 0 to disable SMS-auto-retrieval. If you specify a positive value less than 30 seconds, library will default to 30 seconds.

cordova.plugins.firebase.auth.verifyPhoneNumber("+123456789", 30000).then(function(verificationId) {
    // pass verificationId to signInWithVerificationId
});

signInWithVerificationId(verificationId, smsCode)

Asynchronously signs in using verificationId and 6-digit SMS code.

cordova.plugins.firebase.auth.signInWithVerificationId("djgfioerjg34", "123456");

signInAnonymously()

Create and use temporary anonymous account to authenticate with Firebase.

cordova.plugins.firebase.auth.signInAnonymously();

signInWithGoogle(idToken, accessToken)

Uses Google's idToken and accessToken to sign-in into firebase account. In order to retriave those tokens follow instructions for Android and iOS.

signInWithFacebook(accessToken)

Uses Facebook's accessToken to sign-in into firebase account. In order to retriave those tokens follow instructions for Android and iOS.

signInWithTwitter(token, secret)

Uses Twitter's token and secret to sign-in into firebase account. In order to retriave those tokens follow instructions for Android and iOS.

signOut()

Signs out the current user and clears it from the disk cache.

cordova.plugins.firebase.auth.signOut();

Get/set user state

Every method call returns a promise which is optionally fulfilled with an appropriate value.

getCurrentUser()

Returns the current user in the Firebase instance.

cordova.plugins.firebase.auth.getCurrentUser().then(function(userInfo) {
    // user information or null if not logged in
})

getIdToken(forceRefresh)

Returns a JWT token used to identify the user to a Firebase service.

cordova.plugins.firebase.auth.getIdToken().then(function(idToken) {
    // send token to server
});

setLanguageCode(languageCode)

Set's the current user language code. The string used to set this property must be a language code that follows BCP 47.

useAppLanguage()

Sets languageCode to the app’s current language.

cordova-plugin-firebase-authentication's People

Contributors

chemerisuk avatar jonathanpelletier avatar martinblanchette avatar andreszs avatar cairin avatar douglaszaltron avatar javierpaytef avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.