차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

양쪽 이전 판 이전 판
다음 판 		이전 판
ko:user_management_api [2022/08/25 10:59]
kkshin [BS2UserSetting] 		ko:user_management_api [2023/02/03 09:19] (현재)
줄 72: 줄 72:
 사용자에게 맵핑된 얼굴 개수입니다. \\ \\  사용자에게 맵핑된 얼굴 개수입니다. \\ \\ 
 8. //​infoMask//​ \\ 8. //​infoMask//​ \\
-**''​사용자 ​정보의 취득''​** \\ +[+ 2.8.3] ​사용자가 어떤 정보를 가지고 ​있는지 나타내며, 이 infoMask를 변경하여, 변경할 ​정보와 함께 장치로 내려주면 해당 사용자 ​정보의 부분 변경이 ​가능합니다. \\ 
-사용자 정보 취득 시, infoMask는 현재 사용자에 ​어떤 정보들이 할당되어 ​있는지를 나타냅니다. \\ \\ +이때, Partial update 함수군들 ([[BS2_PartialUpdateUser]], [[BS2_PartialUpdateUserEx]], [[BS2_PartialUpdateUserSmall]], [[BS2_PartialUpdateUserSmallEx]], [[BS2_PartialUpdateUserFaceEx]])의 user mask 인자와의 조합이 필요합니다. (하단 표 참조) \\ 
-**''​사용자 정보의 갱신''​** \\ +
-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%> <WRAP group 50%>
 ^값  ^설명 ​ ^ ^값  ^설명 ​ ^
줄 96: 줄 86:
 |0x80  |BS2_USER_INFO_MASK_FACE ​ | |0x80  |BS2_USER_INFO_MASK_FACE ​ |
 </​WRAP>​ </​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//​ \\  9. //​authGroupID//​ \\ 
 얼굴 그룹 매칭을 사용할시 사용자에게 할당 할 그룹의 ID. \\ \\  얼굴 그룹 매칭을 사용할시 사용자에게 할당 할 그룹의 ID. \\ \\ 
줄 106: 줄 119:
 <WRAP tip 70%> <WRAP tip 70%>
 **도움말**\\ **도움말**\\
-<wrap em>​FaceStation F2, BioStation 3 이외</​wrap> ​\\ +<wrap em>​FaceStation F2, BioStation 3</​wrap>​의 <wrap em>개인인증 모드</​wrap> ​설정은 ​[[user management api#​BS2UserSettingEx|BS2UserSettingEx]]를 사용해 주십시오.
-<wrap em>FaceStation F2, BioStation 3</​wrap>​는 [[user management api#​BS2UserSettingEx|BS2UserSettingEx]]를 사용해 주십시오.+
 </​WRAP>​ </​WRAP>​
 <code cpp> <code cpp>
줄 355: 줄 367:
 |FaceStation F2  |V1.0.0 이상 ​ | |FaceStation F2  |V1.0.0 이상 ​ |
 |X-Station 2  |V1.0.0 이상 ​ | |X-Station 2  |V1.0.0 이상 ​ |
 +|BioStation 3  |V1.0.0 이상 ​ |
 </​WRAP>​ </​WRAP>​
 11. //​accessGroupId//​ \\  11. //​accessGroupId//​ \\ 
줄 363: 줄 376:
 <WRAP tip 70%> <WRAP tip 70%>
 **도움말**\\ **도움말**\\
-<wrap em>​FaceStation F2 만</​wrap> ​ \\ +<wrap em>​FaceStation F2, BioStation 3 이외</​wrap>​의 장치에 대한 ​<wrap em>개인인증 모드</​wrap> ​설정은 ​[[user management api#​BS2UserSetting|BS2UserSetting]]를 사용해 주십시오.
-FaceStation F2 <wrap em>이외의 장치</​wrap>​는 [[user management api#​BS2UserSetting|BS2UserSetting]]를 사용해 주십시오.+
 </​WRAP>​ </​WRAP>​
 <code cpp> <code cpp>
줄 375: 줄 387:
 } BS2UserSettingEx;​ } BS2UserSettingEx;​
 </​code>​ </​code>​
-''​FaceStation F2'' ​ \\ \\ 
 1. //​faceAuthMode//​ \\  1. //​faceAuthMode//​ \\ 
 사용자 인증을 위한 얼굴 인증 설정 모드입니다. \\ 사용자 인증을 위한 얼굴 인증 설정 모드입니다. \\