PKCS #12: 인증서와 개인 키를 옮기는 .p12/.pfx

이 글의 목차
  1. 인증서 파일과 신원 묶음의 차이
  2. 무엇이 들어갈까
  3. 최상위 PFX 구조
  4. SafeBag 종류
  5. 암호화와 무결성은 다르다
  6. 패스워드 처리 주의
  7. OpenSSL로 내용 확인하기
  8. 가져올 때 검증할 항목
  9. 관련 RFC

인증서 파일과 신원 묶음의 차이

인증서는 공개 키와 주체 정보를 담고, 개인 키는 소유자만 보관해야 하는 비밀이다. PKCS #12는 이 둘과 중간 인증서를 한 파일로 이동할 때 자주 사용한다.

파일을 가져오는 패스워드를 안다고 그 인증서의 발급자를 신뢰할 수 있는 것은 아니다. 패스워드 보호 확인, 개인 키와 인증서의 일치 확인, 인증서 체인 검증을 각각 수행해야 한다.

PKCS #12는 개인 키, 인증서, 인증서 체인, 기타 비밀과 속성을 한 파일로 옮기기 위한 형식이다. .p12와 .pfx 확장자로 자주 만난다. 핵심 문서는 RFC 7292, PKCS #12 v1.1이다.

무엇이 들어갈까

PFX
└── AuthenticatedSafe
    ├── 개인 키 또는 암호화된 개인 키
    ├── 사용자 인증서
    ├── 중간 CA 인증서
    └── 별칭·키 연결 속성

하나의 PFX에 여러 키와 인증서가 들어갈 수도 있다. 파일 확장자만 보고 인증서 하나라고 가정하면 안 된다.

최상위 PFX 구조

PFX ::= SEQUENCE {
    version   INTEGER {v3(3)},
    authSafe  ContentInfo,
    macData   MacData OPTIONAL
}
  • version: 현재 값 3
  • authSafe: CMS ContentInfo로 감싼 실제 SafeContents
  • macData: 패스워드 기반 무결성 검사 정보

SafeBag 종류

Bag 내용
keyBag 암호화되지 않은 PKCS #8 개인 키
pkcs8ShroudedKeyBag 패스워드로 암호화된 PKCS #8 개인 키
certBag X.509 인증서 등
crlBag 인증서 폐지 목록
secretBag 기타 비밀
safeContentsBag SafeBag을 다시 중첩

friendlyName은 사람이 보는 별칭이고 localKeyId는 개인 키와 인증서를 연결하는 데 사용된다. 실제 키 쌍 일치는 공개 키를 비교해 확인해야 한다.

암호화와 무결성은 다르다

  • 암호화: 파일을 본 사람이 개인 키 내용을 읽지 못하게 함
  • MAC: 패스워드를 모르는 사람이 파일을 변조했는지 확인

둘 중 하나만 있다고 둘 다 해결되는 것이 아니다. 빈 패스워드와 MAC 생략도 구현체마다 처리 차이가 있어 상호 운용 테스트가 필요하다.

패스워드 처리 주의

기존 PKCS #12는 고유한 패스워드 인코딩과 KDF를 사용해 라이브러리 간 빈 문자열·NULL 처리에서 차이가 발생해 왔다. 직접 문자열을 바이트로 바꾸지 말고 사용하는 라이브러리의 PKCS #12 API를 사용한다.

RFC 9879는 PBMAC1을 PKCS #12 무결성 보호에 사용할 방법을 정의해 PBKDF2나 scrypt 같은 확장 가능한 KDF 사용을 허용하고, RFC 9579를 폐기한다. 다만 새 방식의 실제 지원 여부는 운영체제와 라이브러리마다 확인해야 한다.

OpenSSL로 내용 확인하기

개인 키를 출력하지 않고 인증서와 메타데이터를 먼저 확인한다.

openssl pkcs12 -in identity.p12 -info -nokeys

개인 키를 평문 파일로 내보내는 명령은 터미널 기록, 파일 권한, 백업에 키를 노출할 수 있다. 꼭 필요하지 않으면 하지 않는다.

가져올 때 검증할 항목

  1. MAC과 암호 해제가 성공했는가
  2. 허용한 알고리즘과 파라미터인가
  3. 개인 키와 리프 인증서의 공개 키가 일치하는가
  4. 인증서 체인의 서명과 순서가 유효한가
  5. 예상하지 못한 추가 키·인증서·secret bag이 없는가
  6. 가져온 개인 키를 안전한 키 저장소로 이동했는가

PFX 파일의 MAC이 맞는다는 사실은 인증서 발급자를 신뢰한다는 뜻이 아니다. 인증서 체인, 이름, 용도, 기간, 폐지 상태는 사용 시점에 별도로 검증한다.

관련 RFC