Return Values (Status Codes)

Operation succeeded.

General error.

The program encounters unexpected situation.

Not valid argument.

Not found error.

Possible cause:

• Trying to use a token before creating one.
• Certificate file not found.
• SDK failed to communicate with the iOS Watch.

Communication error.

Possible causes:

• URI of the CoTCrypto-of-Things (CoT) - Unbound's CoT ensures that your apps are secure regardless of the security posture of the device on which they’re deployed. server is invalid.
• Device communication issue.
• Not a valid response from the server.
• A communication error with Apple Watch.

This error code is reserved.

This error code is reserved.

This error code is reserved.

Cryptography error.

Indicates a mistake during generation or use of a key in the key store.

This error code is reserved.

The operation was canceled by the user.

Possible causes:

• User canceled the Touch ID signing operation.
• User canceled Apple Watch approval operation.

Touch ID is not available, or there is no fingerprint sensor.

Possible causes:

• The device does not support fingerprint authentication.
• Error while checking the device fingerprint status.

Incorrect PIN

Possible causes:

• Wrong PIN.
• Fingerprint authentication failed.
• Token with empty PIN.

Key sync error.

Possible cause:

Cryptographic error raised while trying to sync server and mobile keys/data.

The state was changed.

Possible causes:

• Fingerprint sensor was added/removed from the device.
• Lock screen was disabled, re-create token (security issue).

Operation timeout reached.

Possible causes:

• Communication problem (server is not reachable).
• The requested operation is taking more time than expected.

Communication with the server is blocked by the protocol.

Possible cause:

Too many incorrect retries (wrong PIN).

According to the server policy, there are two options:

• Wait a predefined time; the token is unlocked automatically.
• The server locks the token forever. You must re-enroll the token.

Low-level cryptographic protocol error.

The server certificate is invalid.

Server key expired.

Unbound Crypto-of-Things SDK operation called before Unbound Crypto-of-Things SDK initialization.

iOS version is not valid.

Screen lock is not activated on the device.

Possible cause:

Using DYFingerprintCredentials on a device without enabling the screen lock.

Suggestion:

Enable the screen lock on the device and add at least one fingerprint before creating the token.