1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
/** @file
* IPRT - Crypto - Time-Stamp Protocol (RFC-3161).
*/
/*
* Copyright (C) 2006-2025 Oracle and/or its affiliates.
*
* This file is part of VirtualBox base platform packages, as
* available from https://www.virtualbox.org.
*
* 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, in version 3 of the
* License.
*
* 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.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see <https://www.gnu.org/licenses>.
*
* The contents of this file may alternatively be used under the terms
* of the Common Development and Distribution License Version 1.0
* (CDDL), a copy of it is provided in the "COPYING.CDDL" file included
* in the VirtualBox distribution, in which case the provisions of the
* CDDL are applicable instead of those of the GPL.
*
* You may elect to license modified versions of this file under the
* terms and conditions of either the GPL or the CDDL or both.
*
* SPDX-License-Identifier: GPL-3.0-only OR CDDL-1.0
*/
#ifndef IPRT_INCLUDED_crypto_tsp_h
#define IPRT_INCLUDED_crypto_tsp_h
#ifndef RT_WITHOUT_PRAGMA_ONCE
# pragma once
#endif
#include <iprt/asn1.h>
#include <iprt/crypto/x509.h>
RT_C_DECLS_BEGIN
/** @defgroup grp_rt_cr_tap RTCrTap - Time-Stamp Protocol (RFC-3161)
* @ingroup grp_rt_crypto
* @{
*/
/**
* RFC-3161 MessageImprint (IPRT representation).
*/
typedef struct RTCRTSPMESSAGEIMPRINT
{
/** Sequence core. */
RTASN1SEQUENCECORE SeqCore;
/** The digest algorithm used to produce HashedMessage. */
RTCRX509ALGORITHMIDENTIFIER HashAlgorithm;
/** The digest of the message being timestamped. */
RTASN1OCTETSTRING HashedMessage;
} RTCRTSPMESSAGEIMPRINT;
/** Pointer to the IPRT representation of a RFC-3161 MessageImprint. */
typedef RTCRTSPMESSAGEIMPRINT *PRTCRTSPMESSAGEIMPRINT;
/** Pointer to the const IPRT representation of a RFC-3161 MessageImprint. */
typedef RTCRTSPMESSAGEIMPRINT const *PCRTCRTSPMESSAGEIMPRINT;
RTASN1TYPE_STANDARD_PROTOTYPES(RTCRTSPMESSAGEIMPRINT, RTDECL, RTCrTspMessageImprint, SeqCore.Asn1Core);
/**
* RFC-3161 Accuracy (IPRT representation).
*/
typedef struct RTCRTSPACCURACY
{
/** Sequence core. */
RTASN1SEQUENCECORE SeqCore;
/** The seconds accuracy.
* This will be larger than 0. If 1 inspect the Millis field. */
RTASN1INTEGER Seconds;
/** The millisecond accuracy, optional, implicit tag 0.
* Range 1..999. If 1 inspect the Micros field. */
RTASN1INTEGER Millis;
/** The microsecond accuracy, optional, implicit tag 1.
* Range 1..999. */
RTASN1INTEGER Micros;
} RTCRTSPACCURACY;
/** Pointer to the IPRT representation of a RFC-3161 Accuracy. */
typedef RTCRTSPACCURACY *PRTCRTSPACCURACY;
/** Pointer to the const IPRT representation of a RFC-3161 Accuracy. */
typedef RTCRTSPACCURACY const *PCRTCRTSPACCURACY;
RTASN1TYPE_STANDARD_PROTOTYPES(RTCRTSPACCURACY, RTDECL, RTCrTspAccuracy, SeqCore.Asn1Core);
/**
* RFC-3161 TSTInfo (IPRT representation).
*/
typedef struct RTCRTSPTSTINFO
{
/** Sequence core. */
RTASN1SEQUENCECORE SeqCore;
/** The structure version number, current only 1 is valid. */
RTASN1INTEGER Version;
/** Time authority policy. */
RTASN1OBJID Policy;
/** The message imprint. */
RTCRTSPMESSAGEIMPRINT MessageImprint;
/** Timestamp request serial number. */
RTASN1INTEGER SerialNumber;
/** The timestamp. */
RTASN1TIME GenTime;
/** The timestamp accuracy, optional. */
RTCRTSPACCURACY Accuracy;
/** Ordering, whatever that means, defaults to FALSE. */
RTASN1BOOLEAN Ordering;
/** Nonce, optional. */
RTASN1INTEGER Nonce;
/** Timestamp authority name, explicit optional.
* (Should match a name in the certificate of the signature.) */
struct
{
/** Context tag 0. */
RTASN1CONTEXTTAG0 CtxTag0;
/** The TSA name. */
RTCRX509GENERALNAME Tsa;
} T0;
/** Extensions, optional, implicit tag 1. */
RTCRX509EXTENSION Extensions;
} RTCRTSPTSTINFO;
/** Pointer to the IPRT representation of a RFC-3161 TSTInfo. */
typedef RTCRTSPTSTINFO *PRTCRTSPTSTINFO;
/** Pointer to the const IPRT representation of a RFC-3161 TSTInfo. */
typedef RTCRTSPTSTINFO const *PCRTCRTSPTSTINFO;
RTASN1TYPE_STANDARD_PROTOTYPES(RTCRTSPTSTINFO, RTDECL, RTCrTspTstInfo, SeqCore.Asn1Core);
/** The object identifier for RTCRTSPTSTINFO.
* Found in the ContentType field of PKCS \#7's ContentInfo structure and
* the equivalent CMS field. */
#define RTCRTSPTSTINFO_OID "1.2.840.113549.1.9.16.1.4"
/** @} */
RT_C_DECLS_END
#endif /* !IPRT_INCLUDED_crypto_tsp_h */
|
