Fabric and Firebase Linkings

This guide will show you the flow to link a Fabric app to a Firebase app. If needed, you’ll create a new Firebase app, which will allow for your Digits customer data to be migrated to Firebase Authentication. This will enable a seamless transition for your app’s users. It will not affect your current app or production users in any way, shape or form.

Note

This flow currently only covers linking data between Fabric and Firebase and does not include the SDK changes. The SDK changes that are needed are linked to at the bottom of this guide.

When you click on any of the buttons described below, your production app and users will not be affected. Enabling this will allow Fabric to create a seamless transition for your users when you choose to update your SDKs to Firebase Authentication or let you export your app’s data.

This migration process involves two steps. First, we’ll help you create a Firebase project and app. Second, we’ll automatically migrate your authentication data so that your existing, verified users won’t need to log in again. Just as a reminder, this migration process will have no impact on your current users. As new users sign-up into your app, we will continue to migrate their information as well.

FAQ

Q: What happens when I click on buttons during App & Account Linking?

You’re creating a link between Fabric and Firebase so that we can start transferring Digits data for your app to Firebase. This way, when you update the SDK at a later date, the users of your app will not be logged out of your app and all of your Digits data will be in Firebase.

Q: Why should I migrate? With Firebase Authentication, we’ve added in many of the most heavily requested features for Digits such as:

  1. A fully customizable design and UI.
  2. Direct access to the client API.
  3. (Digits by Twitter) is being removed from the SMS message. Only your app’s name will be present.
  4. There is no longer a separate agreement to the Digits Terms of Service for your users.

Warning

Digits, will be shutdown on September 30, 2017 and at that point attempts to use any part of Digits will not work.

Q: What do I lose access to?

  1. Code delivery via voice call
  2. Optional PIN code security for end users
  3. End-user management of Digits accounts on digits.com
  4. Sandbox environment
  5. tvOS and Internet of Things login
  6. Friend finder

Q: Has the minimum Android or iOS supported versions changed?

No, the minimum Android version supported remains at API 14 and the minimum iOS version supported remains at 8.0.

Q: What if I want to use another service?

We understand that Firebase Authentication may not be perfect for everyone. After linking Fabric and Firebase apps, you can export your data and then take it wherever you want to go.

Q: How should I set things up in Firebase?

If you’re working on multiple apps that are the same, but on different platforms, we recommend creating those under one Firebase project unless you want to keep your Digits user bases separate. A Firebase project can contain many apps, so my.amazing.android.app and my.amazing.ios.app could be both created under a project called “My Amazing Apps”. When you’re ready to link another app between Fabric and Firebase, you can decide then if you want to create a new project for that app.

Q: How should I set up Firebase if I’m using the same Digits id between multiple apps?

When adding your apps to Firebase, for any apps that share the same Fabric Digits id, just add each app to the same project and you’ll be all set.

Q: What should I do if I’m using Digits for my tvOS app.

AppleTV is not currently supported by Firebase phone authentication. However, you are able to migrate users of your AppleTV app to Firebase to avoid losing access to them:

  1. In your logged in Fabric.io console, switch to your AppleTV app.
  2. Click on the Digits tab and follow the instructions. When prompted to create an app in Firebase, create an iOS app.
  3. Back on Fabric.io console, choose the iOS app you created in step 2. to link to your AppleTV app. You’ll receive an e-mail when the import of your Digits users to your Firebase project has completed.

Q: Are there changes to end-user policies or terms of service?

In Digits, users agreed to the Twitter terms of service, privacy, and cookie policies when verifying their phone number. In Firebase, user accounts belong to the developer. Therefore, it’s up to you for defining and displaying terms of service and other policies at your discretion.

Q: After I link my app to Firebase, how long will it take for my Digits users to show up?

After you’ve linked your app, it can take up to 24 hours to see your users migrated over. Once the migration was successful, you will receive an email confirmation.

Q: I don’t see the option to migrate to Firebase Authentication.

We’ll be rolling out access to migrate to Firebase Authentication over the next few weeks. If you don’t have access yet, hold tight, it’s coming soon!

App & Account Linking

  1. To start this process, head to your Fabric dashboard and click on Digits in the sidebar.
../_images/select-digits-dashboard.png

Note

You need to be an Admin within the Fabric organization to start the linking.

  1. Now, you can start linking your Fabric account to a new Firebase account or an existing Firebase account. Just as a reminder, this will not affect your app or your app’s users in any way. After linking your Fabric account, you’ll be able to migrate (if you choose to do so) to using Firebase Authentication and transfer your Digits data over while also ensuring that your users are not logged out of your app.
