# PKCS#11 (Cryptographic Token Interface Standard)

## 1. 개요
**PKCS#11**은 암호화 토큰(Cryptographic Token)과 애플리케이션 사이의 상호작용을 정의하는 플랫폼 독립적인 표준 API 인터페이스입니다. 

이 표준의 주된 목적은 하드웨어 독립적인 암호화 인터페이스를 제공함으로써, 개발자가 특정 벤더의 하드웨어(HSM, 스마트카드 등)에 종속되지 않고 동일한 API를 통해 암호화 기능을 사용할 수 있도록 하는 것입니다. PKCS#11은 공식적으로 **Cryptoki**(Cryptographic Token Interface의 약칭)라고 불리며, OASIS(Organization for the Advancement of Structured Information Standards)에서 표준화 작업을 관리하고 있습니다.

## 2. 동작 원리 및 아키텍처
PKCS#11은 애플리케이션과 실제 암호화 하드웨어 사이에서 추상화 계층을 제공하는 계층 구조를 가집니다. 애플리케이션은 하드웨어의 물리적 특성을 알 필요 없이, 벤더가 제공하는 PKCS#11 라이브러리(미들웨어)를 통해 표준 함수를 호출합니다.

### 구성 요소별 역할 비교
| 구성 요소 | 역할 | 설명 |
| :--- | :--- | :--- |
| **Application** | 서비스 요청자 | 암호화, 서명, 키 생성 등의 기능을 요청하는 상위 소프트웨어 |
| **PKCS#11 Library** | 미들웨어 (Middleware) | 표준 API 호출을 특정 하드웨어의 명령어로 변환하는 벤더 제공 드라이버 |
| **Cryptographic Token** | 실제 실행 모듈 | 키 저장 및 암호 연산이 실제로 수행되는 물리적/논리적 장치 (HSM, Smart Card 등) |

## 3. 핵심 개념 및 주요 기능
PKCS#11은 하드웨어를 관리하기 위해 슬롯, 토큰, 세션, 객체라는 네 가지 핵심 개념을 사용합니다.

### 3.1 슬롯(Slot)과 토큰(Token)
- **슬롯(Slot)**: 토큰이 삽입될 수 있는 물리적 또는 논리적인 인터페이스(예: 스마트카드 리더기)를 의미합니다.
- **토큰(Token)**: 슬롯에 삽입되어 실제 암호화 기능을 수행하는 장치입니다. 하나의 슬롯에는 하나의 토큰이 존재할 수 있습니다. 토큰은 물리적 장치뿐만 아니라 소프트웨어적으로 구현된 논리적 암호화 모듈(Soft-token)이나 가상 HSM일 수도 있습니다.

### 3.2 세션(Session) 관리
애플리케이션은 토큰과 통신하기 위해 **세션(Session)**을 생성해야 합니다. 세션은 토큰에 대한 접근 권한을 관리하며, 읽기 전용(Read-Only) 또는 읽기-쓰기(Read-Write) 모드로 설정할 수 있습니다.

### 3.3 객체(Object) 기반 데이터 관리
PKCS#11 내의 모든 데이터(키, 인증서 등)는 **객체(Object)**로 취급됩니다. 각 객체는 속성(Attribute)의 집합으로 정의되며, 보안을 위해 객체 내부의 실제 키 값은 외부로 유출되지 않고 토큰 내부에서만 연산되는 특성을 가집니다.

**주요 객체 타입 구분**
| 객체 타입 | 설명 | 주요 속성 |
| :--- | :--- | :--- |
| **Private Key** | 비대칭 암호화의 개인키 | `CKA_PRIVATE`, `CKA_SENSITIVE` (외부 유출 불가) |
| **Public Key** | 비대칭 암호화의 공개키 | `CKA_PUBLIC`, `CKA_ENCRYPT` |
| **Certificate** | 공개키 인증서 (X.509 등) | `CKA_VALUE` (인증서 데이터) |
| **Secret Key** | 대칭 암호화 키 (AES 등) | `CKA_VALUE`, `CKA_ENCRYPT` |

## 4. 주요 API 함수 및 워크플로우
PKCS#11 API는 `C_`로 시작하는 함수 명명 규칙을 따릅니다.

### 4.1 핵심 함수군 및 메커니즘
- **메커니즘(Mechanism)**: PKCS#11에서는 `CK_MECHANISM` 구조체를 사용하여 사용할 암호화 알고리즘(예: AES-CBC, RSA-PKCS)과 관련 파라미터를 지정합니다. 모든 암호 연산 함수는 이 메커니즘을 인자로 받아 동작합니다.
- **초기화 및 세션**: `C_Initialize` (라이브러리 초기화), `C_OpenSession` (세션 생성), `C_CloseSession` (세션 종료)
- **인증**: `C_Login` (사용자/관리자 인증), `C_Logout` (인증 해제)
- **객체 관리**: `C_CreateObject` (객체 생성), `C_FindObjects` (객체 검색), `C_DestroyObject` (객체 삭제)
- **암호 연산**: `C_EncryptInit`/`C_Encrypt` (암호화), `C_DecryptInit`/`C_Decrypt` (복호화), `C_SignInit`/`C_Sign` (서명), `C_VerifyInit`/`C_Verify` (검증)

