====== User Management API ======

사용자 등록 및 삭제할 수 있는 함수를 제공하는 API입니다.
\\

  * [[BS2_GetUserList]]: 등록된 사용자 ID 리스트를 가져옵니다.
  * [[BS2_RemoveUser]]: 사용자를 삭제합니다.
  * [[BS2_RemoveAllUser]]: 모든 사용자를 삭제합니다.
  * [[BS2_GetUserInfos]]: 주어진 사용자 ID의 정보를 가져옵니다.
  * [[BS2_GetUserInfosEx]]: [+ 2.4.0] 주어진 사용자 ID의 정보를 가져옵니다. (Job code, User phrase 포함)
  * [[BS2_EnrolUser]]: 새로운 사용자를 등록합니다.
  * [[BS2_EnrolUserEx]]: [+ 2.4.0] 새로운 사용자를 등록합니다.(Job code, User phrase 포함)
  * [[BS2_EnrollUser]]: [+ 2.6.3] 새로운 사용자를 등록합니다.
  * [[BS2_EnrollUserEx]]: [+ 2.6.3] 새로운 사용자를 등록합니다.(Job code, User phrase 포함)
  * [[BS2_GetUserDatas]]: 사용자 정보의 일부를 선별적으로 가져옵니다.
  * [[BS2_GetUserDatasEx]]: [+ 2.5.0] 사용자 정보의 일부를 선별적으로 가져옵니다.(Job code, User phrase 포함)
  * [[BS2_GetSupportedUserMask]]: 장치에서 지원하는 사용자 설정을 가져옵니다.
  * [[BS2_EnrollUserSmall]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 새로운 사용자를 등록합니다.
  * [[BS2_EnrollUserSmallEx]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 새로운 사용자를 등록합니다.
  * [[BS2_GetUserSmallInfos]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 주어진 사용자 ID의 정보를 가져옵니다.
  * [[BS2_GetUserSmallInfosEx]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 주어진 사용자 ID의 정보를 가져옵니다.
  * [[BS2_GetUserSmallDatas]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 사용자 정보의 일부를 선별적으로 가져옵니다.
  * [[BS2_GetUserSmallDatasEx]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 사용자 정보의 일부를 선별적으로 가져옵니다.
  * [[BS2_EnrollUserFaceEx]]: [+ 2.7.1] ''Visual Face 지원''새로운 사용자를 등록합니다.
  * [[BS2_GetUserInfosFaceEx]]: [+ 2.7.1] ''Visual Face 지원''주어진 사용자 ID의 정보를 가져옵니다.
  * [[BS2_GetUserDatasFaceEx]]: [+ 2.7.1] ''Visual Face 지원''사용자 정보의 일부를 선별적으로 가져옵니다.
  * [[BS2_PartialUpdateUser]]: [+ 2.8.3] 사용자를 정보를 부분적으로 갱신합니다.
  * [[BS2_PartialUpdateUserEx]]: [+ 2.8.3] 사용자를 정보를 부분적으로 갱신합니다.
  * [[BS2_PartialUpdateUserSmall]]: [+ 2.8.3] 사용자를 정보를 부분적으로 갱신합니다.
  * [[BS2_PartialUpdateUserSmallEx]]: [+ 2.8.3] 사용자를 정보를 부분적으로 갱신합니다.
  * [[BS2_PartialUpdateUserFaceEx]]: [+ 2.8.3] ''Visual Face 지원''사용자를 정보를 부분적으로 갱신합니다.
  * [[BS2_GetUserStatistic]]: [+ 2.8.3] 장치가 보유한 사용자 통계 정보를 가져옵니다.
  * [[BS2_GetUserOverride]]: [+ 2.9.12] 지정된 조건에 해당하는 연장된 출입문 개방 시간 대상 사용자 정보를 가져옵니다.
  * [[BS2_GetAllUserOverride]]: [+ 2.9.12] 연장된 출입문 개방 시간을 사용하는 사용자 정보를 모두 가져옵니다.
  * [[BS2_SetUserOverride]]: [+ 2.9.12] 연장된 출입문 개방 시간을 사용할 사용자를 설정합니다.
  * [[BS2_RemoveUserOverride]]: [+ 2.9.12] 연장된 출입문 개방 시간을 사용하는 사용자를 삭제합니다.
  * [[BS2_RemoveAllUserOverride]]: [+ 2.9.12] 연장된 출입문 개방 시간을 사용하는 모든 사용자를 삭제합니다.
===== 구조체 =====
==== BS2User ====
<code cpp>
typedef struct {
    char userID[BS2_USER_ID_SIZE];
    uint8_t formatVersion;
    uint8_t flag;
    uint16_t version;
    uint8_t numCards;
    uint8_t numFingers;
    uint8_t numFaces;
    uint8_t infoMask;
    uint32_t authGroupID;
    uint32_t faceChecksum;
} BS2User;
</code>

1. //userID// \\ 
사용자 식별자로 문자열 숫자이며, 1 ~ 4294967295의 범위를 가집니다. \\ \\ 
2. //formatVersion// \\ 
사용되지 않음. \\ \\ 
3. //flag// \\ 
사용자의 상태를 나타내는 flag값으로 OR 연산이 가능합니다. 마스크값은 아래와 같습니다. \\
<WRAP group 50%>
^값  ^설명  ^
|0x00  |None  |
|0x01  |사용자가 생성됨  |
|0x02  |사용자가 갱신됨  |
|0x04  |사용자가 삭제됨  |
|0x80  |사용자가 비활성화됨  |
</WRAP>
4. //version// \\ 
사용되지 않음. \\ \\ 
5. //numCards// \\ 
사용자에게 맵핑된 카드 개수입니다. \\ \\ 
6. //numFingers// \\ 
사용자에게 맵핑된 지문 개수입니다. \\ \\ 
7. //numFaces// \\ 
사용자에게 맵핑된 얼굴 개수입니다. \\ \\ 
8. //infoMask// \\
[+ 2.8.3] 사용자가 어떤 정보를 가지고 있는지 나타내며, 이 infoMask를 변경하여, 변경할 정보와 함께 장치로 내려주면 해당 사용자 정보의 부분 변경이 가능합니다. \\
이때, Partial update 함수군들 ([[BS2_PartialUpdateUser]], [[BS2_PartialUpdateUserEx]], [[BS2_PartialUpdateUserSmall]], [[BS2_PartialUpdateUserSmallEx]], [[BS2_PartialUpdateUserFaceEx]])의 user mask 인자와의 조합이 필요합니다. (하단 표 참조) \\

<WRAP group 50%>
^값  ^설명  ^
|0x01  |BS2_USER_INFO_MASK_PHRASE  |
|0x02  |BS2_USER_INFO_MASK_JOB_CODE  |
|0x04  |BS2_USER_INFO_MASK_NAME  |
|0x08  |BS2_USER_INFO_MASK_PHOTO  |
|0x10  |BS2_USER_INFO_MASK_PIN  |
|0x20  |BS2_USER_INFO_MASK_CARD  |
|0x40  |BS2_USER_INFO_MASK_FINGER  |
|0x80  |BS2_USER_INFO_MASK_FACE  |
</WRAP>
**''사용자 정보의 취득''** \\
사용자 정보 취득 시, infoMask는 현재 사용자에 어떤 정보들이 할당되어 있는지를 나타냅니다. \\ \\
<WRAP group 50%>
^사용자 정보  ^BS2_USER_MASK  ^infoMask  ^
|부분 삭제 시  |unmasking  |unmasking  |
|부분 변경 시  |masking  |masking  |
|장치설정 유지  |unmasking  |masking  |
</WRAP>
**''사용자 정보의 부분 삭제''** \\
infoMask와, partial update 함수들 인자 user mask 모두에서, 삭제하고자 하는 정보를 unmasking 하여야 합니다. \\ \\
**''사용자 정보의 부분 변경''** \\
infoMask와, partial update 함수들 인자 user mask 모두에서, 변경하고자 하는 정보를 masking 하여야 합니다. \\ \\
**''사용자 정보의 장치설정 유지''** \\
infoMask는 masking 하고, partial update 함수들 인자 user mask는 unmasking 합니다. \\ \\
**''Credential(카드/지문/얼굴) 정보의 변경''** \\
BS2User의 numCards, numFingers, numFaces가 0인지, 그리고 fingerObjs, cardObjs, faceObjs, faceExObjs에 credential 정보가 할당되어 있는지 여부를 우선 검토하고, 부가적으로 infoMask를 검토합니다. \\
카드/지문/얼굴 정보를 0보다 큰 값으로 지정하고, infoMask에 mask를 설정하면 장치의 credential 정보를 변경 할 수 있습니다. \\
예를들어, 장치에 대상이 되는 사용자의 지문이 2개가 있는 상태에서, infoMask에 BS2_USER_INFO_MASK_FINGER를 masking하고, numFingers = 1, fingerObjs에 지문을 할당하여 내려준다면, 장치는 새로 내려준 1개 지문 만을 갖습니다. \\
만일 지문의 추가가 목적이라면, 기존 2개의 지문에 새롭게 더해질 지문 1개가 더해진, 총 3개의 지문이 내려져야만 합니다. \\ \\
**''Credential(카드/지문/얼굴) 정보의 유지''** \\
카드/지문/얼굴 각각의 credential 정보를 0으로 하고, infoMask를 masking 하면, 장치는 기존에 가지고 있는 credential 정보들을 유지합니다. \\ \\
**''Credential(카드/지문/얼굴) 정보의 삭제''** \\
카드/지문/얼굴 각각의 credential 정보를 0으로 하고, infoMask를 unmasking 하면, 장치는 각각 credential에 해당되는 정보를 삭제합니다. \\ \\
9. //authGroupID// \\ 
얼굴 그룹 매칭을 사용할시 사용자에게 할당 할 그룹의 ID. \\ \\ 
10. //faceChecksum// \\ 
사용되지 않음. \\ 


\\
==== BS2UserSetting ====
<WRAP tip 70%>
**도움말**\\
<wrap em>Visual Face 기반 장치들</wrap>의 <wrap em>개인인증 모드</wrap> 설정은 [[user management api#BS2UserSettingEx|BS2UserSettingEx]]를 사용해 주십시오.
</WRAP>
<code cpp>
typedef struct {
    uint32_t startTime;
    uint32_t endTime;
    uint8_t fingerAuthMode;
    uint8_t cardAuthMode;
    uint8_t idAuthMode;
    uint8_t securityLevel;
} BS2UserSetting;
</code>
1. //startTime// \\ 
사용자 인증이 가능한 시작 시간을 의미합니다. \\
<wrap em>978307200 (2001-01-01 00:00:00) 보다 큰 값</wrap>을 입력하여야 하며, <wrap em>0으로 설정 시 제한 없음</wrap>을 의미합니다. \\ \\ 
2. //endTime// \\ 
사용자 인증이 가능한 마지막 시간을 의미합니다. \\
<wrap em>1924991999 (2030-12-31 23:59:59) 보다 작은 값</wrap>으로 입력하여야 하며, <wrap em>0으로 설정 시 제한 없음</wrap>을 의미합니다. \\ 
날짜 확장이 포함된 펌웨어 버전 혹은 이상의 경우, 2037년까지 저장할 수 있습니다. \\
장치별 펌웨어 리비전노트를 참고하여 날짜 확장 기능 포함 여부를 확인하시기 바랍니다. \\
(예를들어, BioStation 3의 경우, 1.3.0 버전 이상부터 2037년 12월 31일 까지 설정할 수 잇습니다.)
\\ \\ 
3. //fingerAuthMode// \\ 
사용자 인증을 위한 지문 인증 설정 모드입니다. \\ 
<WRAP group 50%>
^값  ^설명  ^
|0 |지문 인증만 사용   |
|1 |지문과 PIN 인증 사용   |
|254 |사용할 수 없음  |
|255 |정의되지 않음(시스템에 정의된 모드로 동작)  |
</WRAP>
4. //cardAuthMode// \\ 
사용자 인증을 위한 카드 인증 설정 모드입니다. \\ 
<WRAP group 50%>
^값  ^설명  ^
|2 |카드 인증만 사용   |
|3 |카드와 지문 인증 사용   |
|4 |카드와 PIN 인증 사용  |
|5 |카드 인증 후 지문이나 PIN 인증 사용   |
|6 |카드, 지문, PIN 인증 사용   |
|254 |사용할 수 없음  |
|255 |정의되지 않음(시스템에 정의된 모드로 동작)  |
</WRAP>
5. //idAuthMode// \\ 
사용자 인증을 위한 ID 인증 설정 모드입니다. \\ 
<WRAP group 50%>
^값  ^설명  ^
|7 |사용자 ID 입력 후 지문 인증 사용   |
|8 |사용자 ID 입력 후 PIN 인증 사용   |
|9 |사용자 ID 입력 후 지문이나 PIN 인증 사용  |
|10 |사용자 ID 입력 후 지문과 PIN 인증 사용   |
|254 |사용할 수 없음  |
|255 |정의되지 않음(시스템에 정의된 모드로 동작)  |
</WRAP>
6. //securityLevel// \\ 
지문 인증이나 얼굴 인식을 위해 필요한 보안 수준입니다. \\ 
<WRAP group 50%>
^값  ^설명  ^
|0 |시스템에 정의된 기본 값  |
|1 |최고 낮은 보안 수준  |
|2 |낮은 보안 수준  |
|3 |기본 보안 수준  |
|4 |높은 보안 수준  |
|5 |최고 높은 보안 수준  |
</WRAP>

==== BS2UserPhoto ====

<code cpp>
typedef struct {
    uint32_t size;
    uint8_t data[BS2_USER_PHOTO_SIZE];
} BS2UserPhoto;
</code>
1. //size// \\ 
사용자 프로파일 이미지 데이터의 크기입니다. \\ \\ 
2. //data// \\ 
프로파일 이미지의 데이터이며, 최대 16kb까지 저장할 수 있습니다. \\

==== BS2UserBlob ====
<code cpp>
typedef struct {
    BS2User user;
    BS2UserSetting setting;
    uint8_t name[BS2_USER_NAME_SIZE];
    BS2UserPhoto photo;
    uint8_t pin[BS2_PIN_HASH_SIZE];
    BS2CSNCard* cardObjs;
    BS2Fingerprint* fingerObjs;
    BS2Face* faceObjs;    
    uint32_t accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];
} BS2UserBlob;
</code>
1. //user// \\ 
사용자의 기본 정보를 정의한 구조체입니다. \\ \\ 
2. //setting// \\ 
사용자 식별을 위한 설정값을 정의한 구조체입니다. \\ \\ 
3. //name// \\ 
사용자 이름이며 문자열 인코딩은 UTF-8입니다. \\ \\ 
4. //photo// \\ 
사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다. \\ \\ 
5. //pin// \\ 
PIN 값이며 반드시 //BS_MakePinCode// 함수를 통해 암호화된 문자열을 입력해야 합니다. \\ \\ 
6. //cardObjs// \\ 
사용자 인증을 위한 카드 리스트로 반드시 **user.numCards**만큼 존재해야 합니다. 데이터 형식은 [[Smartcard API]]를 참고하십시오. \\ \\ 
7. //fingerObjs// \\ 
사용자 인증을 위한 지문 템플릿 리스트로 반드시 **user.numFingers**만큼 존재해야 합니다. 데이터 형식은 [[Fingerprint API]]를 참고하십시오. \\ \\ 
8. //faceObjs// \\ 
사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 **user.numFaces**만큼 존재해야 합니다. 데이터 형식은 [[Face API]]를 참고하십시오. \\ \\ 
9. //accessGroupId// \\ 
사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\ 

==== BS2Job====

<code cpp>
typedef struct {
	uint8_t numJobs;                     
	uint8_t reserved[3];                 

	struct {
		BS2_JOB_CODE code;                 
		BS2_JOB_LABEL label;               
	} jobs[BS2_MAX_JOB_SIZE];
} BS2Job;
</code>
1. //numJobs// \\ 
사용자에 매핑된 Job 개수입니다. \\ \\ 
2. //reserved// \\ 
예약된 공간입니다.\\ \\
3. //jobs// \\ 
T&A에 사용자 Job 리스트입니다. \\

==== BS2UserBlobEx ====
<code cpp>
typedef struct {
    BS2User user;
    BS2UserSetting setting;
    uint8_t name[BS2_USER_NAME_SIZE];
    BS2UserPhoto photo;
    uint8_t pin[BS2_PIN_HASH_SIZE];
    BS2CSNCard* cardObjs;
    BS2Fingerprint* fingerObjs;
    BS2Face* faceObjs;
    BS2Job job;
    BS2_USER_PHRASE phrase;
    uint32_t accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];
} BS2UserBlobEx;
</code>
1. //user// \\ 
사용자의 기본 정보를 정의한 구조체입니다. \\ \\ 
2. //setting// \\ 
사용자 식별을 위한 설정값을 정의한 구조체입니다. \\ \\ 
3. //name// \\ 
사용자 이름이며 문자열 인코딩은 UTF-8입니다. \\ \\ 
4. //photo// \\ 
사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다. \\ \\ 
5. //pin// \\ 
PIN 값이며 반드시 //BS_MakePinCode// 함수를 통해 암호화된 문자열을 입력해야 합니다. \\ \\ 
6. //cardObjs// \\ 
사용자 인증을 위한 카드 리스트로 반드시 **user.numCards**만큼 존재해야 합니다. 데이터 형식은 [[Smartcard API]]를 참고하십시오. \\ \\ 
7. //fingerObjs// \\ 
사용자 인증을 위한 지문 템플릿 리스트로 반드시 **user.numFingers**만큼 존재해야 합니다. 데이터 형식은 [[Fingerprint API]]를 참고하십시오. \\ \\ 
8. //faceObjs// \\ 
사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 **user.numFaces**만큼 존재해야 합니다. 데이터 형식은 [[Face API]]를 참고하십시오. \\ \\ 
9. //job// \\ 
근태모드에서 사용자의 작업코드입니다. \\ \\ 
10. //phrase// \\ 
인증시 장치 UI에서 표시되는 개인 메시지입니다. \\
<WRAP group 30%>
^지원 모델  ^지원 버전  ^
|FaceStation 2  |V1.0.0 이상  |
|FaceStation F2  |V1.0.0 이상  |
|X-Station 2  |V1.0.0 이상  |
</WRAP>
11. //accessGroupId// \\ 
사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\ 

==== BS2UserSmallBlob ====
<code cpp>
typedef struct {
    BS2User user;
    BS2UserSetting setting;
    uint8_t name[BS2_USER_NAME_SIZE];
    BS2UserPhoto* photo;
    uint8_t pin[BS2_PIN_HASH_SIZE];
    BS2CSNCard* cardObjs;
    BS2Fingerprint* fingerObjs;
    BS2Face* faceObjs;    
    uint32_t accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];
} BS2UserSmallBlob;
</code>
1. //user// \\ 
사용자의 기본 정보를 정의한 구조체입니다. \\ \\ 
2. //setting// \\ 
사용자 식별을 위한 설정값을 정의한 구조체입니다. \\ \\ 
3. //name// \\ 
사용자 이름이며 문자열 인코딩은 UTF-8입니다. \\ \\ 
4. //photo// \\ 
사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다. \\ \\ 
5. //pin// \\ 
PIN 값이며 반드시 //BS_MakePinCode// 함수를 통해 암호화된 문자열을 입력해야 합니다. \\ \\ 
6. //cardObjs// \\ 
사용자 인증을 위한 카드 리스트로 반드시 **user.numCards**만큼 존재해야 합니다. 데이터 형식은 [[Smartcard API]]를 참고하십시오. \\ \\ 
7. //fingerObjs// \\ 
사용자 인증을 위한 지문 템플릿 리스트로 반드시 **user.numFingers**만큼 존재해야 합니다. 데이터 형식은 [[Fingerprint API]]를 참고하십시오. \\ \\ 
8. //faceObjs// \\ 
사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 **user.numFaces**만큼 존재해야 합니다. 데이터 형식은 [[Face API]]를 참고하십시오. \\ \\ 
9. //accessGroupId// \\ 
사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\ 


==== BS2UserSmallBlobEx ====
<code cpp>
typedef struct {
    BS2User user;
    BS2UserSetting setting;
    uint8_t name[BS2_USER_NAME_SIZE];
    BS2UserPhoto* photo;
    uint8_t pin[BS2_PIN_HASH_SIZE];
    BS2CSNCard* cardObjs;
    BS2Fingerprint* fingerObjs;
    BS2Face* faceObjs;
    BS2Job job;
    BS2_USER_PHRASE phrase;
    uint32_t accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];
} BS2UserSmallBlobEx;
</code>
1. //user// \\ 
사용자의 기본 정보를 정의한 구조체입니다. \\ \\ 
2. //setting// \\ 
사용자 식별을 위한 설정값을 정의한 구조체입니다. \\ \\ 
3. //name// \\ 
사용자 이름이며 문자열 인코딩은 UTF-8입니다. \\ \\ 
4. //photo// \\ 
사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다. \\ \\ 
5. //pin// \\ 
PIN 값이며 반드시 //BS_MakePinCode// 함수를 통해 암호화된 문자열을 입력해야 합니다. \\ \\ 
6. //cardObjs// \\ 
사용자 인증을 위한 카드 리스트로 반드시 **user.numCards**만큼 존재해야 합니다. 데이터 형식은 [[Smartcard API]]를 참고하십시오. \\ \\ 
7. //fingerObjs// \\ 
사용자 인증을 위한 지문 템플릿 리스트로 반드시 **user.numFingers**만큼 존재해야 합니다. 데이터 형식은 [[Fingerprint API]]를 참고하십시오. \\ \\ 
8. //faceObjs// \\ 
사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 **user.numFaces**만큼 존재해야 합니다. 데이터 형식은 [[Face API]]를 참고하십시오. \\ \\ 
9. //job// \\ 
근태모드에서 사용자의 작업코드입니다. \\ \\ 
10. //phrase// \\ 
인증시 장치 UI에서 표시되는 개인 메시지입니다. \\
<WRAP group 30%>
^지원 모델  ^지원 버전  ^
|FaceStation 2  |V1.0.0 이상  |
|FaceStation F2  |V1.0.0 이상  |
|X-Station 2  |V1.0.0 이상  |
|BioStation 3  |V1.0.0 이상  |
</WRAP>
11. //accessGroupId// \\ 
사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\ 


==== BS2UserSettingEx ====
<WRAP tip 70%>
**도움말**\\
<wrap em>Visual Face 기반 장치들 외</wrap>의 장치에 대한 <wrap em>개인인증 모드</wrap> 설정은 [[user management api#BS2UserSetting|BS2UserSetting]]를 사용해 주십시오.
</WRAP>
<code cpp>
typedef struct {
    uint8_t faceAuthMode;
    uint8_t fingerprintAuthMode;
    uint8_t cardAuthMode;
    uint8_t idAuthMode;
    uint8_t reserved[28];
} BS2UserSettingEx;
</code>
1. //faceAuthMode// \\ 
사용자 인증을 위한 얼굴 인증 설정 모드입니다. \\
<WRAP group 60%>
^값  ^1단계 인증  ^2단계 인증  ^3단계 인증  ^4단계 인증  ^
|11 |얼굴  |      |  |
|12 |얼굴  |지문  |  |
|13 |얼굴  |PIN   |  |
|14 |얼굴  |지문 또는 PIN  |  |
|15 |얼굴  |지문  |PIN  |
|254 |사용할 수 없음  |  |  |
|255 |정의되지 않음(시스템 정의 모드)  |  |  |
</WRAP>
2. //fingerprintAuthMode// \\ 
사용자 인증을 위한 지문 인증 설정 모드입니다. \\ 
<WRAP group 60%>
^값  ^1단계 인증  ^2단계 인증  ^3단계 인증  ^4단계 인증  ^
|16 |지문  |      |  |
|17 |지문  |얼굴  |  |
|18 |지문  |PIN   |  |
|19 |지문  |얼굴 또는 PIN  |  |
|20 |지문  |얼굴  |PIN  |
|254 |사용할 수 없음  |  |  |
|255 |정의되지 않음(시스템 정의 모드)  |  |  |
</WRAP>
3. //cardAuthMode// \\ 
사용자 인증을 위한 카드 인증 설정 모드입니다. \\ 
<WRAP group 60%>
^값  ^1단계 인증  ^2단계 인증  ^3단계 인증  ^
|21  |카드  |      |   |
|22  |카드  |얼굴  |   |
|23  |카드  |지문  |   |
|24  |카드  |PIN  |   |
|25  |카드  |얼굴 또는 지문  |   |
|26  |카드  |얼굴 또는 PIN  |   |
|27  |카드  |지문 또는 PIN  |   |
|28  |카드  |얼굴 또는 지문 또는 PIN  |   |
|29  |카드  |얼굴  |지문  |
|30  |카드  |얼굴  |PIN  |
|31  |카드  |지문  |얼굴  |
|32  |카드  |지문  |PIN  |
|33  |카드  |얼굴 또는 지문  |PIN  |
|34  |카드  |얼굴  |지문 또는 PIN  |
|35  |카드  |지문  |얼굴 또는 PIN  |
|254 |사용할 수 없음  |  |  |
|255 |정의되지 않음(시스템 정의 모드)  |  |  |
</WRAP>
4. //idAuthMode// \\ 
사용자 인증을 위한 ID 인증 설정 모드입니다. \\ 
<WRAP group 60%>
^값  ^1단계 인증  ^2단계 인증  ^3단계 인증  ^
|36  |ID  |얼굴  |   |
|37  |ID  |지문  |   |
|38  |ID  |PIN  |   |
|39  |ID  |얼굴 또는 지문  |   |
|40  |ID  |얼굴 또는 PIN  |   |
|41  |ID  |지문 또는 PIN  |   |
|42  |ID  |얼굴 또는 지문 또는 PIN  |   |
|43  |ID  |얼굴  |지문  |
|44  |ID  |얼굴  |PIN  |
|45  |ID  |지문  |얼굴  |
|46  |ID  |지문  |PIN  |
|47  |ID  |얼굴 또는 지문  |PIN  |
|48  |ID  |얼굴  |지문 또는 PIN  |
|49  |ID  |지문  |얼굴 또는 PIN  |
|254 |사용할 수 없음  |  |  |
|255 |정의되지 않음(시스템 정의 모드)  |  |  |
</WRAP>
5. //reserved// \\ 
예약된 공간입니다. \\ \\ 


==== BS2UserFaceExBlob ====
<code cpp>
typedef struct
{
    BS2User user;
    BS2UserSetting setting;
    BS2_USER_NAME user_name;
    BS2UserPhoto* user_photo_obj;
    BS2_USER_PIN pin;
    BS2CSNCard* cardObjs;
    BS2Fingerprint* fingerObjs;
    BS2Face* faceObjs;                  // FS2, FL
    BS2Job job;
    BS2_USER_PHRASE phrase;
    BS2_ACCESS_GROUP_ID accessGroupId[BS2_MAX_NUM_OF_ACCESS_GROUP_PER_USER];

    BS2UserSettingEx settingEx;         // F2
    BS2FaceEx* faceExObjs;              // F2
} BS2UserFaceExBlob;
</code>
1. //user// \\ 
사용자의 기본 정보를 정의한 구조체입니다. \\ \\ 
2. //setting// \\ 
사용자 식별을 위한 설정값을 정의한 구조체입니다. \\ \\ 
3. //name// \\ 
사용자 이름이며 문자열 인코딩은 UTF-8입니다. \\ \\ 
4. //photo// \\ 
사용자 프로파일 이미지이며 Jpeg 이미지만 지원합니다. \\ \\ 
5. //pin// \\ 
PIN 값이며 반드시 //BS_MakePinCode// 함수를 통해 암호화된 문자열을 입력해야 합니다. \\ \\ 
6. //cardObjs// \\ 
사용자 인증을 위한 카드 리스트로 반드시 **user.numCards**만큼 존재해야 합니다. 데이터 형식은 [[Smartcard API]]를 참고하십시오. \\ \\ 
7. //fingerObjs// \\ 
사용자 인증을 위한 지문 템플릿 리스트로 반드시 **user.numFingers**만큼 존재해야 합니다. 데이터 형식은 [[Fingerprint API]]를 참고하십시오. \\ \\ 
8. //faceObjs// \\ 
''IR Face 지원 장치'' 사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 **user.numFaces**만큼 존재해야 합니다. 데이터 형식은 [[Face API]]를 참고하십시오. \\ \\ 
9. //job// \\ 
근태모드에서 사용자의 작업코드입니다. \\ \\ 
10. //phrase// \\ 
인증시 장치 UI에서 표시되는 개인 메시지입니다. \\
<WRAP group 30%>
^지원 모델  ^지원 버전  ^
|FaceStation 2  |V1.0.0 이상  |
|FaceStation F2  |V1.0.0 이상  |
|X-Station 2  |V1.0.0 이상  |
</WRAP>
11. //accessGroupId// \\ 
사용자가 속한 출입 그룹을 나열한 리스트로 최대 16개까지 설정할 수 있습니다. \\ \\ 
12. //settingEx// \\ 
''Visual Face 지원 장치'' 개인인증모드를 설정할 수 있습니다. 지문과 얼굴을 함께 조합한 더 다양한 인증모드의 조합이 가능하게 되었습니다. \\ \\ 
13. //faceExObjs// \\ 
''Visual Face 지원 장치'' 사용자 인증을 위한 얼굴 템플릿 리스트로 반드시 **user.numFaces**만큼 존재해야 합니다. 데이터 형식은 [[Face API]]를 참고하십시오. \\ \\

==== BS2UserStatistic ====
<code cpp>
typedef struct {
    uint32_t numUsers;
    uint32_t numCards;
    uint32_t numFingerprints;
    uint32_t numFaces;
    uint32_t numNames;
    uint32_t numImages;
    uint32_t numPhrases;
} BS2UserStatistic;
</code>

1. //numUsers// \\ 
등록된 사용자 수입니다. \\ \\ 
2. //numCards// \\ 
등록된 카드의 개수입니다. \\ \\ 
3. //numFingerprints// \\ 
등록된 지문의 개수입니다. \\ \\
4. //numFaces// \\ 
등록된 얼굴의 개수입니다. \\ \\ 
5. //numNames// \\ 
등록된 사용자명의 개수입니다. \\ \\ 
6. //numImages// \\ 
등록된 이미지 개수입니다. \\ \\
7. //numPhrases// \\ 
등록된 개인메시지 개수입니다. \\ \\ 

==== BS2UserOverride ====
<code cpp>
typedef struct{
    BS2_USER_ID userID;				///< 32 bytes
    BS2_BOOL useExtendedAutoLockTimeout;	///<  1 byte
    uint8_t reserved[11];			///< 11 bytes
} BS2UserOverride;
</code>

1. //userID// \\ 
사용자의 ID입니다. \\ \\ 
2. //useExtendedAutoLockTimeout// \\ 
사용자가 연장된 출입문 개방 시간 기능(user override)을 사용할지 여부를 나타냅니다. \\ \\
3. //reserved// \\ 
예약된 공간입니다.\\ \\