Skip to content
This repository was archived by the owner on Mar 24, 2026. It is now read-only.

phone-auth.md

Latest commit

 

History

History
47 lines (27 loc) · 3.07 KB

phone-auth.md

File metadata and controls

47 lines (27 loc) · 3.07 KB

Phone Authentication

You can use Firebase Authentication to sign in a user by sending an SMS message to the user's phone. The user signs in using a one-time code contained in the SMS message.

Configuration

This guide assumes that you have already created your Firebase app and configured your iOS and Android projects as explained in README.

IOS

  1. Open your project via XCode and navigate to your GoogleService-Info.plist file (normaly located at /ios/[YourApp]/Info.plist). Copy your REVERSED_CLIENT_ID from this file.

  2. Then, click on your xcode project icon (blue one) and under Info tab expand URL Types panel. Add new url type and under URL Schema paste your previously coppied REVERSED_CLIENT_ID field value. NOTE: you might see more entries here if you use other social auth providers like Facebook. google url type

  3. Run your app and make sure that everything is working. If you run into any trouble it is worth trying to clean your caches and restart XCode.

Android

Android uses keystore system for app signing, if you haven't already done so you will need to generate keystore files for debug (later also release) builds. In depth information about this is avaliable in Android keystore documentation

  1. If you don't have one generate a debug.keystore file in your android/app directory. These keystore files are required to run android apps in debug and release mode. To generate debug keystore file run following command within android/app folder (use all default presets when prompted by terminal).

    keytool -genkey -v -keystore debug.keystore -storepass android -alias androiddebugkey -keypass android -keyalg RSA -keysize 2048 -validity 10000

  2. After you generated your debug.keystore file, run following command in the same folder (android/app) to obtain your SHA1 and SHA256 certificate fingerprints. Copy both of them, you will need them in the next step.

    keytool -list -v -keystore ./debug.keystore -alias androiddebugkey -storepass android -keypass android

  3. Once you have your SHA1 and SHA256 certificate fingerprints go yo your Firebase project settings, choose your android app and certificate fingerprints you copied from the previous step.

  4. Re-download your google-services.json file and move it to android/app folder (replace your old file if needed).

  5. Now clean your android project: In android studio go to Build > Clean Project.

    clean android build

  6. Run your app and make sure that everything is working. If you run into any trouble it is worth trying to clean your caches and restart Android Studio.

Firebase

  1. In Firebase Console go to Authentication > Sign In Method and enable Phone. While on this screen it is a good idea to add your phone number inside Phone numbers for testing (optional) section, otherwise firebase might limit your requests and you will have to wait some time before you can repeatedly sign in.