### 4.2 일반적인 호출 시퀀스 (C 언어 예시)
```c
/* PKCS#11 기본 접속 및 로그인 워크플로우 */
CK_RV rv;
CK_SESSION_HANDLE hSession;

// 1. 라이브러리 초기화 (NULL_PTR은 NULL과 동일한 의미의 PKCS#11 매크로)
rv = C_Initialize(NULL_PTR);

// 2. 슬롯에서 세션 열기 (Slot ID 0번 사용)
rv = C_OpenSession(0, CKF_SERIAL_SESSION | CKF_RW_SESSION, NULL_PTR, NULL_PTR, &hSession);

// 3. 사용자 PIN을 이용한 로그인
CK_UTF8CHAR pin[] = "1234";
rv = C_Login(hSession, CKU_USER, pin, strlen((char*)pin));

// ... 암호화/서명 연산 수행 ...

// 4. 로그아웃 및 세션 종료
C_Logout(hSession);
C_CloseSession(hSession);

// 5. 라이브러리 자원 해제 (C_Initialize와 짝을 이루는 종료 함수)
C_Finalize(NULL_PTR);
```

## 5. 활용 사례 및 지원 하드웨어
PKCS#11은 키의 안전한 보관과 하드웨어 가속이 필요한 다양한 환경에서 표준으로 사용됩니다.

- **HSM (Hardware Security Module)**: 기업용 루트 CA(인증기관)의 마스터 키 보관 및 고속 서명 처리.
- **스마트카드 및 USB 토큰**: 개인 인증서 저장 및 전자 서명(공인인증서 등).
- **클라우드 KMS (Key Management Service)**: AWS CloudHSM, Azure Dedicated HSM 등 클라우드 환경의 하드웨어 키 관리 서비스를 통해 물리적 HSM을 가상화하여 제공.
- **웹 서버 (Apache, Nginx)**: SSL/TLS 인증서의 개인키를 HSM에 저장하고 PKCS#11 모듈을 통해 핸드셰이크 수행.

## 6. PKCS#11 vs PKCS#12 비교
두 표준 모두 암호화와 관련되어 있으나, 그 목적과 성격이 완전히 다릅니다.

| 구분 | PKCS#11 | PKCS#12 |
| :--- | :--- | :--- |
| **정의** | 암호화 장치 인터페이스 **API 표준** | 암호화 정보 저장 **파일 포맷 표준** |
| **형태** | 라이브러리/함수 집합 (DLL, SO 파일) | 단일 파일 (`.p12`, `.pfx`) |
| **목적** | 하드웨어 토큰과의 통신 및 연산 수행 | 키와 인증서의 안전한 전송 및 백업 |
| **키 저장** | 토큰 내부 (외부 유출 불가 설정 가능) | 파일 내부 (암호화되어 저장됨) |
| **동작 방식** | API 호출 $\rightarrow$ 하드웨어 연산 | 파일 로드 $\rightarrow$ 메모리 상의 키 복구 |

## 7. 최신 버전의 주요 변경 사항
최근의 PKCS#11 표준(v3.0 이상)은 현대적인 암호화 요구사항을 반영하여 다음과 같은 변경 사항을 포함하고 있습니다.

- **타원곡선 암호화(ECC) 강화**: EdDSA(Edwards-curve Digital Signature Algorithm) 및 최신 곡선 지원 확대.
- **양자 내성 암호(PQC) 준비**: 양자 컴퓨터 공격에 대비한 새로운 알고리즘들을 수용할 수 있는 유연한 객체 구조 도입.
- **메커니즘 확장**: 더 정교한 키 파생 함수(KDF) 및 인증된 암호화(AEAD) 모드 지원 강화.

## 8. 언어별 래퍼(Wrapper) 라이브러리
PKCS#11은 기본적으로 C 언어 기반의 API를 제공하므로, 다른 언어에서 사용하기 위해 래퍼 라이브러리를 활용합니다.

- **Python**: `PyKCS11` (C API를 파이썬 객체로 래핑하여 제공)
- **Java**: `SunPKCS11` (JDK에 내장된 Provider로, `java.security` 패키지를 통해 접근)
- **Go**: `pkcs11` (CGO를 이용하여 PKCS#11 공유 라이브러리와 바인딩)
- **C# / .NET**: `Pkcs11Interop` (P/Invoke를 통해 벤더 라이브러리 호출)

## 9. 장단점 및 한계

### 장점
- **벤더 독립성**: 표준 API를 구현했다면 하드웨어 교체 시 애플리케이션 코드 수정이 최소화됩니다.
- **높은 보안성**: 키가 하드웨어 외부로 노출되지 않는 'Non-exportable' 속성을 강제할 수 있습니다.
- **범용성**: 거의 모든 상용 HSM과 스마트카드 벤더가 지원하는 업계 표준입니다.

### 단점 및 한계
- **API 복잡성**: 함수 호출 순서가 엄격하고, 에러 코드(`CKR_...`)가 매우 다양하여 구현 난이도가 높습니다. 모든 API 함수는 `CK_RV` (Return Value) 타입을 반환하며, 개발자는 반드시 이 값을 확인하여 성공(`CKR_OK`) 여부를 체크해야 합니다.
- **업데이트 속도**: 하드웨어 표준 특성상 최신 암호화 알고리즘이 표준 API에 공식 반영되기까지 시간이 오래 걸립니다.
- **성능 오버헤드**: 추상화 계층을 거치므로, 매우 단순한 연산의 경우 직접 드라이버를 호출하는 것보다 느릴 수 있습니다.