EMMobileProtector

Objective-C


@interface EMMobileProtector : NSObject

Swift

class EMMobileProtector : NSObject

EMMobileProtector represents the entry point to the SDK features related to One-Time-Password computation.

Since

5.3

  • Check System Biometric type

    Declaration

    Objective-C

    - (EMSystemBiometricType)systemBiometricType;

    Swift

    func systemBiometricType() -> EMSystemBiometricType

    Return Value

    type of system biometric

  • Check if System Biometric mode is supported by the device.

    Declaration

    Objective-C

    - (BOOL)isSystemBiometricModeSupported;

    Swift

    func isSystemBiometricModeSupported() -> Bool

    Return Value

    YES if the system biometric mode is supported. Otherwise NO.

  • Check if System Biometric has been configured on the device. To use the feature, user has to have device lock screen setup and enrolled at least 1 fingerprint/face.

    Declaration

    Objective-C

    - (BOOL)isSystemBiometricModeConfigured;

    Swift

    func isSystemBiometricModeConfigured() -> Bool

    Return Value

    YES if the system biometric mode is configured. Otherwise NO.

  • Update the old device fingerprint source to new one. This API will help to change (add or remove) the TokenDevice properties, such as:

    • The custom fingerprint data
    • The fingerprint source type ‘EMFastTrackDeviceFingerprintSource’

    Since

    5.4

    Declaration

    Objective-C

    - (BOOL)updateDeviceFingerprintSourceWithTokenDeviceName:
            (nonnull NSString *)tokenDeviceName
                                oldFingerprintCustomData:
                                    (nullable NSData *)oldFingerprintCustomData
                              newDeviceFingerprintSource:
                                  (nonnull EMFastTrackDeviceFingerprintSource *)
                                      newDeviceFingerprintSource
                                                   error:(NSError *_Nullable
                                                              *_Nullable)error;

    Swift

    func updateDeviceFingerprintSource(tokenDeviceName: String, oldFingerprintCustomData: Data?, newDeviceFingerprintSource: EMFastTrackDeviceFingerprintSource) throws

    Parameters

    tokenDeviceName

    The token device name.
    oldFingerprintCustomData

    The old fingerprint custom data. This data is mandatory if the EMFastTrackDeviceFingerprintSource customData is set on EMProvisionerOptionalParameters during provisioning. NOTE: The application manages the custom fingerprint data value so that it uses the proper value while retrieving the token, for example, by calling - [EMProtectorCapTokenDevice tokenDeviceWithName:fingerprintCustomData:error]
    newDeviceFingerprintSource

    The new device fingerprint source. NOTE: The application has to retrieve the token device object again to update the changes, for example, by calling [EMProtectorCapTokenDevice tokenDeviceWithName:fingerprintCustomData:error]
    error

    If an error occurs, upon return contains an NSError object that describes the problem

    Return Value

    YES if the operation is succeeded. Otherwise NO.