317 lines
10 KiB
C
317 lines
10 KiB
C
/* $OpenBSD: ts_local.h,v 1.3 2022/11/26 17:23:18 tb Exp $ */
|
|
/* Written by Zoltan Glozik (zglozik@opentsa.org) for the OpenSSL
|
|
* project 2002, 2003, 2004.
|
|
*/
|
|
/* ====================================================================
|
|
* Copyright (c) 2006 The OpenSSL Project. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
*
|
|
* 3. All advertising materials mentioning features or use of this
|
|
* software must display the following acknowledgment:
|
|
* "This product includes software developed by the OpenSSL Project
|
|
* for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
|
|
*
|
|
* 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
|
|
* endorse or promote products derived from this software without
|
|
* prior written permission. For written permission, please contact
|
|
* licensing@OpenSSL.org.
|
|
*
|
|
* 5. Products derived from this software may not be called "OpenSSL"
|
|
* nor may "OpenSSL" appear in their names without prior written
|
|
* permission of the OpenSSL Project.
|
|
*
|
|
* 6. Redistributions of any form whatsoever must retain the following
|
|
* acknowledgment:
|
|
* "This product includes software developed by the OpenSSL Project
|
|
* for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
|
|
* EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
|
|
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
|
|
* OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
* ====================================================================
|
|
*
|
|
* This product includes cryptographic software written by Eric Young
|
|
* (eay@cryptsoft.com). This product includes software written by Tim
|
|
* Hudson (tjh@cryptsoft.com).
|
|
*
|
|
*/
|
|
|
|
#ifndef HEADER_TS_LOCAL_H
|
|
#define HEADER_TS_LOCAL_H
|
|
|
|
__BEGIN_HIDDEN_DECLS
|
|
|
|
/*
|
|
* MessageImprint ::= SEQUENCE {
|
|
* hashAlgorithm AlgorithmIdentifier,
|
|
* hashedMessage OCTET STRING }
|
|
*/
|
|
|
|
struct TS_msg_imprint_st {
|
|
X509_ALGOR *hash_algo;
|
|
ASN1_OCTET_STRING *hashed_msg;
|
|
};
|
|
|
|
/*
|
|
* TimeStampReq ::= SEQUENCE {
|
|
* version INTEGER { v1(1) },
|
|
* messageImprint MessageImprint,
|
|
* --a hash algorithm OID and the hash value of the data to be
|
|
* --time-stamped
|
|
* reqPolicy TSAPolicyId OPTIONAL,
|
|
* nonce INTEGER OPTIONAL,
|
|
* certReq BOOLEAN DEFAULT FALSE,
|
|
* extensions [0] IMPLICIT Extensions OPTIONAL }
|
|
*/
|
|
|
|
struct TS_req_st {
|
|
ASN1_INTEGER *version;
|
|
TS_MSG_IMPRINT *msg_imprint;
|
|
ASN1_OBJECT *policy_id; /* OPTIONAL */
|
|
ASN1_INTEGER *nonce; /* OPTIONAL */
|
|
ASN1_BOOLEAN cert_req; /* DEFAULT FALSE */
|
|
STACK_OF(X509_EXTENSION) *extensions; /* [0] OPTIONAL */
|
|
};
|
|
|
|
/*
|
|
* Accuracy ::= SEQUENCE {
|
|
* seconds INTEGER OPTIONAL,
|
|
* millis [0] INTEGER (1..999) OPTIONAL,
|
|
* micros [1] INTEGER (1..999) OPTIONAL }
|
|
*/
|
|
|
|
struct TS_accuracy_st {
|
|
ASN1_INTEGER *seconds;
|
|
ASN1_INTEGER *millis;
|
|
ASN1_INTEGER *micros;
|
|
};
|
|
|
|
/*
|
|
* TSTInfo ::= SEQUENCE {
|
|
* version INTEGER { v1(1) },
|
|
* policy TSAPolicyId,
|
|
* messageImprint MessageImprint,
|
|
* -- MUST have the same value as the similar field in
|
|
* -- TimeStampReq
|
|
* serialNumber INTEGER,
|
|
* -- Time-Stamping users MUST be ready to accommodate integers
|
|
* -- up to 160 bits.
|
|
* genTime GeneralizedTime,
|
|
* accuracy Accuracy OPTIONAL,
|
|
* ordering BOOLEAN DEFAULT FALSE,
|
|
* nonce INTEGER OPTIONAL,
|
|
* -- MUST be present if the similar field was present
|
|
* -- in TimeStampReq. In that case it MUST have the same value.
|
|
* tsa [0] GeneralName OPTIONAL,
|
|
* extensions [1] IMPLICIT Extensions OPTIONAL }
|
|
*/
|
|
|
|
struct TS_tst_info_st {
|
|
ASN1_INTEGER *version;
|
|
ASN1_OBJECT *policy_id;
|
|
TS_MSG_IMPRINT *msg_imprint;
|
|
ASN1_INTEGER *serial;
|
|
ASN1_GENERALIZEDTIME *time;
|
|
TS_ACCURACY *accuracy;
|
|
ASN1_BOOLEAN ordering;
|
|
ASN1_INTEGER *nonce;
|
|
GENERAL_NAME *tsa;
|
|
STACK_OF(X509_EXTENSION) *extensions;
|
|
};
|
|
|
|
/*
|
|
* PKIStatusInfo ::= SEQUENCE {
|
|
* status PKIStatus,
|
|
* statusString PKIFreeText OPTIONAL,
|
|
* failInfo PKIFailureInfo OPTIONAL }
|
|
*
|
|
* From RFC 1510 - section 3.1.1:
|
|
* PKIFreeText ::= SEQUENCE SIZE (1..MAX) OF UTF8String
|
|
* -- text encoded as UTF-8 String (note: each UTF8String SHOULD
|
|
* -- include an RFC 1766 language tag to indicate the language
|
|
* -- of the contained text)
|
|
*/
|
|
|
|
struct TS_status_info_st {
|
|
ASN1_INTEGER *status;
|
|
STACK_OF(ASN1_UTF8STRING) *text;
|
|
ASN1_BIT_STRING *failure_info;
|
|
};
|
|
|
|
/*
|
|
* TimeStampResp ::= SEQUENCE {
|
|
* status PKIStatusInfo,
|
|
* timeStampToken TimeStampToken OPTIONAL }
|
|
*/
|
|
|
|
struct TS_resp_st {
|
|
TS_STATUS_INFO *status_info;
|
|
PKCS7 *token;
|
|
TS_TST_INFO *tst_info;
|
|
};
|
|
|
|
/* The structure below would belong to the ESS component. */
|
|
|
|
/*
|
|
* IssuerSerial ::= SEQUENCE {
|
|
* issuer GeneralNames,
|
|
* serialNumber CertificateSerialNumber
|
|
* }
|
|
*/
|
|
|
|
struct ESS_issuer_serial {
|
|
STACK_OF(GENERAL_NAME) *issuer;
|
|
ASN1_INTEGER *serial;
|
|
};
|
|
|
|
/*
|
|
* ESSCertID ::= SEQUENCE {
|
|
* certHash Hash,
|
|
* issuerSerial IssuerSerial OPTIONAL
|
|
* }
|
|
*/
|
|
|
|
struct ESS_cert_id {
|
|
ASN1_OCTET_STRING *hash; /* Always SHA-1 digest. */
|
|
ESS_ISSUER_SERIAL *issuer_serial;
|
|
};
|
|
|
|
/*
|
|
* SigningCertificate ::= SEQUENCE {
|
|
* certs SEQUENCE OF ESSCertID,
|
|
* policies SEQUENCE OF PolicyInformation OPTIONAL
|
|
* }
|
|
*/
|
|
|
|
struct ESS_signing_cert {
|
|
STACK_OF(ESS_CERT_ID) *cert_ids;
|
|
STACK_OF(POLICYINFO) *policy_info;
|
|
};
|
|
|
|
/*
|
|
* ESSCertIDv2 ::= SEQUENCE {
|
|
* hashAlgorithm AlgorithmIdentifier
|
|
* DEFAULT {algorithm id-sha256},
|
|
* certHash Hash,
|
|
* issuerSerial IssuerSerial OPTIONAL }
|
|
*/
|
|
|
|
struct ESS_cert_id_v2 {
|
|
X509_ALGOR *hash_alg; /* Default SHA-256. */
|
|
ASN1_OCTET_STRING *hash;
|
|
ESS_ISSUER_SERIAL *issuer_serial;
|
|
};
|
|
|
|
/*
|
|
* SigningCertificateV2 ::= SEQUENCE {
|
|
* certs SEQUENCE OF ESSCertIDv2,
|
|
* policies SEQUENCE OF PolicyInformation OPTIONAL }
|
|
*/
|
|
|
|
struct ESS_signing_cert_v2 {
|
|
STACK_OF(ESS_CERT_ID_V2) *cert_ids;
|
|
STACK_OF(POLICYINFO) *policy_info;
|
|
};
|
|
|
|
struct TS_resp_ctx {
|
|
X509 *signer_cert;
|
|
EVP_PKEY *signer_key;
|
|
STACK_OF(X509) *certs; /* Certs to include in signed data. */
|
|
STACK_OF(ASN1_OBJECT) *policies; /* Acceptable policies. */
|
|
ASN1_OBJECT *default_policy; /* It may appear in policies, too. */
|
|
STACK_OF(EVP_MD) *mds; /* Acceptable message digests. */
|
|
ASN1_INTEGER *seconds; /* accuracy, 0 means not specified. */
|
|
ASN1_INTEGER *millis; /* accuracy, 0 means not specified. */
|
|
ASN1_INTEGER *micros; /* accuracy, 0 means not specified. */
|
|
unsigned clock_precision_digits; /* fraction of seconds in
|
|
time stamp token. */
|
|
unsigned flags; /* Optional info, see values above. */
|
|
|
|
/* Callback functions. */
|
|
TS_serial_cb serial_cb;
|
|
void *serial_cb_data; /* User data for serial_cb. */
|
|
|
|
TS_time_cb time_cb;
|
|
void *time_cb_data; /* User data for time_cb. */
|
|
|
|
TS_extension_cb extension_cb;
|
|
void *extension_cb_data; /* User data for extension_cb. */
|
|
|
|
/* These members are used only while creating the response. */
|
|
TS_REQ *request;
|
|
TS_RESP *response;
|
|
TS_TST_INFO *tst_info;
|
|
};
|
|
|
|
/* Context structure for the generic verify method. */
|
|
|
|
struct TS_verify_ctx {
|
|
/* Set this to the union of TS_VFY_... flags you want to carry out. */
|
|
unsigned flags;
|
|
|
|
/* Must be set only with TS_VFY_SIGNATURE. certs is optional. */
|
|
X509_STORE *store;
|
|
STACK_OF(X509) *certs;
|
|
|
|
/* Must be set only with TS_VFY_POLICY. */
|
|
ASN1_OBJECT *policy;
|
|
|
|
/* Must be set only with TS_VFY_IMPRINT. If md_alg is NULL,
|
|
the algorithm from the response is used. */
|
|
X509_ALGOR *md_alg;
|
|
unsigned char *imprint;
|
|
unsigned imprint_len;
|
|
|
|
/* Must be set only with TS_VFY_DATA. */
|
|
BIO *data;
|
|
|
|
/* Must be set only with TS_VFY_TSA_NAME. */
|
|
ASN1_INTEGER *nonce;
|
|
|
|
/* Must be set only with TS_VFY_TSA_NAME. */
|
|
GENERAL_NAME *tsa_name;
|
|
};
|
|
|
|
/*
|
|
* Public OpenSSL API that we do not currently want to expose.
|
|
*/
|
|
|
|
ESS_CERT_ID_V2 *ESS_CERT_ID_V2_new(void);
|
|
void ESS_CERT_ID_V2_free(ESS_CERT_ID_V2 *a);
|
|
int i2d_ESS_CERT_ID_V2(const ESS_CERT_ID_V2 *a, unsigned char **pp);
|
|
ESS_CERT_ID_V2 *d2i_ESS_CERT_ID_V2(ESS_CERT_ID_V2 **a, const unsigned char **pp,
|
|
long length);
|
|
ESS_CERT_ID_V2 *ESS_CERT_ID_V2_dup(ESS_CERT_ID_V2 *a);
|
|
|
|
ESS_SIGNING_CERT_V2 *ESS_SIGNING_CERT_V2_new(void);
|
|
void ESS_SIGNING_CERT_V2_free(ESS_SIGNING_CERT_V2 *a);
|
|
int i2d_ESS_SIGNING_CERT_V2(const ESS_SIGNING_CERT_V2 *a,
|
|
unsigned char **pp);
|
|
ESS_SIGNING_CERT_V2 *d2i_ESS_SIGNING_CERT_V2(ESS_SIGNING_CERT_V2 **a,
|
|
const unsigned char **pp, long length);
|
|
ESS_SIGNING_CERT_V2 *ESS_SIGNING_CERT_V2_dup(ESS_SIGNING_CERT_V2 *a);
|
|
|
|
__END_HIDDEN_DECLS
|
|
|
|
#endif /* !HEADER_TS_LOCAL_H */
|