Push Notification

View this page for | |

Your mobile app can optionally receive information for validation requests (authentication, transactions, etc.) via Apple APN Apple Push Notification Service for iOS push notifications.

Set Up Push Notifications

To configure push notifications for your app, you need to:

• Give your app the correct capabilities/privileges - go to UserNotifications Framework
• Obtain credentials using your developer account in order to configure the HID authentication platform so it can send push notifications to your app - APNs Overview

• Configure an Out-Of-Band Delivery Gateway in the HID authentication platform. For example:

  • Create a Notification hub in Microsoft Azure with your own account.
  • Configure an Out-Of-Band Delivery Gateway with an Azure APNS Push Delivery adapter in:
    • ActivID AS
    • ActivID Appliance
    • HID Authentication Service (API integration)

To enable push notifications for your app, you need to request the user permission for your app.

Push Notification Messages

Android, iOS/macOS and Windows push notification systems manipulate JSON messages. These messages can have proprietary members, configured in the HID authentication platform (in the OOB Delivery Gateway) and parsed by the mobile application.

Provisioning Notification Example

The prov value is a JSON object. The application retrieves it, serializes it, and passes it to the SDK (ContainerInitialization.activationCode).

Sample Provisioning Notification

{
    ... (members expected by the operating system) ...
    
			"prov": 
{...}
}

Transaction Signing Notification Example

The tds value is the Transaction identifier to be passed to the Device.retrieveTransaction method.

Sample Transaction Signing Notification

{            
    ... (members expected by the operating system) ...
    
	"tds": "<transaction id>"> 
}