Skip to main content

Obtaining configuration information

Before getting your hands dirty with code, some configuration needs to be taken care of. Be patient, this is the most complex part of the setup.

Configuration information obtained in this guide is used in later steps of the setup and in the configure() call: 1 or 2.

You do not need Firebase to configure Google Sign In. However, if you use it, it's a little easier to set up the sign in experience because Firebase gives you one file to download and put into your project.

Android​

Follow the 2 steps below to set up Google Sign In for your Android app.

danger

Completing this guide is crucial for Google Sign-In to work on Android. If not done correctly, you will get the infamous DEVELOPER_ERROR error (how to troubleshoot it).

Step 1: Obtain SHA-1 certificate fingerprints​

You probably use multiple signing configurations for your Android app - for example for building debug and release APKs locally or building on Expo EAS. Then there's the Play App Signing for store deployments - while the Google Play Store does not rebuild your app, it may re-sign it using one of its own signing configurations.

First, you need to obtain the SHA-1 certificate fingerprints for all of these signing configurations using the instructions below. Then, use all of those SHA-1 hashes in Step 2 below.

Check if "Google Play App Signing" is enabled for your app in the console. If it is enabled, you need to take the following steps:

  1. In Google Play Console, navigate to: <Your App> -> Release section (in the left sidebar) -> Setup -> App Signing.
  2. Under the "App signing key certificate" and also "Upload key certificate", take note of SHA-1 certificate fingerprint. That's a total of two or more fingerprints (Play Store sometimes has more than one "App signing key certificate"!).


Step 2: Add SHA-1 hashes to Firebase or Google Cloud Console​

Using all of the SHA-1 fingerprints obtained in the previous step, follow the instructions below.

  1. Sign in to Firebase Console and open your project.
  2. Ensure that in the "Authentication" menu, "Google" is enabled as "Sign-in method".
  3. Click the settings icon and go to "Project settings".
  4. Scroll down to "Your apps" section, and select the app.
  5. Click "Add fingerprint".
  6. Check that "Package name" is correct.
  7. Download the google-services.json file.

Firebase, add Android keystore&#39;s SHA-1 to your project

iOS​

Read below on how to set up Google Sign In for your iOS app.

  1. Sign in to Firebase Console and open your project.
  2. Ensure that in the "Authentication" menu, "Google" is enabled as "Sign-in method".
  3. Click the settings icon and go to "Project settings".
  4. Scroll down to "Your apps" section, and select the app.
  5. Check that "Bundle ID" is correct.
  6. Download the GoogleService-Info.plist file.

Web Client ID​

For some use cases, a Web Client ID is needed (provided to the configure() call). To obtain a Web Client ID, go to Google Cloud Console and find an existing one (it may have been already created by Firebase) or create a new OAuth Client ID of type Web.

Summary​

At the end of this guide, regardless of whether you use Firebase, when you visit Google Cloud Console, you should have in the "OAuth 2.0 Client IDs" section:

  • Android OAuth Client ID(s) with SHA-1 fingerprints
  • iOS OAuth Client ID(s) with iOS URL scheme
  • Web Client ID