Firebase Auth, Firestore & Storage (plugin)
  • 🚀Getting Started
  • Setup
    • Create a Firebase Project
    • Get Firebase access credentials
    • Offline Support
    • Secure your credentials and data
      • Restrict your api-key to your domain
      • Security Rules on Firebase
  • Plugin Elements
    • 🛠️About elements
    • 💾Data Schemas
    • Firebase Auth (Current User)
    • Firestore Data List
      • Firebase Geohash
      • Firestore Data (legacy)
    • Firestore Data Extractor
    • Firestore Data Single
    • Firestore Data Aggregation
    • Firestore Data Processor
    • Firebase Storage Upload Button
    • Firebase Action Listener
    • Firebase Dropdown Processor
  • Plugin Front-end Actions
    • 💻About front-end actions
    • 💾Field types table
    • Firestore
      • Create a new document
      • Update a document
      • Delete a document
      • Update a list of documents
      • Delete a list of documents
      • Batch Operations
        • Batch Operation Constructor
        • Batch Operation Commit
    • Firebase Auth
      • Sign the User Up
      • Log the User In
      • Log the User In with Google
      • Log the User In with Facebook
      • Log the User In with GitHub
      • Log the User Out
      • Update User's Profile
      • Update User's Password
      • Update User's Email
      • Send password reset email
        • Handle reset password code
      • Send verification email
        • Handle verify email code
      • Delete current user
    • Firebase Storage
      • Upload file base64
      • Delete uploaded file
  • Plugin Back-end Actions
    • ☁️About backend actions
    • Firestore Backend
      • Get a list of documents
      • Get a single document
      • Count a list of documents
      • Create a new document
      • Update a document
      • Delete a document
      • Update a list of documents
      • Delete a list of documents
    • Firebase Auth Backend
      • Create an account for someone else
      • Update another user's profile info
      • Delete a user account
      • Generate email confirmation link
      • Generate password reset link
      • Set user roles
Powered by GitBook
On this page
  • Firebase Console Configuration
  • Inputs and Settings
  • Trigger ID (optional)
  • Copy profile data into firestore collection
  • Other User Data
  • Users Collection
  • Fields
  • Field Types
  • Triggered events
  • Stored values on the listener
  • User ID
  • User Email
  • Error Message
  1. Plugin Front-end Actions
  2. Firebase Auth

Log the User In with GitHub

PreviousLog the User In with FacebookNextLog the User Out

Last updated 1 year ago

This action logs the user in with authentication from a GitHub account.


Firebase Console Configuration

Go to the of you project, and them to the Authentication service. On it, you must select the tab "Sign-in method".

Link: .

If you click on "Add a new provider", will be able to choose from various authentication methods.

Right now, the plugin supports only Email/Password, Google, Facebook and Github methods.

After filling the info and clicking "Save", you can test the login and check if all settings on Github are working properly.

Remember to allow you apps domain on the Authentication settings (see below)


Inputs and Settings

Trigger ID (optional)

If left blank, all listener on the page with blank ID's will be triggered at the same time, so we suggest to always define a Trigger ID.

Copy profile data into firestore collection

If you check this option, the user's profile data will be stored not only on the user, from the Firebase Authentication service, but also on the user's document.

If is recommended to left it checked, since it gives more flexibility while accessing this information, as well as utilizing it on queries and filters for users.

Other User Data

Users Collection

The name or ID of the collection where user's should be stored in. A document will be created with the same ID of the newly created user account.

Fields

When you create a document on Firestore, you must inform which fields and which content each will have on it's structure, in JSON format. This input allows you to set as many fields as you want.

For each field you must specify the "key" and the "value" that will be stored. For instance, you might want to store a "status" for the new user, of "active", to control access to your app. You'd need to define the "key" = "status" and the "value" = "active".

Field Types

For each key/value pair you define and provide a value on the Fields list, you must provide the same key, but with the type of the value, on the Field Types input. That allows the plugin to turn the texts being fed into the plugin into corresponding values on the JSON structure sent to Firestore.

If the number of Fields and Field Types don't match, the action will result in an error.


Triggered events

  • User Signed Up (if the action was successful and it's the first time the user logged in)

  • User Logged In (if the action was successful and it's not the first time the user logged in)

  • Error in Action (if an error occurs)


Stored values on the listener

User ID

The ID of the user and document created by the action.

User Email

The email of the user account created by the action.

Error Message

If an error occurs, you can check its details on this state on the action listener.

When you select the GitHub method, you'll have to fill the Client ID and Client Secret fields. They can be obtained from the . You'll need to create a new app and, in it, generate a new Client Secret. You'll also need to allow for the callback URL provided by Firebase (the one ending with "__/auth/handler") on your Github app "General" settings.

This will link the action with a of the same ID.

When the function finishes running, it will trigger the event, storing the and on the listener's states.

Since a new document is being created, you can store data in it the same way it is done to any .

See the to see which types are currently supported by the plugin and how to define them.

Those events are triggered by an with the same ID as the provided on the action.

Developer Settings on Github
Action Listener
User Signed Up
New User ID
New User Email
new document
field types table
Action Listener
Trigger ID
Firebase Console
https://console.firebase.google.com/u/0/project/YOUR_PROJECT_ID/authentication/providers