# Social Login with Firebase

This guide covers how to set up a login page in Bravo using Firebase as the user management service.  where users log in with their existing Google/Apple accounts. 

{% hint style="info" %}
**What is Firebase?** [Firebase](https://firebase.google.com/) is a backend-as-a-service (Baas) from Google that provides features for building mobile apps.
{% endhint %}

## 1. Setting up the UI

#### 💾 Sample design file

Here is a sample design file that already contain all the necessary tags for the Social logins (Google and Apple). This can also be combined in the same file with email and password login or phone login in case you want to provide all the options.

{% embed url="<https://www.figma.com/community/file/1146791061495744743>" %}
Sample design for social login
{% endembed %}

{% hint style="warning" %}
Apple login is only supported on iOS devices.
{% endhint %}

### **1.1. Social login page (Google and Apple)**

Use the tags below to set up Google and Apple login:

* <mark style="color:red;">`[action:login:firebase-google]`</mark>: Performs the Google login action, needs to be added in the Google login button.
* <mark style="color:red;">`[action:login:firebase-apple]`</mark>: Performs the Apple login action, needs to be added in the Apple login button. Note that **Apple login will only work on iOS devices**.
* <mark style="color:red;">`[ignore:android]`</mark>: As Apple login is not supported on Android devices, it is recommended to hide the Apple login button there, to provide a good user experience. This tag will hide the UI element attached to it on Android devices.

<figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FeNZ78bQgg4610tC7C8wQ%2Fimage.png?alt=media&#x26;token=0b952988-0b05-49e0-bbca-3f9b8874dff7" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Social logins will only work on the **final apps** (test or released), not in Bravo Vision.
{% endhint %}

{% hint style="warning" %}
For phone and social logins, **there's no signup page** - the login action will also create new accounts for first-time users.
{% endhint %}

## 2. Set up in Firebase

Once you have the UI ready, it's time to manage user authentication in your existing Firebase project.

If you haven't created your Firebase project yet, follow the steps provided [here](https://docs.bravostudio.app/integrations/user-authentication/app-login-firebase/..#create-your-firebase-project).

### 2.1. Enable authentication

1. After the project is created, click **on Project Overview** from the left menu and then select **Authentication**. Here is where your user accounts will be created and stored.&#x20;
2. Go to **Sign-in method** tab, click on **Add new provider** to activate the **Google** and/or **Apple** sign-in.

<figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FdhDzlITSOkTguCL0MoIv%2Fimage.png?alt=media&#x26;token=6436675c-a296-4753-8fc4-c64de4d1914d" alt=""><figcaption></figcaption></figure>

3. Select your desired provider and **toggle the Enable** button to activate.
4. Complete the required **Public-facing name** and **Support email** fields for project-
5. Finally, click **Save**.

## 3. **Firebase Configuration in Bravo** <a href="#social-login-settings" id="social-login-settings"></a>

To activate the Social login (Google and Apple), you may complete the following:

1. Go to Bravo Studio, select your app and go to **Integrations** > **Login** > **Enable Firebase** > **Activate Social Login.**

<figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FDAuPUJxCd2EcBnzIZoXV%2FScreenshot%202023-07-18%20at%2010.46.05.png?alt=media&#x26;token=8298ac59-b8e9-42ab-8890-9dcfa0dc8cae" alt=""><figcaption><p>Activate Social Login button from Bravo Studio</p></figcaption></figure>

2. Now, you need to obtain the Firebase configuration files (**GoogleService-Info.plist for iOS** and **google-services.json for Android)** and upload them to Bravo.\
   \
   The purpose of this configuration file is to **create a link between our app and this Firebase project**.  So, if in the future, you want to connect to another Firebase project, you can do it by uploading a new Firebase configuration file in Bravo for each mobile platform (iOS and Android). \
   \
   Depending on your needs, you can either:\
   \
   \- [Set up your Firebase Login for Bravo Vision](#id-3.1.-firebase-services-for-bravo-vision) (recommended for prototyping and testing)\
   \- [Set up your Firebase Login for your live or published app ](#id-3.2-firebase-services-for-published-app)(recommended for publishers)

{% hint style="info" %}
In case you want to configure both Bravo Vision and live app for iOS and Android, you will need 4 apps in Firebase and download 4 files in total:<br>

* The <mark style="color:red;">`"com.codelesslabs.app"`</mark> app will provide you the **GoogleService-Info.plist** for **iOS Bravo Vision**
* **The** <mark style="color:red;">`"com.appfoundry.previewer"`</mark> app will provide you the **google-services.json** for **Android Bravo Vision**
* An app with the <mark style="color:red;">`bundle ID`</mark> will provide you the **GoogleService-Info.plist** for **iOS published app.**
* An app with the <mark style="color:red;">`Android package name`</mark> will provide you the **google-services.json** for **Android published app.**

{% endhint %}

Follow the steps below to see how to configure them in Firebase:

### **3.1. Firebase Services for Bravo Vision**

Here are the steps to follow if you want to get the configuration files for Bravo Vision:

#### 3.1.1.  Create an app and download the Config files for Bravo Vision

If you don't have any app created in Firebase yet, follow the next steps as **you need to create new Firebase configuration** **files** to upload them to Bravo Studio.&#x20;

1. Scroll down to **Your apps** section and click **Add app**.
2. **Choose a platform** (iOS or Android) and do the following depending on the platform:

{% tabs %}
{% tab title="IOS" %}

1. Go to **Project Overview** (from the left menu), click the **iOS symbol.**

![](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhNKqDur4tQGJPUgzbJ%2F-MhNLZe-lalbD1_cPadK%2Ffirebase8.gif?generation=1629274918818351\&alt=media)

2. In step 1, fill in the **iOS Bundle ID** for Bravo Vision: <mark style="color:red;">`com.codelesslabs.app`</mark> Leave the rest blank, and click **Register app**.

![](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhNKqDur4tQGJPUgzbJ%2F-MhNLZe4PMCTqr0fNRny%2FScreenshot_2020-10-08_at_16.24.49.png?generation=1629274918592048\&alt=media)

2. In step 2, **download** the file **GoogleService-Info.plist** and click, **Next** to continu&#x65;**.**

![](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhNKqDur4tQGJPUgzbJ%2F-MhNLZdvKvKR7p7p2aJq%2Ffirebase11.png?generation=1629274918518820\&alt=media)

3. The rest of the steps are not needed, so click **Next** for Steps 3 and 4.&#x20;
4. To finish, in **Step 5**, click **Continue to the console.**
5. To verify that the app has been created, go to your **Project Overview > General > Your apps.**
   {% endtab %}

{% tab title="Android" %}

1. Go to **Project Overview** (from the left menu), click the **Android symbol** or **Add an app.**
2. In step 1, fill in the **Android package name** for Bravo Vision: <mark style="color:red;">`com.appfoundry.previewer`</mark> Leave the rest blank, and click **`Register app`**.

![](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhNKqDur4tQGJPUgzbJ%2F-MhNLZe57jRIQKWrNGdW%2FScreenshot_2020-10-08_at_16.45.06.png?generation=1629274918605131\&alt=media)

3. In step 2, **download** the file **google-services.json.**

![](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhNKqDur4tQGJPUgzbJ%2F-MhNLZdxXXqMA4FHjsso%2Ffirebase14.png?generation=1629274918526621\&alt=media)

3. Click **Next**. The rest of the steps are not needed, so click **Next** for steps 3. In the final step, click **Skip this step** (or **Continue to console** if it's enabled).
   {% endtab %}
   {% endtabs %}

#### 3.1.2 Upload the Firebase Config files in Bravo

1. Once having the Firebase configuration files, **go back to Bravo Studio, open the App project** that has the login (or import your design file if you haven't yet) and click on the **Integrations** ta&#x62;**.**
2. Navigate to the **Login** option in the left-hand sidebar and **Enable the Firebase toggle**.
3. Once enabled, the Bravo Vision tab will be selected by default. Click on the **Configure** button to upload the Firebase files in the corresponding fields. It is also possible to do so from **Firebase Config.** <br>

   <figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FkfnKp2dvdLc2CznRO28x%2FScreenshot%202023-12-07%20at%2010.52.23.png?alt=media&#x26;token=d42e53fa-9f8f-4f84-8a27-69352b92aae5" alt=""><figcaption><p>Enable Firebase Login from the App's Integrations tab</p></figcaption></figure>

   <figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FuLA4nXKT4iYwrY3J2Qxh%2FScreenshot%202023-12-07%20at%2011.14.43.png?alt=media&#x26;token=873e7ca9-c95c-4538-bacd-5030307e7438" alt=""><figcaption><p>Upload the Firebase files from Firebase Config</p></figcaption></figure>
4. After uploading the files, do not forget to **Save** the changes. You must have a green check in order for that integration to work correctly on that platform you're setting up. If you're not setting up Firebase in a certain platform, you can ignore the warning icon.<br>

   <figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FtVEKwNI2EcEGpdUO5kFo%2FScreenshot%202023-12-07%20at%2011.26.18.png?alt=media&#x26;token=6f410982-f6d4-452c-8499-d8915d54085d" alt=""><figcaption><p>Completed Firebase Config files for Android and IOS</p></figcaption></figure>
5. Your app is ready to test! Open **Bravo Vision** to test out the login pages.

{% hint style="info" %}
On Bravo Vision, every time the app is opened, login will be required. This won't happen on the published app, where the session will be maintained until the user chooses to log out.
{% endhint %}

{% hint style="info" %}
After the user has logged in, a [variable](https://docs.bravostudio.app/connect-api/request-url-variables#built-in-variables) will be created: <mark style="color:red;">`${user.id}`</mark>`.` This built-in variable can be sent as part of an API request, to handle user-specific data in the database.
{% endhint %}

### 3.2 Firebase Services for published app

Once you are ready to publish your app to the stores, **you need to create new Firebase configuration** files with the final bundle ID (for iOS) and package name (for Android) and upload them to Bravo Studio.

![Activate Firebase services in your final app](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhNKqDur4tQGJPUgzbJ%2F-MhNLZdpKH4f4WfIGHe2%2Ffirebase-bravo4.png?generation=1629274918528211\&alt=media)

#### 3.2.1. Create an app and download the Config files for the live app

If you don't have any app created in Firebase yet, follow the next steps as **you need to create new Firebase configuration** files with the final bundle ID (for iOS) and package name (for Android) and upload them to Bravo Studio. Otherwise, add the missing params we mention:

1. Scroll down to **Your apps** section and click **Add app**.
2. Select a platform: iOS or Android.
3. Register the app and do the following depending on the platform:

{% tabs %}
{% tab title="iOS" %}

1. Enter your <mark style="color:red;">**`Bundle ID`**</mark> and <mark style="color:red;">**`App Store ID`**</mark>. Remember you need to complete [step 2 of the publishing process](https://docs.bravostudio.app/app-publication/publishing-your-app/ios-publication-complete-process/generate-certificates-appids-and-provisions) to have these parameters ready.

**Where do I find the final Bundle ID (for iOS)?**

When you have the necessary files for publication, use the same **Bundle ID** from the Bravo publication form for the final Firebase file. (Check how to [set up the Bundle ID](https://docs.bravostudio.app/app-publication/publishing-your-app/ios-publication-complete-process) on the app publication process)

![Register iOS app with iOS bundle ID](https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fdocs%2F-MhNKqDur4tQGJPUgzbJ%2F-MhNLZdoVqpOMWLn5ido%2Ffirebase-bravo3.png?generation=1629274918607348\&alt=media)

2. Additionally on iOS, you also need to set up Apple login in your **Developer Console**.&#x20;
   1. Log in to your Apple Developer account at <https://developer.apple.com/account/resources/identifiers/list>.
   2. Review the existing **identifiers** or **appID** for your app.
   3. Locate and select “**Sign In with Apple**” from the list.
   4. **Save** the changes.
   5. Visit <https://developer.apple.com/account/resources/profiles/list>.
   6. Check if your profile(s) are now marked as invalid.
   7. Edit the invalid profile(s) by adding the new identifier or mobileprovisions.
   8. **Save** the updated profile.
   9. Finally, request a new build of your app using the recently updated profile with the new identifier.
      {% endtab %}

{% tab title="Android" %}
1\. **Where do I find the final package name (for Android)?**

<figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2F3oFUYgn10vYI3QuUB3pf%2Fimage.png?alt=media&#x26;token=a7912cef-5909-451e-9894-0475bd5fff12" alt=""><figcaption></figcaption></figure>

2. To enable Google login on Android final apps (remember Apple login is not supported), do the following:

   * [ ] **Obtain the first SHA-1 requesting a debug APK**. Once requested, go to the bundle history section inside your Bravo project and copy it from there:

   <figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2F7oa6HX73C9CABUt5X9Cx%2Fimage.png?alt=media&#x26;token=e8ec5667-92b8-46b6-9927-6f26ac5c831a" alt=""><figcaption><p>Build request history in Bravo Studio</p></figcaption></figure>

   * [ ] **Obtain the second SHA-1 code for the published app version,** which can only be obtained from Google Play. \
     \
     In order to get this code, **you need to submit your app to** [**publication**](https://docs.bravostudio.app/app-publication/publishing-your-app/android-publication-complete-process) **first**, and have it approved by Google Play.  Copy the SHA-1 code from the section indicated below.

   <figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FnV6TRDZyLAld8yTFwA5h%2Fimage.png?alt=media&#x26;token=109c3540-19b2-4530-8b55-512c9d87cdaf" alt=""><figcaption><p>Google Play SHA-1 certificate fingerprint</p></figcaption></figure>
3. Once copied, go to Firebase and to the corresponding Firebase app inside your project, under SHA certificate fingerprints, click "**Add fingerprint**" and **paste both SHA-1 codes. Make sure** that you've added **two SHA-1 codes.**

<figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FNeSiPSbjUllTmkPE1lW3%2FScreenshot%202024-01-02%20at%2014.45.20.png?alt=media&#x26;token=b9c45307-641e-4155-ad10-0b81315ddec0" alt=""><figcaption><p>Firebase Android app</p></figcaption></figure>

Once the SHA-1 codes have been copied in the Firebase project, the app will be allowed to log in via Google.
{% endtab %}
{% endtabs %}

**3.2.2. Upload the Firebase Config files in Bravo**

1. Once having the Firebase configuration files, **go back to Bravo Studio,** select the **App > Integrations tab > Firebase Config.**

<figure><img src="https://1444025092-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXpqEanvOhm8vMtIH8i%2Fuploads%2FluWn05K0kuqefk4bIZsI%2FScreenshot%202023-12-12%20at%2011.40.35.png?alt=media&#x26;token=8680c29d-8337-48e9-90e0-3b1ec398ed65" alt=""><figcaption></figcaption></figure>

2. Under **"Activate Firebase services for final app",** upload the Firebase files in the corresponding fields and do not forget to **Save** the changes.&#x20;
3. Firebase integration has been updated in this app. Please request a new build and upload a new version to ensure your published app continues to work properly.

{% hint style="warning" %}
In case you already have a published app bundle, and you change these Firebase assets, you'll need to generate a new bundle and publish an update to the stores.
{% endhint %}

\
Once completed, your app's login is ready to test! :tada: Open **Bravo Vision** or your **Published app** to test out the login pages.