StormByte-Crypto 3.1.0
C++26 cryptography module of the StormByte suite
Loading...
Searching...
No Matches
revocation.hxx
Go to the documentation of this file.
1/*
2 * Copyright (C) 2024-2026 David C. Manuelda (StormBytePP)
3 *
4 * This file is part of StormByte-Crypto.
5 *
6 * StormByte-Crypto original source is dual-licensed:
7 *
8 * 1. GNU Lesser General Public License v3.0 (or later)
9 * You may redistribute and/or modify this file under the terms of the
10 * GNU Lesser General Public License as published by the Free Software
11 * Foundation, either version 3 of the License, or (at your option) any
12 * later version.
13 *
14 * 2. Commercial license
15 * Alternatively, this file may be used under the terms of a commercial
16 * license agreement with the copyright holder
17 * (David C. Manuelda <StormByte@gmail.com>).
18 *
19 * Both licenses apply only to original StormByte-Crypto source in this
20 * repository. They do not cover other StormByte modules or any third-party
21 * material shipped with this repository (including everything under
22 * thirdparty/, in particular Crypto++, bundled libbzip2, the StormByte-Buffer
23 * tree and the StormByte suite it vendors), which remains under its own license.
24 *
25 * Neither license grants any patent rights. Any patent licenses required
26 * to use this software or third-party components must be obtained separately
27 * from the patent holders.
28 *
29 * StormByte-Crypto is distributed in the hope that it will be useful,
30 * but WITHOUT ANY WARRANTY; without even the implied warranty of
31 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
32 * General Public License for more details.
33 *
34 * You should have received a copy of the GNU Lesser General Public License
35 * version 3 along with StormByte-Crypto. If not, see
36 * <https://www.gnu.org/licenses/lgpl-3.0.html>.
37 *
38 * SPDX-License-Identifier: LGPL-3.0-or-later OR LicenseRef-StormByte-Commercial
39 */
40
41#pragma once
42
44
49namespace StormByte {
54 namespace Crypto {
59 namespace X509 {
64 enum class RevocationFormat {
67 };
68
78
95
100
105 struct RevocationEvidence final {
107 std::span<const std::byte> der;
108 };
109
121 public:
139 static ExpectedRevocation Verify(const Certificate& certificate, const Certificate& issuer,
140 RevocationFormat format, std::span<const std::byte> der, TimePoint at);
141 };
142 }
143 }
144}
Immutable, strictly DER-parsed X.509 certificate.
Definition certificate.hxx:262
Verifies supplied CRL/OCSP evidence offline using Crypto primitives.
Definition revocation.hxx:120
static ExpectedRevocation Verify(const Certificate &certificate, const Certificate &issuer, RevocationFormat format, std::span< const std::byte > der, TimePoint at)
Verifies one complete CRL or OCSP response for a certificate.
X.509 certificate parsing and chain verification.
RevocationError
Failures that prevent trusting revocation evidence.
Definition revocation.hxx:83
@ NotYetValid
Evidence was produced after the requested validation time.
Definition revocation.hxx:91
@ InvalidSignature
Evidence signature cannot be verified with an authorized key.
Definition revocation.hxx:89
@ MissingNextUpdate
Evidence has no bounded freshness interval.
Definition revocation.hxx:93
@ UnsupportedFeature
Unsupported algorithm, CRL scope, extension or response type.
Definition revocation.hxx:86
@ ResponderUnauthorized
OCSP signer is not the issuer or an authorized delegated responder.
Definition revocation.hxx:90
@ MalformedEvidence
Invalid DER, duplicate fields, or malformed status data.
Definition revocation.hxx:85
@ IssuerMismatch
Evidence issuer or OCSP CertID does not match the supplied issuer.
Definition revocation.hxx:87
@ CertificateMismatch
Evidence does not contain a status for the target certificate.
Definition revocation.hxx:88
@ InvalidRequest
Empty certificates, invalid issuer relationship or oversized evidence.
Definition revocation.hxx:84
@ Stale
Evidence validity interval does not cover the requested time.
Definition revocation.hxx:92
RevocationFormat
Encoding of offline revocation evidence supplied by the caller.
Definition revocation.hxx:64
@ CRL
DER-encoded complete X.509 CertificateList.
Definition revocation.hxx:65
@ OCSP
DER-encoded successful OCSPResponse containing BasicOCSPResponse.
Definition revocation.hxx:66
std::chrono::sys_seconds TimePoint
Point in time with second precision, as stored in certificates.
Definition certificate.hxx:75
RevocationStatus
Authenticated status reported by a verified evidence object.
Definition revocation.hxx:73
@ Good
Evidence covers the certificate and does not report it revoked.
Definition revocation.hxx:74
@ Unknown
A verified OCSP response explicitly reports unknown status.
Definition revocation.hxx:76
@ Revoked
A verified CRL or OCSP response reports revocation.
Definition revocation.hxx:75
StormByte::Expected< RevocationStatus, RevocationError > ExpectedRevocation
Authenticated certificate status or a typed evidence-validation failure.
Definition revocation.hxx:99
Crypto module of the StormByte suite.
Definition aead.hxx:53
Root namespace of the StormByte suite.
std::conditional_t< Type::Reference< T >, std::expected< std::reference_wrapper< std::remove_reference_t< T > >, Safe::Shared< E > >, std::expected< T, Safe::Shared< E > > > Expected
Borrowed DER evidence for one certificate in a chain.
Definition revocation.hxx:105
RevocationFormat format
CRL or OCSP encoding.
Definition revocation.hxx:106
std::span< const std::byte > der
Untrusted DER, consumed synchronously.
Definition revocation.hxx:107
#define STORMBYTE_CRYPTO_PUBLIC
Definition visibility.h:53