/** * @file crl.c * * @brief Implementation of crl_t. * */ /* * Copyright (C) 2006 Andreas Steffen * Hochschule fuer Technik Rapperswil * * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License as published by the * Free Software Foundation; either version 2 of the License, or (at your * option) any later version. See . * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * for more details. */ #include #include #include #include #include #include #include #include #include #include #include #include "certinfo.h" #include "x509.h" #include "crl.h" #define CRL_WARNING_INTERVAL 7 /* days */ /* access structure for a revoked certificate */ typedef struct revokedCert_t revokedCert_t; struct revokedCert_t { chunk_t userCertificate; time_t revocationDate; crl_reason_t revocationReason; }; typedef struct private_crl_t private_crl_t; /** * Private data of a crl_t object. */ struct private_crl_t { /** * Public interface for this crl. */ crl_t public; /** * Time when crl was installed */ time_t installed; /** * List of crlDistributionPoints */ linked_list_t *crlDistributionPoints; /** * X.509 crl in DER format */ chunk_t certificateList; /** * X.509 crl body over which signature is computed */ chunk_t tbsCertList; /** * Version of the X.509 crl */ u_int version; /** * Signature algorithm */ int sigAlg; /** * ID representing the crl issuer */ identification_t *issuer; /** * CRL number */ chunk_t crlNumber; /** * Time when the crl was generated */ time_t thisUpdate; /** * Time when an update crl will be available */ time_t nextUpdate; /** * List of identification_t's representing subjectAltNames */ linked_list_t *revokedCertificates; /** * Authority Key Identifier */ chunk_t authKeyID; /** * Authority Key Serial Number */ chunk_t authKeySerialNumber; /** * Signature algorithm (must be identical to sigAlg) */ int algorithm; /** * Signature */ chunk_t signature; }; /** * ASN.1 definition of an X.509 certificate revocation list */ static const asn1Object_t crlObjects[] = { { 0, "certificateList", ASN1_SEQUENCE, ASN1_OBJ }, /* 0 */ { 1, "tbsCertList", ASN1_SEQUENCE, ASN1_OBJ }, /* 1 */ { 2, "version", ASN1_INTEGER, ASN1_OPT | ASN1_BODY }, /* 2 */ { 2, "end opt", ASN1_EOC, ASN1_END }, /* 3 */ { 2, "signature", ASN1_EOC, ASN1_RAW }, /* 4 */ { 2, "issuer", ASN1_SEQUENCE, ASN1_OBJ }, /* 5 */ { 2, "thisUpdate", ASN1_EOC, ASN1_RAW }, /* 6 */ { 2, "nextUpdate", ASN1_EOC, ASN1_RAW }, /* 7 */ { 2, "revokedCertificates", ASN1_SEQUENCE, ASN1_OPT | ASN1_LOOP }, /* 8 */ { 3, "certList", ASN1_SEQUENCE, ASN1_NONE }, /* 9 */ { 4, "userCertificate", ASN1_INTEGER, ASN1_BODY }, /* 10 */ { 4, "revocationDate", ASN1_EOC, ASN1_RAW }, /* 11 */ { 4, "crlEntryExtensions", ASN1_SEQUENCE, ASN1_OPT | ASN1_LOOP }, /* 12 */ { 5, "extension", ASN1_SEQUENCE, ASN1_NONE }, /* 13 */ { 6, "extnID", ASN1_OID, ASN1_BODY }, /* 14 */ { 6, "critical", ASN1_BOOLEAN, ASN1_DEF | ASN1_BODY }, /* 15 */ { 6, "extnValue", ASN1_OCTET_STRING, ASN1_BODY }, /* 16 */ { 4, "end opt or loop", ASN1_EOC, ASN1_END }, /* 17 */ { 2, "end opt or loop", ASN1_EOC, ASN1_END }, /* 18 */ { 2, "optional extensions", ASN1_CONTEXT_C_0, ASN1_OPT }, /* 19 */ { 3, "crlExtensions", ASN1_SEQUENCE, ASN1_LOOP }, /* 20 */ { 4, "extension", ASN1_SEQUENCE, ASN1_NONE }, /* 21 */ { 5, "extnID", ASN1_OID, ASN1_BODY }, /* 22 */ { 5, "critical", ASN1_BOOLEAN, ASN1_DEF | ASN1_BODY }, /* 23 */ { 5, "extnValue", ASN1_OCTET_STRING, ASN1_BODY }, /* 24 */ { 3, "end loop", ASN1_EOC, ASN1_END }, /* 25 */ { 2, "end opt", ASN1_EOC, ASN1_END }, /* 26 */ { 1, "signatureAlgorithm", ASN1_EOC, ASN1_RAW }, /* 27 */ { 1, "signatureValue", ASN1_BIT_STRING, ASN1_BODY } /* 28 */ }; #define CRL_OBJ_CERTIFICATE_LIST 0 #define CRL_OBJ_TBS_CERT_LIST 1 #define CRL_OBJ_VERSION 2 #define CRL_OBJ_SIG_ALG 4 #define CRL_OBJ_ISSUER 5 #define CRL_OBJ_THIS_UPDATE 6 #define CRL_OBJ_NEXT_UPDATE 7 #define CRL_OBJ_USER_CERTIFICATE 10 #define CRL_OBJ_REVOCATION_DATE 11 #define CRL_OBJ_CRL_ENTRY_EXTN_ID 14 #define CRL_OBJ_CRL_ENTRY_CRITICAL 15 #define CRL_OBJ_CRL_ENTRY_EXTN_VALUE 16 #define CRL_OBJ_EXTN_ID 22 #define CRL_OBJ_CRITICAL 23 #define CRL_OBJ_EXTN_VALUE 24 #define CRL_OBJ_ALGORITHM 27 #define CRL_OBJ_SIGNATURE 28 #define CRL_OBJ_ROOF 29 /** * Parses a CRL revocation reason code */ static crl_reason_t parse_crl_reasonCode(chunk_t object) { crl_reason_t reason = REASON_UNSPECIFIED; if (*object.ptr == ASN1_ENUMERATED && asn1_length(&object) == 1) { reason = *object.ptr; } DBG2(" '%N'", crl_reason_names, reason); return reason; } /** * Parses an X.509 Certificate Revocation List (CRL) */ bool parse_x509crl(chunk_t blob, u_int level0, private_crl_t *crl) { asn1_ctx_t ctx; bool critical; chunk_t extnID; chunk_t userCertificate = chunk_empty; revokedCert_t *revokedCert = NULL; chunk_t object; u_int level; int objectID = 0; asn1_init(&ctx, blob, level0, FALSE, FALSE); while (objectID < CRL_OBJ_ROOF) { if (!extract_object(crlObjects, &objectID, &object, &level, &ctx)) return FALSE; /* those objects which will parsed further need the next higher level */ level++; switch (objectID) { case CRL_OBJ_CERTIFICATE_LIST: crl->certificateList = object; break; case CRL_OBJ_TBS_CERT_LIST: crl->tbsCertList = object; break; case CRL_OBJ_VERSION: crl->version = (object.len) ? (1+(u_int)*object.ptr) : 1; DBG2(" v%d", crl->version); break; case CRL_OBJ_SIG_ALG: crl->sigAlg = parse_algorithmIdentifier(object, level, NULL); break; case CRL_OBJ_ISSUER: crl->issuer = identification_create_from_encoding(ID_DER_ASN1_DN, object); DBG2(" '%D'", crl->issuer); break; case CRL_OBJ_THIS_UPDATE: crl->thisUpdate = parse_time(object, level); break; case CRL_OBJ_NEXT_UPDATE: crl->nextUpdate = parse_time(object, level); break; case CRL_OBJ_USER_CERTIFICATE: userCertificate = object; break; case CRL_OBJ_REVOCATION_DATE: revokedCert = malloc_thing(revokedCert_t); revokedCert->userCertificate = userCertificate; revokedCert->revocationDate = parse_time(object, level); revokedCert->revocationReason = REASON_UNSPECIFIED; crl->revokedCertificates->insert_last(crl->revokedCertificates, (void *)revokedCert); break; case CRL_OBJ_CRL_ENTRY_EXTN_ID: case CRL_OBJ_EXTN_ID: extnID = object; break; case CRL_OBJ_CRL_ENTRY_CRITICAL: case CRL_OBJ_CRITICAL: critical = object.len && *object.ptr; DBG2(" %s",(critical)?"TRUE":"FALSE"); break; case CRL_OBJ_CRL_ENTRY_EXTN_VALUE: case CRL_OBJ_EXTN_VALUE: { int extn_oid = known_oid(extnID); if (revokedCert && extn_oid == OID_CRL_REASON_CODE) { revokedCert->revocationReason = parse_crl_reasonCode(object); } else if (extn_oid == OID_AUTHORITY_KEY_ID) { parse_authorityKeyIdentifier(object, level, &crl->authKeyID, &crl->authKeySerialNumber); } else if (extn_oid == OID_CRL_NUMBER) { if (!parse_asn1_simple_object(&object, ASN1_INTEGER, level, "crlNumber")) { return FALSE; } crl->crlNumber = object; } } break; case CRL_OBJ_ALGORITHM: crl->algorithm = parse_algorithmIdentifier(object, level, NULL); break; case CRL_OBJ_SIGNATURE: crl->signature = object; break; default: break; } objectID++; } time(&crl->installed); return TRUE; } /** * Implements crl_t.is_valid */ static bool is_valid(const private_crl_t *this) { time_t current_time = time(NULL); DBG2(" this update : %T", &this->thisUpdate); DBG2(" current time: %T", ¤t_time); DBG2(" next update: %T", &this->nextUpdate); return current_time < this->nextUpdate; } /** * Implements crl_t.get_issuer */ static identification_t *get_issuer(const private_crl_t *this) { return this->issuer; } /** * Implements crl_t.equals_issuer */ static bool equals_issuer(const private_crl_t *this, const private_crl_t *other) { return (this->authKeyID.ptr) ? chunk_equals(this->authKeyID, other->authKeyID) : (this->issuer->equals(this->issuer, other->issuer) && chunk_equals_or_null(this->authKeySerialNumber, other->authKeySerialNumber)); } /** * Implements crl_t.is_issuer */ static bool is_issuer(const private_crl_t *this, const x509_t *issuer) { return (this->authKeyID.ptr) ? chunk_equals(this->authKeyID, issuer->get_subjectKeyID(issuer)) : (this->issuer->equals(this->issuer, issuer->get_subject(issuer)) && chunk_equals_or_null(this->authKeySerialNumber, issuer->get_serialNumber(issuer))); } /** * Implements crl_t.is_newer */ static bool is_newer(const private_crl_t *this, const private_crl_t *other) { return (this->nextUpdate > other->nextUpdate); } /** * Implements crl_t.verify */ static bool verify(const private_crl_t *this, const rsa_public_key_t *signer) { return signer->verify_emsa_pkcs1_signature(signer, this->tbsCertList, this->signature) == SUCCESS; } /** * Implements crl_t.get_status */ static void get_status(const private_crl_t *this, certinfo_t *certinfo) { chunk_t serialNumber = certinfo->get_serialNumber(certinfo); iterator_t *iterator; revokedCert_t *revokedCert; certinfo->set_nextUpdate(certinfo, this->nextUpdate); certinfo->set_status(certinfo, CERT_GOOD); iterator = this->revokedCertificates->create_iterator(this->revokedCertificates, TRUE); while (iterator->iterate(iterator, (void**)&revokedCert)) { if (chunk_equals(serialNumber, revokedCert->userCertificate)) { certinfo->set_status(certinfo, CERT_REVOKED); certinfo->set_revocationTime(certinfo, revokedCert->revocationDate); certinfo->set_revocationReason(certinfo, revokedCert->revocationReason); break; } } iterator->destroy(iterator); } /** * Implements crl_t.write_to_file. */ static bool write_to_file(private_crl_t *this, const char *path, mode_t mask, bool force) { return chunk_write(this->certificateList, path, "crl", mask, force); } /** * Implements crl_t.destroy */ static void destroy(private_crl_t *this) { this->revokedCertificates->destroy_function(this->revokedCertificates, free); this->crlDistributionPoints->destroy_offset(this->crlDistributionPoints, offsetof(identification_t, destroy)); DESTROY_IF(this->issuer); free(this->certificateList.ptr); free(this); } /** * Implementation of crl_t.list. */ static void list(private_crl_t *this, FILE* out, bool utc) { time_t now; now = time(NULL); fprintf(out, "%#T, revoked certs: %d\n", &this->installed, utc, this->revokedCertificates->get_count(this->revokedCertificates)); fprintf(out, " issuer: '%D'\n", this->issuer); if (this->crlNumber.ptr) { fprintf(out, " crlnumber: %#B\n", &this->crlNumber); } fprintf(out, " updates: this %#T\n", &this->thisUpdate, utc); fprintf(out, " next %#T ", &this->nextUpdate, utc); if (this->nextUpdate == UNDEFINED_TIME) { fprintf(out, "ok (expires never)\n"); } else if (now > this->nextUpdate) { fprintf(out, "expired (%V ago)\n", &now, &this->nextUpdate); } else if (now > this->nextUpdate - CRL_WARNING_INTERVAL * 60 * 60 * 24) { fprintf(out, "ok (expires in %V)\n", &now, &this->nextUpdate); } else { fprintf(out, "ok\n"); } if (this->authKeyID.ptr) { fprintf(out, " authkey: %#B\n", &this->authKeyID); } if (this->authKeySerialNumber.ptr) { fprintf(out, " aserial: %#B\n", &this->authKeySerialNumber); } } /* * Described in header. */ crl_t *crl_create_from_chunk(chunk_t chunk) { private_crl_t *this = malloc_thing(private_crl_t); /* initialize */ this->crlDistributionPoints = linked_list_create(); this->tbsCertList = chunk_empty; this->issuer = NULL; this->crlNumber = chunk_empty; this->revokedCertificates = linked_list_create(); this->authKeyID = chunk_empty; this->authKeySerialNumber = chunk_empty; /* public functions */ this->public.get_issuer = (identification_t* (*) (const crl_t*))get_issuer; this->public.equals_issuer = (bool (*) (const crl_t*,const crl_t*))equals_issuer; this->public.is_issuer = (bool (*) (const crl_t*,const x509_t*))is_issuer; this->public.is_valid = (bool (*) (const crl_t*))is_valid; this->public.is_newer = (bool (*) (const crl_t*,const crl_t*))is_newer; this->public.verify = (bool (*) (const crl_t*,const rsa_public_key_t*))verify; this->public.get_status = (void (*) (const crl_t*,certinfo_t*))get_status; this->public.write_to_file = (bool (*) (const crl_t*,const char*,mode_t,bool))write_to_file; this->public.list = (void(*)(crl_t*, FILE* out, bool utc))list; this->public.destroy = (void (*) (crl_t*))destroy; if (!parse_x509crl(chunk, 0, this)) { destroy(this); return NULL; } return &this->public; } /* * Described in header. */ crl_t *crl_create_from_file(const char *filename) { bool pgp = FALSE; chunk_t chunk = chunk_empty; if (!pem_asn1_load_file(filename, NULL, "crl", &chunk, &pgp)) { return NULL; } return crl_create_from_chunk(chunk); }