How to Obtain Firebase Integration Key

Introduction

Firebase is a comprehensive mobile and web application development platform developed by Google, offering a suite of services to streamline the development, enhancement, and growth of applications. At its core, Firebase provides a real-time NoSQL database for seamless data synchronisation, coupled with robust authentication services supporting various sign-in methods. The platform extends its capabilities with serverless Cloud Functions, enabling the deployment of custom back-end logic in response to events without the need for server management. Firebase further includes cloud storage for secure content storage, a powerful hosting solution for static and dynamic web applications, and Firestore, a scalable NoSQL database with real-time data synchronisation. With Firebase, developers can efficiently manage user authentication, send notifications through Firebase Cloud Messaging, and leverage a range of tools designed to simplify and optimise the development life cycle. A Firebase connector can be configured in SigningHub Admin by providing the Project ID and the Private Key File (.json).


How it works?

  1. Obtain the Firebase Integration Key.

  2. Create a Firebase connector in SigningHub Admin.

  3. Configure the Firebase Connector as Default in SigningHub Admin.


Obtain the Firebase Integration Key

  1. Sign in to the Firebase console using your Google account credentials.

  2. Select the project from the "Your Firebase Projects" page.

  3. The "Project Overview" page will appear. Click on the settings icon, and select "Project settings" from the drop-down.

  4. From the "General" tab, get the "Project ID". (The "Project ID" will be needed while creating a connector.)

  5. Click on the "Service accounts" tab.

  6. Click on the "Generate a new private key" button.

  7. Click on the "Generate key" button from the pop-up. A .json file will be downloaded. (This "Private Key File" will be needed while creating a connector.)

  8. Create a Firebase Connector, using the Project ID from step 4, and the Private Key File from step 7.


Create a Firebase connector

  1. Access the SigningHub Admin portal.

  2. Click the 'Configurations' option from the navigation panel.

  3. Click the 'Connectors' option.

  4. Click theicon from the grid header.

  5. The 'Add' connector screen will appear to add the connector details. It comprises of two sections, i.e. Basic Information and Details. Specify the basic information and click the button to provide the respective connector details.

  6. Click the 'Create' button. A new connector will be saved and displayed in the list. See the table below for field descriptions.

Basic Information

Fields

Description

Name

Specify a unique name for this connector, i.e. My Firebase. This connector will be used in the configuration of Global Settings.

Provider

Select the provider for this connector, i.e. "Firebase".

Purpose

This field will display the purpose of the selected provider above, i.e. the purpose of "Firebase" is "Push Notifications".

Active

Tick this check box to make this connector active. Inactive connectors cannot be configured in the Global Settings.

Details

Fields

Description

Logo

Select an appropriate image in the jpeg, jpg, gif or png format for the connector's logo.

Project ID

Specify the project ID of your Firebase project. e.g. "signinghub-23c56". This ID is available in the General project settings tab of the Firebase console.

Private Key File (.json)

Upload the private key file for your service account in .json format. This private key file will be used to authenticate a service account and authorise it to access Firebase services.

  1. To generate a private key file for your service account:

    • In the Firebase console, open Settings > Service Accounts.

    • Click Generate New Private Key, then confirm by clicking Generate Key.

    • Securely store the JSON file containing the key.

    (Since the private key gives access to your project's Firebase services, SigningHub stores your private key file in an encrypted format.)


Configure the Firebase Connector as the Default in the SigningHub Global Settings

  1. Access the SigningHub Admin portal.

  2. Click the 'Configurations' option from the navigation panel.

  3. Click the 'Global Settings' option.

  4. Select the 'Default Connectors' option from the drop-down.

  5. Click the field adjacent to "Default Push Notifications Connector". A drop-down containing all the active push notification connectors will appear. From the drop-down down select the connector that you want to configure as default. See the table below for the description of the "Default Push Notifications Connector" field.

  6. Click on the "Save" button, and the selected connector will be set as the default.

Global Settings - Default Connectors

Fields

Description

Default Push Notifications Connector

Select the default push notification connector for your SigningHub Desktop Web. The selected connector will be used to send push notifications to SigningHub native mobile apps. The push notification connectors are managed through the connectors section, see details.

  1. From now onwards, to send push notifications, in case of a fresh installation, the Firebase connector will have to be manually reconfigured as the "Default Push Notification Connector".

Last updated