openssl CRL证书

CRL(Certificate Revocation List),证书撤销列表，是在证书撤销时用的.当证书因为一些原因会被CA吊销的证书。客户端拿到这个CRL后，就可以知道那些证书已经无效了。不过，CRL的发布是有一定的周期的，所以通过CRL的方法，客户端不能实时地检测某个证书是否有效。为了弥补CRL这个不足，现在一般都用OCSP(Online Certificate Status Protocol)，在线证书状态协议。

CRL在OpenSSL中的表示是通过下面几个结构体完成的，结构体定义在文件x509.h中：

  -------------------------------------------------------------------   

  typedef struct X509_revoked_st

      {  //这个结构代表了一个被吊销的证书 

          ASN1_INTEGER *serialNumber;     //证书序列号 

          ASN1_TIME *revocationDate;      //被吊销的日期 

          STACK_OF(X509_EXTENSION)  /* optional */ *extensions; 

          int sequence;  /* load sequence */ 

      } X509_REVOKED; 

-----------------------------------------------------------------------------------------------------

       typedef struct X509_crl_info_st

      {  //CRL的信息 

          ASN1_INTEGER *version;   //CRL的版本号 

          X509_ALGOR *sig_alg;     //CRL所使用的签名算法 

          X509_NAME *issuer;        //CRL的发布者 

          ASN1_TIME *lastUpdate;   //CRL发布的日期 

          ASN1_TIME *nextUpdate;   //下一次发布CRL的日期 

          STACK_OF(X509_REVOKED) *revoked;     //被吊销的证书的序列 

          STACK_OF(X509_EXTENSION)  /* [0] */  *extensions;

          ASN1_ENCODING enc;

      } X509_CRL_INFO; 

----------------------------------------------------------------------------------------------------------

       struct X509_crl_st

      {  //CRL结构体 

           /* actual signature */ 

          X509_CRL_INFO *crl;

          X509_ALGOR *sig_alg;    //CRL所使用的签名算法，和结构X509_crl_info_st中sig_alg的值一样 

          ASN1_BIT_STRING *signature;    //CRL的签名 

          int references;

      }  /* X509_CRL */ ;

在文件ossl_typ.h中有： typedef struct X509_crl_st X509_CRL; 

X509_CRL方法：

1.生成一个空的CRL

调用函数 X509_CRL_new() 

eg. X509_CRL *crl = X509_CRL_new();

2.设置CRL中各信息的值

调用函数 X509_CRL_set_XXX  ，其中XXX可以是version, issuer, lastUpdate, nextUpdate。

3.给CRL签名

调用 X509_CRL_sign() 

eg. X509_CRL_sign(crl, pkey, EVP_md5());

4.给CRL中添加一个扩展项

调用函数 int X509_CRL_add1_ext_i2d(X509_CRL *x, int nid, void *value, int crit, unsigned long flags) 

这个函数自动为用户生成一个X509_EXTENSION结构体，定义如下：

         typedef struct X509_extension_st

        {

            ASN1_OBJECT *object;

            ASN1_BOOLEAN critical;

            ASN1_OCTET_STRING *value;

        } X509_EXTENSION; 

参数x代表要操作的CRL，nid, value, crit分别是X509_EXTENSION中的object, value, critical，flag可以取下面的值：

         #define X509V3_ADD_OP_MASK        0xfL

        #define X509V3_ADD_DEFAULT        0L

        #define X509V3_ADD_APPEND        1L

        #define X509V3_ADD_REPLACE        2L

        #define X509V3_ADD_REPLACE_EXISTING    3L

        #define X509V3_ADD_KEEP_EXISTING    4L

        #define X509V3_ADD_DELETE        5L

        #define X509V3_ADD_SILENT        0x10 

一般用X509V3_ADD_DEFAULT就行了，也就是直接传0就OK了。

需要注意的是，函数X509_CRL_add1_ext_i2d要求传入的value是一个ASN1_OCTET_STRING*型的。开始以为，是void*就可以传任何类型的指针，结果在函数X509_CRL_add1_ext_i2d运行时，会产生段错误。

函数X509_CRL_add1_ext_i2d调用的主要的函数如下图:

         int X509_CRL_add1_ext_i2d(X509_CRL *x, int nid, void *value, int crit, unsigned long flags) 

          |(在文件x509_ext.c中)

          |此函数的作用是，把nid, value, crit组合成一个X509_EXTENSION结构，

          |通过flags指示的动作加入到x中。

           int X509V3_add1_i2d(STACK_OF(X509_EXTENSION) **x, int nid, void *value, int crit, unsigned long flags) 

            | (在文件v3_lib.c中) 

            | 此函数的作用是，通过调用X509V3_EXT_i2d把nid, value, crit组合成一个X509_EXTENSION结构， 

            | 通过flags指示的动作加入到x中。 

             X509_EXTENSION *X509V3_EXT_i2d(int ext_nid, int crit, void *ext_struc) 

              | (在文件v3_conf.c中) 

              | 此函数的作用是，把传入的三个参数组合成一个X509_EXTENSION结构， 

              | 这里的三个参数分别就是nid, crit, value 

               static X509_EXTENSION *do_ext_i2d(X509V3_EXT_METHOD *method, int ext_nid, int crit, void *ext_struc) 

                | (在文件v3_conf.c中) 

                | 这是一个内部函数，作用是通过method中的函数，把ext_struc转换成ASN1_OCTET_STRING， 

                | 然后调用X509_EXTENSION_create_by_NID生成一个X509_EXTENSION 

                 X509_EXTENSION *X509_EXTENSION_create_by_NID(X509_EXTENSION **ex, int nid, int crit, ASN1_OCTET_STRING *data) 

                  | (在文件x509_v3.c中) 

                  | 此函数的作用是，把nid转换成ASN1_OBJECT， 

                  | 并通过调用X509_EXTENSION_create_by_OBJ生成一个X509_EXTENSION 

                   X509_EXTENSION *X509_EXTENSION_create_by_OBJ(X509_EXTENSION **ex, ASN1_OBJECT *obj, int crit, ASN1_OCTET_STRING *data) 

                   (在文件x509_v3.c中)

                   此函数的作用是，通过调用X509_EXTENSION_new, X509_EXTENSION_set_object, 

                   X509_EXTENSION_set_critical, X509_EXTENSION_set_data生成一个X509_EXTENSION 

5.将CRL存入PEM格式文件

调用函数 PEM_write_X509_CRL() 

eg. PEM_write_X509_CRL(fp, crl);

这个函数是把CRL以PEM格式存入文件的。

6.从PEM格式文件中读取CRL

调用函数 PEM_read_X509_CRL() 

eg. PEM_read_X509_CRL(fp, crl, NULL, NULL);

其中，crl是一个指向X509_CRL的指针的指针。

 

openssl代码领读目录 

openssl代码领读目录