Presence Authenticator

This document provides a description of and integration guidelines for the HYPR Presence Authenticator interface.

SDK for Android

Description	Value
Standard Presence AAID (Authenticator ID)	0045#0120
Library Name	HyprPresence-<version>.aar

Integration

Do This First

Before any HYPR authenticator is added to a project, be sure to follow the HYPR SDK for Android Quick Start setup and integration.

The HYPR Presence Authenticator specifically requires the following app/commonlibraries/build.gradle file additions:

dependencies {
  // HYPR Common Dependency
  api(name: 'HyprCommon', version: "${hyprVersion}", ext: 'aar')
  // HYPR Crypto Dependency
  api(name: 'crypto', version: "${cryptoVersion}", ext: 'aar') { transitive = true }
  // HYPR Presence Authenticator Dependency
  api(name: 'HyprPresence', version: "${hyprVersion}", ext: 'aar')
}

User Interface

The text used in the Presence Authenticator can be overridden in the top-level application by modifying the app/<module_name>/src/main/res/values/strings.xml file. Below are the string names and default values that can be overridden.

<resources>
    <string name="hypr_presence_register_title">Do you want to confirm this request?</string>
    <string name="hypr_presence_authenticate_title">Do you want to confirm this request?</string>
    <string name="hypr_presence_confirm_button_text">Confirm</string>
    <string name="hypr_presence_cancel_button_text">Deny</string>
</resources>

SDK for iOS

Integration Guide

1. Embed the Authenticator framework into your project.

   

2. Import the Authenticator framework into AppDelegate.m.

#import <HYPRPresence/HYPRPresence.h>
#import <HYPRCore/HYPRCore.h>

3. Enable the Authenticator and create ViewController.

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [HYPRUAFClient registerAuthenticatorModule:[HYPRPresenceAsm class]];
    
    // Create a view controller to accept the pass and confirm actions 
    
    UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"Tap Authenticator" message:"Do you want to confirm this request?" preferredStyle:UIAlertControllerStyleAlert];
    UIAlertAction *confirmAction = [UIAlertAction actionWithTitle:"Confirm" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) {
        [HYPRPresenceController.sharedInstance confirm];
    }];
    UIAlertAction *cancelAction = [UIAlertAction actionWithTitle:"Cancel" style:UIAlertActionStyleCancel handler:^(UIAlertAction * _Nonnull action) {
        [HYPRPresenceController.sharedInstance cancel];
    }];
    [alert addAction:confirmAction];
    [alert addAction:cancelAction];
    [HYPRPresenceController.sharedInstance setEnrollmentViewController:alert];
    [HYPRPresenceController.sharedInstance setVerificationViewController:alert];
  }