PKCS#11 Header 파일 적용 하기

PKCS#11 표준 라이브러리인 Cryptoki 라이브러리를 사용하는 기능을 개발 하기 위해서는
OASIS 에서 제공하는 헤더 파일을 사용해야 한다.
PKCS#11은 모든 정의 값이 표준화 되어 있기 때문에 이에 대한 정의를 OASIS에서 만들어서 제공 하기 때문이다.

그럼 제공 하는 Header 파일은 다음 3가지 이다.
여기서는 현재 가장 많이 사용되고 있다고 생각 되는 PKCS#11 버전 2.4 를 기준으로 설명한다.
아래 주소로 가면 관련 내용을 참조 할 수 있다.

http://docs.oasis-open.org/pkcs11/pkcs11-base/v2.40/pkcs11-base-v2.40.html

PKCS #11 Cryptographic Token Interface Base Specification Version 2.40

적용해야 할 3가지 파일은 아래 3가지 파일이다.

pkcs11.h
pkcs11t.h
pcks11f.h

이 파일들을 받아서 사용 한다. 하지만 pkcs11.h 파일을 개발 환경에 맞게 맞추어 주어야 한다.
크게 맞추어 주는 부분은 Windows 와 다른 OS 두가지로 처리를 해주면 어디에서든 사용 가능 한다.
사실 pkcs11.h 파일에 주석을 읽어 보면 자세한 설명이 있다.

그럼 pkcs11.h 에 추가 해 주는 부분은 헤더 앞과 끝 부분에 아래 코드를 적용 하여 사용 하면 된다.

/* 헤더 앞 부분 적용 */
#if defined(_WIN32) || defined(CRYPTOKI_FORCE_WIN32)

/* There is a matching pop below.  */
#pragma pack(push, cryptoki, 1)

#define CK_PTR *

#define CK_DEFINE_FUNCTION(returnType, name) \
   returnType __declspec(dllexport) name

#define CK_DECLARE_FUNCTION(returnType, name) \
   returnType __declspec(dllimport) name

#define CK_DECLARE_FUNCTION_POINTER(returnType, name) \
   returnType __declspec(dllimport) (* name)

#define CK_CALLBACK_FUNCTION(returnType, name) \
   returnType (* name)

#else

#define CK_PTR *

#define CK_DEFINE_FUNCTION(returnType, name) \
   returnType name

#define CK_DECLARE_FUNCTION(returnType, name) \
   returnType name

#define CK_DECLARE_FUNCTION_POINTER(returnType, name) \
   returnType (* name)

#define CK_CALLBACK_FUNCTION(returnType, name) \
   returnType (* name)

#endif

#ifndef NULL_PTR
#define NULL_PTR 0
#endif



/* 헤더 뒤 부분 적용 */

/* System dependencies.  */
#if defined(_WIN32) || defined(CRYPTOKI_FORCE_WIN32)
#pragma pack(pop, cryptoki)
#endif

이렇게 적용을 하게 되면 사실 바로 cryptoki 라이브러리 개발을 하면 된다.
그외 다른 부분은 손대지 않아도 된다.
실제 사용시에는 pkcs11.h 헤더 파일을 인클루드 해서 사용 하면 된다.

하지만 IDE 툴 에서 pcks11f.h pkcs11t.h 헤더를 열어 보변 문법 오류 처러 표시 되기도 하는데
(내경우 Qt Creator에서는 그렇게 나온다. 다른 IDE 툴은 확인이 필요하다)
이건 아마도 DEFINE 값에 대한 IDE에서 인식이 잘 안되어서이지 사용에는 문제가 없다.

참고로 내가 적용한 pkcs11.h 파일을 첨부 하였다.

pkcs11.h

9.7 kB