EMCapTokenManager Protocol Reference

Conforms to EMTokenManager
NSObject
Declared in EMCapTokenManager.h

Overview

CAP Token Manager

– tokenWithName:error: required method

Returns an existing token with the given name.

- (id<EMCapToken>)tokenWithName:(NSString *)name error:(NSError **)error

Parameters

name

The name of the token.
error

If an error occurs, upon return contains an NSError object that describes the problem. If you are not interested in possible errors, you may pass in NULL.

Return Value

The token, nil if not found or if an error occurred.

Declared In

EMCapTokenManager.h

– tokenWithName:fingerprintCustomData:error: required method

Returns an existing token with the given name and fingerprint.

- (id<EMCapToken>)tokenWithName:(NSString *)name fingerprintCustomData:(NSData *)fingerprintCustomData error:(NSError **)error

Parameters

name

The name of the token.
fingerprintCustomData

The fingerprint custom data.
error

If an error occurs, upon return contains an NSError object that describes the problem. If you are not interested in possible errors, you may pass in NULL.

Return Value

The token, nil if not found or if an error occurred.

Declared In

EMCapTokenManager.h

– tokenWithUti:error: required method

Returns an existing token with the given UTI (user token id).

- (id<EMCapToken>)tokenWithUti:(long)uti error:(NSError **)error

Parameters

uti

The UTI of the token.
error

If an error occurs, upon return contains an NSError object that describes the problem. If you are not interested in possible errors, you may pass in NULL.

Return Value

The token, nil if not found or if an error occurred.

Availability

4.5

Declared In

EMCapTokenManager.h

– tokenWithUti:fingerprintCustomData:error: required method

Returns an existing token with the given UTI (user token id) and fingerprint.

- (id<EMCapToken>)tokenWithUti:(long)uti fingerprintCustomData:(NSData *)fingerprintCustomData error:(NSError **)error

Parameters

uti

The UTI of the token.
fingerprintCustomData

The fingerprint custom data.
error

If an error occurs, upon return contains an NSError object that describes the problem. If you are not interested in possible errors, you may pass in NULL.

Return Value

The token, nil if not found or if an error occurred.

Availability

4.5

Declared In

EMCapTokenManager.h

– createTokenWithName:provisioningConfiguration:completionHandler: required method

Starts the creation of a new token with the specified token name and the provisioning configuration. Before creating the token, integrator has to make sure there is no existing token with the same token name.

- (void)createTokenWithName:(NSString *)name provisioningConfiguration:(EMProvisioningConfiguration *)configuration completionHandler:(void ( ^ ) ( id<EMCapToken> token , NSError *error ))completionHandler

Parameters

name

The token name.
configuration

The provisioning configuration.
completionHandler

mandatory block to be invoked when error occurs or when token creation is completed.

Declared In

EMCapTokenManager.h

– createTokenWithName:provisioningConfiguration:deviceFingerprintTokenPolicy:completionHandler: required method

Starts the creation of a new token with the specified token name, provisioning configuration, and device fingerprint policy. Before creating the token, integrator has to make sure there is no existing token with the same token name. This API does not support Mobile Provisioning Protocol version 5.

- (void)createTokenWithName:(NSString *)name provisioningConfiguration:(EMProvisioningConfiguration *)configuration deviceFingerprintTokenPolicy:(EMDeviceFingerprintTokenPolicy *)deviceFingerprintTokenPolicy completionHandler:(void ( ^ ) ( id<EMCapToken> token , NSError *error ))completionHandler

Parameters

name

The token name.
configuration

The provisioning configuration.
deviceFingerprintTokenPolicy

device fingerprint token policy
completionHandler

mandatory block to be invoked when error occurs or when token creation is completed.

Declared In

EMCapTokenManager.h

– createTokenWithName:provisioningConfiguration:deviceFingerprintTokenPolicy:extendedCompletionHandler: required method

Starts the creation of a new token with the specified token name, provisioning configuration, and device fingerprint policy. Before creating the token, integrator has to make sure there is no existing token with the same token name. This API support Mobile Provisioning Protocol version 5 which will allows extensions to provide additional information set by the server, if any.

- (void)createTokenWithName:(NSString *)name provisioningConfiguration:(EMProvisioningConfiguration *)configuration deviceFingerprintTokenPolicy:(EMDeviceFingerprintTokenPolicy *)deviceFingerprintTokenPolicy extendedCompletionHandler:(void ( ^ ) ( id<EMCapToken> token , NSDictionary *extensions , NSError *error ))completionHandler

Parameters

name

The token name.
configuration

The provisioning configuration.
deviceFingerprintTokenPolicy

device fingerprint token policy
completionHandler

mandatory block to be invoked when error occurs or when token creation is completed. Specific for Mobile Provisioning Protocol version 5, this handler will contains extensions information for any string extension of “client.app.*”

Availability

5.0

Declared In

EMCapTokenManager.h

– createLowPlatformCouplingToken:provisioningConfiguration:extendedCompletionHandler: required method

To Creates a LowPlatformCoupling Token which is not affected by the changes in DeviceFingerprint. A LowPlatformCoupling Token only permits PIN mode. [token upgradeToMultiAuthMode:input error:error] call is not allowed.

- (void)createLowPlatformCouplingToken:(NSString *)name provisioningConfiguration:(EMProvisioningConfiguration *)configuration extendedCompletionHandler:(void ( ^ ) ( id<EMCapToken> token , NSDictionary *extensions , NSError *error ))completionHandler

Parameters

name

The token name.
configuration

The provisioning configuration.
completionHandler

mandatory block to be invoked when error occurs or when token creation is completed. Specific for Mobile Provisioning Protocol version 5, this handler will contains extensions information for any string extension of “client.app.*”

Availability

5.2.0

Declared In

EMCapTokenManager.h