차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
ko:user_management_api [2022/04/11 11:17] 127.0.0.1 바깥 편집 |
ko:user_management_api [2022/08/25 10:33] kkshin [User Management API] |
||
---|---|---|---|
줄 22: | 줄 22: | ||
* [[BS2_GetUserSmallDatas]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 사용자 정보의 일부를 선별적으로 가져옵니다. | * [[BS2_GetUserSmallDatas]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 사용자 정보의 일부를 선별적으로 가져옵니다. | ||
* [[BS2_GetUserSmallDatasEx]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 사용자 정보의 일부를 선별적으로 가져옵니다. | * [[BS2_GetUserSmallDatasEx]]: [+ 2.6.3] 효율적으로 메모리를 사용하여, 사용자 정보의 일부를 선별적으로 가져옵니다. | ||
- | * [[BS2_EnrollUserFaceEx]]: [+ 2.7.1] ''FaceStation F2''새로운 사용자를 등록합니다. | + | * [[BS2_EnrollUserFaceEx]]: [+ 2.7.1] ''FSF2, BS3''새로운 사용자를 등록합니다. |
- | * [[BS2_GetUserInfosFaceEx]]: [+ 2.7.1] ''FaceStation F2''주어진 사용자 ID의 정보를 가져옵니다. | + | * [[BS2_GetUserInfosFaceEx]]: [+ 2.7.1] ''FSF2, BS3''주어진 사용자 ID의 정보를 가져옵니다. |
- | * [[BS2_GetUserDatasFaceEx]]: [+ 2.7.1] ''FaceStation F2''사용자 정보의 일부를 선별적으로 가져옵니다. | + | * [[BS2_GetUserDatasFaceEx]]: [+ 2.7.1] ''FSF2, BS3''사용자 정보의 일부를 선별적으로 가져옵니다. |
+ | * [[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] ''FSF2, BS3''사용자를 정보를 부분적으로 갱신합니다. | ||
===== 구조체 ===== | ===== 구조체 ===== | ||
줄 37: | 줄 42: | ||
uint8_t numFingers; | uint8_t numFingers; | ||
uint8_t numFaces; | uint8_t numFaces; | ||
- | uint8_t reserved2[1]; | + | uint8_t infoMask; |
uint32_t authGroupID; | uint32_t authGroupID; | ||
uint32_t faceChecksum; | uint32_t faceChecksum; | ||
줄 65: | 줄 70: | ||
7. //numFaces// \\ | 7. //numFaces// \\ | ||
사용자에게 맵핑된 얼굴 개수입니다. \\ \\ | 사용자에게 맵핑된 얼굴 개수입니다. \\ \\ | ||
- | 8. //authGroupID// \\ | + | 8. //infoMask// \\ |
+ | **''사용자 정보의 취득''** \\ | ||
+ | 사용자 정보 취득 시, infoMask는 현재 사용자에 어떤 정보들이 할당되어 있는지를 나타냅니다. \\ \\ | ||
+ | **''사용자 정보의 갱신''** \\ | ||
+ | infoMask에 변경하고자 하는 mask를 지정하여 선별적으로 갱신이 가능합니다. \\ \\ | ||
+ | **''Credential(카드/지문/얼굴) 정보의 갱신''** \\ | ||
+ | BS2User의 numCards, numFingers, numFaces가 0인지, fingerObjs, cardObjs, faceObjs, faceExObjs가 NULL여부 등, 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의 mask를 켜주면, 장치는 기존에 가지고 있는 credential 정보들을 유지합니다. \\ \\ | ||
+ | **''Credential(카드/지문/얼굴) 정보의 삭제''** \\ | ||
+ | 카드/지문/얼굴 각각의 credential 정보를 0으로 하고, infoMask를 unmasking 하면, 장치는 각각 credential에 해당되는 정보를 삭제합니다. \\ | ||
+ | <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> | ||
+ | 9. //authGroupID// \\ | ||
얼굴 그룹 매칭을 사용할시 사용자에게 할당 할 그룹의 ID. \\ \\ | 얼굴 그룹 매칭을 사용할시 사용자에게 할당 할 그룹의 ID. \\ \\ | ||
- | 9. //faceChecksum// \\ | + | 10. //faceChecksum// \\ |
사용되지 않음. \\ | 사용되지 않음. \\ | ||