HID APPROVE SDK  5.4
HID APPROVE SDK for iOS
 All Classes Files Functions Variables Enumerations Enumerator Properties Pages
HIDProtectionPolicy.h
Go to the documentation of this file.
1 /* ---------------------------------------------------------------------------
2 © 2017-2020 HID Global Corporation/ASSA ABLOY AB. All rights reserved.
3 
4  Redistribution and use in source and binary forms, with or without modification,
5  are permitted provided that the following conditions are met:
6  - Redistributions of source code must retain the above copyright notice,
7  this list of conditions and the following disclaimer.
8  - Redistributions in binary form must reproduce the above copyright notice,
9  this list of conditions and the following disclaimer in the documentation
10  and/or other materials provided with the distribution.
11  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
12  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
13  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
14  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
15  FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
16  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
17  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
18  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
19  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
20  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
21  --------------------------------------------------------------------------- */
22 
23 #import <Foundation/Foundation.h>
24 #import "HIDIdentifier.h"
25 
35 typedef enum
36 {
41 } HIDLockType;
42 
46 @protocol HIDLockPolicy
47 
53 
54 @end
55 
60 
65 - (int)counter;
66 
67 @end
68 
100 
105 - (int)counter;
106 
111 - (int)delay;
112 
113 @end
114 
118 typedef enum
119 {
123 
124 } HIDPolicyType;
125 
129 @protocol HIDProtectionPolicy <NSObject>
130 
136 
142 
148 
149 @end
150 
190 - (BOOL)changePassword:(NSString*)oldPassword new:(NSString*)newPassword error:(NSError**)error;
191 
205 - (BOOL)verifyPassword:(NSString*)password error:(NSError**)error;
206 
211 - (int)minLength;
212 
217 - (int)maxLength;
218 
223 - (int)minUpperCase;
224 
229 - (int)minLowerCase;
230 
235 - (int)minNumeric;
236 
241 - (int)minNonAlpha;
242 
247 - (int)minAlpha;
248 
253 - (int)maxUpperCase;
254 
259 - (int)maxLowerCase;
260 
265 - (int)maxNumeric;
266 
271 - (int)maxNonAlpha;
272 
277 - (int)maxAlpha;
278 
286 - (int)minAge;
287 
294 - (int)maxAge;
295 
300 - (int)currentAge;
301 
308 - (int)maxHistory;
309 
314 - (BOOL)isCacheEnabled;
315 
320 - (int)getCacheTimeout;
321 @end
322 
326 typedef enum
327 {
333 
338 
345 - (BOOL)enableBioAuthentication:(NSString*)sPassword error:(NSError**)error;;
346 
352 
353 @end
354 
359 
360 @end
361 
The credential never locks.
Definition: HIDProtectionPolicy.h:37
The device has no biometric sensor, authentication with biometrics is not possible.
Definition: HIDProtectionPolicy.h:330
Lock Policy with specific access constraints.
Definition: HIDProtectionPolicy.h:46
int maxAge()
Returns the maximum age for a password. This detmines how long users can keep a password before they ...
int maxAlpha()
Returns the maximum number of alphabetical characters.
Authentication with biometrics is enabled, the SDK will accept password as nil in authentication meth...
Definition: HIDProtectionPolicy.h:328
int minLowerCase()
Returns the minimum number of lower case letters.
int maxNonAlpha()
Returns the maximum number of special characters.
The protection policy defines the security parameters associated with a key or data item...
Definition: HIDProtectionPolicy.h:129
The user did not enrolled biometric features at the device level, authentication with biometrics cann...
Definition: HIDProtectionPolicy.h:331
An exponential delay is added for each failed authentication attempt using that credential.
Definition: HIDProtectionPolicy.h:39
HIDLockType
Known types of lock policy.
Definition: HIDProtectionPolicy.h:35
int maxUpperCase()
Returns the maximum number of upper case letters.
id< HIDLockPolicy > lockPolicy()
Returns the lock policy.
int maxLength()
Returns the maximum password length.
The access to the credential will be limited by applying an exponential delay for each failed attempt...
Definition: HIDProtectionPolicy.h:99
Protection Policy with password specific constraints.
Definition: HIDProtectionPolicy.h:172
Protection Policy with device derived key protection.
Definition: HIDProtectionPolicy.h:358
int minNumeric()
Returns the minimum number of numbers.
HIDLockType lockType()
returns the lock policy type.
HIDBioAuthenticationState
Working state of authentication with biometrics.
Definition: HIDProtectionPolicy.h:326
Represents a protection policy of type BioPasswordPolicy.
Definition: HIDProtectionPolicy.h:337
int currentAge()
Returns the current password age since last change.
The credential access is limited by delegating validation and blocking to server-side controls...
Definition: HIDProtectionPolicy.h:40
int maxNumeric()
Returns the maximum number of numbers.
int maxHistory()
Returns the max password history limit. This security setting determines the number of unique new pas...
int counter()
Returns the maximum counter value after which exponential delay is fixed.
HIDPolicyType
Protection policy types.
Definition: HIDProtectionPolicy.h:118
int counter()
Returns the max counter value of the credential before it gets locked.
HIDIdentifier * policyId()
Returns the protection policy identifier.
HIDPolicyType policyType()
Returns the protection policy type.
object identifier.
Definition: HIDIdentifier.h:34
HIDBioAuthenticationState getBioAuthenticationState()
Returns the current working state of authentication with biometrics.
Item is protected by a password provided by the user.
Definition: HIDProtectionPolicy.h:120
int maxLowerCase()
Returns the maximum number of lower case letters.
Item is protected by device-specific information.
Definition: HIDProtectionPolicy.h:121
int getCacheTimeout()
Gets password cache timeout.
Item is protected by external biometric policy.
Definition: HIDProtectionPolicy.h:122
The credential locks after a certain number of attempts.
Definition: HIDProtectionPolicy.h:38
Authentication with biometrics is not enabled. To enable, a call to HIDBioPasswordPolicy.enableBioAuthentication is required.
Definition: HIDProtectionPolicy.h:329
int minLength()
Returns the minimum password length.
Object reference.
int delay()
Returns the initial delay in seconds.
int minNonAlpha()
Returns the minimum number of special characters.
int minUpperCase()
Returns the minimum number of upper case letters.
BOOL isCacheEnabled()
Gets password cache flag.
The access to the credential will be locked after a configurable number of failed attempts...
Definition: HIDProtectionPolicy.h:59
int minAlpha()
Returns the minimum number of alphabetical characters.
int minAge()
Returns the minimum age for a password change. This security setting determines the period of time (i...