Skip to main content

Push notifications

About push notifications​

Our push notifications feature enables you to inform the end-user that something is happening in your app that requires their attention.

This is an optional feature that you can configure in the application configuration. If you enable push, you can also toggle it when initiating the authentication.

Note

Push notifications can be used to improve the end-user experience, but you are not required to use them. They have no impact on the authentication operation itself.

Example use cases​

  • You want to notify your end-users who are attempting to log in to your website that they have a login request to approve.
  • You want to notify your end-user on their mobile device that they have a transaction to authorise.

How to implement push notifications​

To implement our push notifications feature, you need to:

Configure the application configuration​

To use push notifications, you must first configure it in your application configuration. Once it has been configured, all devices using that application configuration have the ability to receive push notifications.

Prerequisites​

Before you start, you need to create an APNs token (iOS) and set up a Firebase project (Android). To learn how to do this, use the buttons below:

Android prerequisites
Learn how to create a Firebase project for your app
iOS prerequisites
Learn how to create an APNs token for your app

Configure push notifications​

Once you have completed the prerequisites, you can configure your app to use push notifications.

Configure Android and iOS simultaneously

Currently, you need to configure push notifications for Android and iOS simultaneously.

To start, go to Signicat Dashboard > Products > MobileID > Features > Push.

1. Add APNs token​

You need to add the APNs token using the values obtained when you created it in the Apple Developer Program Portal.

To do this:

  1. Select the APN tokens tab.
  2. Click the + Add new button.
  3. Add the following values to the fields in the dialogue box:
    Field nameDescription
    NameGive the APNs token a name.
    DescriptionGive the APNs token a description.
    Key IDAdd the Key ID that you obtained when you created the token.
    Team IDAdd your Team ID that you obtained from Membership details.
    Private keyAdd the private key from the .p8 file that you downloaded when you created the token.

    Note: You can open the .p8 file using a text editor app.
  4. Click the Add button.
Tip

An APNs token can be used by all accounts in the same organisation.

2. Enable push notifications​

You need to enable and configure push notifications in your application configuration.

To do this:

  1. Select the Configuration tab.
  2. Use the toggle button to enable push notifications. Once enabled, additional options that you can use to configure push notifications become available.
  3. To configure APNs:
    1. Select the APNs token that you created.
    2. Add the Bundle ID that you obtained from Identifiers in the prerequisite step.
  4. To configure Firebase, add the contents of the .json key file obtained in the prerequisite step to the Firebase service account field.
  5. Once you have finalised configuring push notifications, click the Save button.
Want to learn more?

To learn more about the configurable properties, see the Push notifications section in our Application configuration feature documentation.

Configure the mobile SDK​

You must also configure the SDK for push notifications. To learn how to do this, read the platform-specific documentation using the buttons below:

Configure the Android SDK
Learn how to configure the Android SDK for push notifications
Configure the iOS SDK
Learn how to configure the iOS SDK for push notifications
Last updated:
On this page