../_images/digits-moving-firebase.png
  1. Please sign in with your Google account that should be associated with your Firebase app. This could be your own personal Gmail account, a G Suite account or an account you’ve set up as the master Google login for all of your apps.
../_images/sign-in-with-google.png

If you’re already logged into a Google account on your browser, you will see that selected instead.

../_images/google-account-preselected.png
  1. If you’re logged into an existing Google account, and want to change the account, click on “Use a different or new Google account” and you will see a list of your other Google accounts.
../_images/change-google-account.png

If you don’t see your Google accounts, or don’t have any, you can enter your email address to get started:

../_images/no-google-account.png
  1. After signing in, click on “Allow” in order to let Fabric link your account to Firebase. Please note, if you click “Deny”, then you’ll be unable connect Fabric and Firebase in order to migrate to Firebase Authentication. If you do click “Deny”, you can change that by starting over with the account linking flow.
../_images/permission-to-access.png

You’ll then be prompted to confirm that this is the Google account you want to use with Firebase. If you need to change this now, please click on “Use a different or new Google account”. Otherwise, click “Use YourAccount@google.com”

../_images/google-account-preselected.png
  1. If you don’t have an existing Firebase project, you’ll be prompted to create a new Firebase project and app. Creating a Firebase project and app will allow us transfer your Digits data over after the apps are linked.
../_images/no-firebase-projects.png

If you already have a Firebase project and app under this Google account, you should see an option to select them and can skip to step 11.

../_images/has-firebase-project.png
  1. Click on “Create a new Firebase project and app” to be directed to the Firebase site and then click on “Go to console”.
../_images/create-new-firebase-app.png

Note

An important item to check at this point is to confirm which Google account you’re using on Firebase. Click on your profile image in the top-right corner of https://firebase.google.com/ to confirm which Google account that will be used.

  1. Once you are on the Firebase Console, click on “Add Project”. A Firebase project can be home to many apps, similar to a Fabric organization.
../_images/create-new-firebase-project.png

Note

If you get a warning about running out of projects in Firebase, click on the dialog to fill out the quick form at https://support.google.com/code/contact/project_quota_increase to get your limit increated within a day or two. Make sure to mention that you’re a Digits customer migrating your projects into Firebase.

Note

The recommended approach is to create a project for all related Android and iOS apps. For example, you might create a Project called “MyWonderfulApps” and then have an app within each that is “myWonderfulAndroidApp” and “myWonderfulIosApp”. You can add all of your apps to one project or create multiple projects to separate out your apps if you prefer.

Fill in the details of your project and select the country you live in:

../_images/country-name-selection.png
  1. After you create this project, you need to create the app as well in Firebase. Click on either iOS or Android in the image below to create the app.
../_images/firebase-create-app.png

Note

If you don’t have an app created and go back to Fabric.io, you will not see your list of apps and projects.

Note

As a reminder, tvOS apps, should select iOS at this stage.

Fill in your app’s bundle id or package name and optionally include an app nickname to make it easy to find and remember.

../_images/firebase-created-app.png
  1. After clicking on “Register app” on the above page, click on “Skip to the console” and return to Fabric. You’re all done with the Firebase console at this point.
../_images/skip-to-console.png

Note

If you want to add Firebase to your app later, you can always click on your app within Firebase to get the needed code changes.

  1. When you’re back on Fabric.io, click on “Refresh list” to pull in your newly created Firebase project.
../_images/refresh-project-app-list.png

Note

If you don’t see anything after refreshing, make sure you added both an app and project in Firebase.

Now, select the project and app Firebase that you want to link and click “Continue”.

../_images/selected-project-fabric.png

Note

If you accidentally chose the wrong app or project, don’t worry! We give you a chance to confirm that this is correct after clicking “Continue”.

  1. Review the linking between the Fabric and Firebase apps and confirm that they are correct. When you click “Confirm and continue”, this will link your Firebase and Fabric apps.
../_images/confirm-and-continue.png

This allows us to transfer your Digits data to Firebase Authentication so that your customers experience a seamless transition.

../_images/continue-to-firebase-auth.png

SDK Migration Guides

You can now continue and setup the Firebase Authentication SDK via the steps below:

Android: https://firebase.google.com/support/guides/digits-android

iOS: https://firebase.google.com/support/guides/digits-ios

Web: https://firebase.google.com/support/guides/digits-web