30.openssl编程——PCKS12

30.1 概述

pkcs12（个人数字标准）用于存放用户证书、crl、用户私钥以及证书链，pkcs12中的私钥是加密存放的。

30.2 openssl实现

openssl的pkcs12实现在crypto/pkcs12目录，有如下源码：

目录架构	用途
p12_add.c	处理PCKS12_SAFEBAG, PKCS12_SAFEBAG用于存放正数和私钥相关的信息
p12_attr.c	属性处理
p12_ctr	生成一个完整的pkcs12
p12_init.c	构造一个pkcs12数据结构
p12_kiss.c	解析pkcs12结构，获取证书和私钥等信息
p12_npas	设置新口令
p12_p8e.c	加密处理用户私钥
p12_p8d.c	解密出用户私钥
pk12err.c	错误处理
pk12_asn.c	pkcs12各个数据结构的DER编解码实现
p12_crpt.c	pkcs12的pbe（基于口令的加密）函数
p12_decr.c	pkcs12的pbe解密
p12_key.c	根据用户口令生成对称密钥
p12_mutl.c	pkcs12的MAC信息处理

30.3 数据结构

数据结构定义在crypto/pkcs12/pkcs12.h

struct PKCS12_MAC_DATA_st {

X509_SIG *dinfo; 用于存放MAC值和摘要算法

ASN1_OCTET_STRING *salt;根据口令生成对称密钥pbe

ASN1_INTEGER *iter;

}

typedef struct

{

ASN1_INTEGER *version; 版本

PKCS12_MAC_DATA *mac; 用于存放MAC信息以及对称密钥相关信息

PCKS7 *authosafes; pcks7结构，用于存放证书\crl以及私钥等各种信息

}PKCS12;

typedef struct pkcs12_bag_st

{

ASN1_OBJECT *type;

union {

ASN1_OCTET_STRING *x509cert;

ASN1_OCTET_STRING *x509crl;

ASN1_OCTET_STRING *octet;

ASN1_IA5STRING *sdsicert;

ASN1_TYPE *other;

}value;

}

typedef struct PKCS12_SAFEBAG_st

{

ASN1_OBJECT *type;

union {

struct pkcs12_bag_st *bag;

struct pkcs8_priv_key_info_st *keybag;

X509_SIG *shkeybag;

STACK_OF(PKCS12_SAFEBAG) *safes;

ASN1_TYPE *other;

}value;

STACK_OF(X509_ATTRIBUTE) *attrib;

}

30.4 函数

函数	功能
PKCS12_gen_mac	生成MAC值，pass为用户口令，passlen为口令长度， mac和maclen用于存放MAC值。当p12中pkcs7为数据类型时， 本函数有效
PKCS12_verify_mac	验证pkcs12的MAC，pass为用户口令，passlen为口令长度。
PKCS12_create	PKCS12数据结构
PKCS12_parse	解析PKCS12，得到私钥和证书等信息
PKCS12_key_gen_asc PKCS12_key_gen_uni	生成pkcs12密钥，输入口令ASCII码或UNICODE
PKCS12_pbe_crypt	PKCS12加解密，algor为对称算法，pass口令，passlen为口令长度， in为输入数据，inlen为输入数据长度，data和datalen用于存放结果， en_de用于指明时加密还是解密
PKCS12_pack_p7data	打包PKCS12_SAFEBAG堆栈，生成PKCS7数据结构并返回
PKCS12_uppack_p7data
PKCS12_pack_p7encdata	将PKCS12_SAFEBAG堆栈根据pbe算法，口令和salt加密、生成pkcs7并返回
PKCS12_newpass	替换pkcs12的口令
PKCS12_setup_mac	设置pkcs12的数据MAC数据结构
PKCS12_set_mac	设置pkcs12的MAC数据结构
PCKS12_pack_authsafes	将pkcs7堆栈信息打包到pkcs12中
PKCS12_init	生成一个pkcs12数据结构，mode的值必须为NID_pkcs7_data
PKCS12_PBE_add	加载各种pbe算法
PKCS12_PBE_keyivgen	根据口令生成对称密钥，并作加解密初始化
PKCS12_item_pack_safebag	将输入的数据打包为PKCS12_SAFEBAG并返回
PKCS12_x5092certbag	将证书打包为PKCS12_SAFEBAG并返回
PKCS12_item_i2d_encrypt	将数据结构DER编码，然后加密，数据存放在ASN1_OCTET_STRING并返回
PKCS12_item_derypt_d2i	解密输入数据，然后DER解码出数据结构，并返回
PKCS12_add_friendlyname_asc	给PKCS12_SAFEBAG添加一个属性，
PKCS12_get_friendlyname	返回一个ASCII码值
PKCS12_add_localkeyid	给PKCS12_SAFEBAG添加一个NID_localKeyID属性
PKCS12_MAKE_SHKEYBAG	将pkcs8密钥转化为PKCS12_SAFEBAG
PKCS12_decrypt_skey	从bag中提取pkcs8密钥信息