차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
| 양쪽 이전 판 이전 판 다음 판 | 이전 판 | ||
|
ko:sdk_api [2018/03/20 15:51] kkshin [BS2CredentialKeyInfo] |
ko:sdk_api [2024/02/27 14:59] (현재) |
||
|---|---|---|---|
| 줄 9: | 줄 9: | ||
| * [[BS2_ReleaseObject]]: 동적 메모리를 해제합니다. | * [[BS2_ReleaseObject]]: 동적 메모리를 해제합니다. | ||
| * [[BS2_MakePinCode]]: PIN으로 암호화 합니다. | * [[BS2_MakePinCode]]: PIN으로 암호화 합니다. | ||
| + | * [[BS2_MakePinCodeWithKey]]: 사용자 정의 PIN 암호화 키를 이용하여 암호화 합니다. [+ 2.7.1] | ||
| * [[BS2_SetMaxThreadCount]]: 최대 스레드 개수를 지정합니다. | * [[BS2_SetMaxThreadCount]]: 최대 스레드 개수를 지정합니다. | ||
| * [[BS2_ComputeCRC16CCITT]]: CRC-16 CCITT 체크섬을 계산합니다. | * [[BS2_ComputeCRC16CCITT]]: CRC-16 CCITT 체크섬을 계산합니다. | ||
| * [[BS2_GetCardModel]]: 지원하는 카드 모델을 가져옵니다. | * [[BS2_GetCardModel]]: 지원하는 카드 모델을 가져옵니다. | ||
| - | * [[BS2_GetCredentialKeyInfo]]: 장치의 암호화 키를 가져옵니다. | + | * [[BS2_SetDataEncryptKey]]: 사용자의 PIN 코드 암호화 키 값을 변경 합니다. [+ 2.7.1] |
| - | * [[BS2_SetCredentialKeyInfo]]: 장치의 암호화 키를 설정합니다. | + | * [[BS2_RemoveDataEncryptKey]]: 장치의 데이터 암호화 키를 삭제합니다. |
| - | * [[BS2_RemoveCredentialKeyInfo]]: 장치의 암호화 키를 삭제합니다. | + | * [[BS2_SetDeviceSearchingTimeout]]: 장치 검색 시간을 설정합니다. |
| + | * [[BS2_SetDebugFileLog]]: 디버깅용 파일로그를 지정합니다. | ||
| + | * [[BS2_SetDebugFileLogEx]]: 디버깅용 파일로그를 지정합니다. (파일 분할 가능) [+ 2.8.3] | ||
| + | * [[BS2_EnableDeviceLicense]]: [+ 2.9.1] 장치 라이선스를 활성화 시킵니다. | ||
| + | * [[BS2_DisableDeviceLicense]]: [+ 2.9.1] 장치 라이선스를 비활성화 시킵니다. | ||
| + | * [[BS2_QueryDeviceLicense]]: [+ 2.9.1] 장치 라이선스 정보를 확인합니다. | ||
| + | * [[BS2_InitializeEx]]: [+ 2.9.6] 장치 관리 Context를 초기화 합니다. | ||
| ===== 구조체 ===== | ===== 구조체 ===== | ||
| - | ==== BS2CredentialKeyInfo ==== | + | ==== BS2EncryptKey ==== |
| <code cpp> | <code cpp> | ||
| - | /** | ||
| - | * BS2_CRED_KEY_REQ | ||
| - | */ | ||
| enum | enum | ||
| { | { | ||
| - | BS2_CRED_KEY_REQ_COMM = false, | + | BS2_ENC_KEY_SIZE = 32, |
| - | BS2_CRED_KEY_REQ_DATA = true, | + | |
| }; | }; | ||
| - | enum | ||
| - | { | ||
| - | BS2_CRED_KEY_SIZE = 32, | ||
| - | }; | ||
| - | |||
| - | /** | ||
| - | * BS2CredentialKeyInfo | ||
| - | */ | ||
| typedef struct | typedef struct | ||
| { | { | ||
| - | uint32_t maxPacketSize; ///< 4 bytes | + | uint8_t key[BS2_ENC_KEY_SIZE]; |
| - | uint8_t key[BS2_CRED_KEY_SIZE]; ///< 32 bytes | + | uint8_t reserved[32]; |
| - | bool dualIDSupported; ///< 1 byte | + | } BS2EncryptKey; |
| - | bool useAlphanumericID; ///< 1 byte | + | |
| - | bool credentialKeySupported; ///< 1 byte | + | |
| - | bool credentialKeyRequest; ///< 1 byte | + | |
| - | uint8_t reserved[28]; ///< 28 bytes (reserved) | + | |
| - | } BS2CredentialKeyInfo; | + | |
| </code> | </code> | ||
| - | 1. //maxPacketSize// \\ | + | 1. //key// \\ |
| - | 장치가 허용하는 최대 TCP 패킷 사이즈입니다. \\ | + | |
| - | + | ||
| - | 2. //key// \\ | + | |
| 장치에서 사용되는 키 값입니다. \\ | 장치에서 사용되는 키 값입니다. \\ | ||
| - | credentialKeyRequest 설정에 따라 통신 암호화키, 또는 데이터 암호화키를 반환 받을 수 있습니다.\\ | ||
| - | 3. //dualIDSupported// \\ | + | 2. //reserved// \\ |
| - | 장치의 userID 형식(숫자, 문자)을 변경허용하는지 여부를 나타냅니다. \\ | + | 예약된 영역입니다. \\ \\ |
| - | 4. //useAlphanumericID// \\ | ||
| - | 장치에서 alphanumeric userID를 사용하지는에 관한 flag입니다. \\ | ||
| - | 5. //credentialKeySupported// \\ | + | ==== BS2LicenseBlob ==== |
| - | 데이터 키 변경을 허용하는지 여부를 나타냅니다. \\ | + | <code cpp> |
| - | 장치 별 FW의 release 날짜가 2018.03.30 일 이후부터는, 장치에서 사용하는 데이터 암호화 키의 변경할 수 있도록 지원하는데,\\ | + | typedef struct { |
| - | 현재 연결된 장치가 이러한 키의 변경을 지원하는지 나타냅니다.\\ | + | BS2_LICENSE_TYPE licenseType; |
| - | + | uint16_t numOfDevices; | |
| - | 6. //credentialKeyRequest// \\ | + | BS2_DEVICE_ID* deviceIDObjs; |
| - | 이 설정을 이용하여 장치의 키를 요청할 수 있습니다.\\ | + | uint32_t licenseLen; |
| - | 이 설정은 각 장치 별 FW의 release 날짜가 2018.03.30 일 이후의 경우에 한하며,\\ | + | uint8_t* licenseObj; |
| - | 이전 FW의 경우 이곳의 설정 여부와 관계없이 통신 키만 반환 됩니다. | + | } BS2LicenseBlob; |
| + | </code> | ||
| + | 1. //licenseType// \\ | ||
| + | 라이선스의 종류를 나타냅니다. \\ | ||
| <WRAP group 50%> | <WRAP group 50%> | ||
| ^값 ^설명 ^ | ^값 ^설명 ^ | ||
| - | |BS2_CRED_KEY_REQ_COMM |통신 암호화 키 요청 | | + | |0x0000 |None | |
| - | |BS2_CRED_KEY_REQ_DATA |데이터 암호화 키 요청 | | + | |0x0001 |Visual QR | |
| </WRAP> | </WRAP> | ||
| + | 2. //numOfDevices// \\ | ||
| + | 라이선스 활성화 장치의 갯수입니다. \\ \\ | ||
| + | 3. //deviceIDObjs// \\ | ||
| + | 라이선스 정보가 내려질 slave 장치들입니다. \\ \\ | ||
| + | 4. //licenseLen// \\ | ||
| + | 라이선스 활성화 파일의 크기입니다. \\ \\ | ||
| + | 5. //licenseObj// \\ | ||
| + | 라이선스 활성화 데이터 블록입니다. \\ \\ | ||
| - | 7. //reserved// \\ | + | |
| - | 예약된 영역입니다. \\ | + | ==== BS2LicenseResult ==== |
| + | <code cpp> | ||
| + | typedef struct { | ||
| + | BS2_DEVICE_ID deviceID; | ||
| + | BS2_LICENSE_STATUS status; | ||
| + | } BS2LicenseResult; | ||
| + | </code> | ||
| + | 1. //deviceID// \\ | ||
| + | 장치 식별자입니다. \\ \\ | ||
| + | 2. //status// \\ | ||
| + | 라이선스 상태 정보입니다. \\ \\ | ||
| + | <WRAP group 50%> | ||
| + | ^값 ^설명 ^ | ||
| + | |0 |Not supported (지원 안함) | | ||
| + | |1 |Disable (꺼짐) | | ||
| + | |2 |Enable (켜짐) | | ||
| + | |3 |Expired (만료됨) | | ||
| + | </WRAP> | ||