StormByte-Crypto 3.1.0
C++26 cryptography module of the StormByte suite
Loading...
Searching...
No Matches
trust_path.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)
12 * any 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
32 * GNU Lesser 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
45
50namespace StormByte {
55 namespace Crypto {
60 namespace X509 {
72
84
89
94
99
105
111
119
137 std::span<const Certificate> intermediates, TimePoint at, const SubjectAltName& identity);
138
152 std::span<const Certificate> intermediates, const Certificate& anchor,
153 TimePoint at, const SubjectAltName& identity);
154
170 std::span<const Certificate> intermediates, const Certificate& anchor, TimePoint at,
171 const SubjectAltName& identity, std::span<const RevocationEvidence> evidence);
172 }
173 }
174}
Immutable, strictly DER-parsed X.509 certificate.
Definition certificate.hxx:262
One supported subjectAltName entry (a DNS name or an IP address).
Definition certificate.hxx:156
X.509 certificate parsing and chain verification.
StormByte::Expected< Safe::Vector< Certificate >, TrustPathError > ExpectedBundledTLSRoots
Library-owned certificates or an integrity/parse failure.
Definition trust_path.hxx:88
@ InvalidRequest
Empty certificates, invalid issuer relationship or oversized evidence.
Definition revocation.hxx:84
ExpectedTrustPath ValidateCustomCATLSPath(const Certificate &leaf, std::span< const Certificate > intermediates, const Certificate &anchor, TimePoint at, const SubjectAltName &identity)
Validates a separate, explicitly opted-in custom-CA server path.
TrustPathError
Failures of path validation, never a full authentication verdict.
Definition trust_path.hxx:65
@ RootNotAdmitted
No matching root belongs to the bundled server snapshot.
Definition trust_path.hxx:68
@ NativePolicyRejected
Native TLS policy rejected the explicitly anchored path.
Definition trust_path.hxx:70
@ PeerPathRejected
Linux's documented constrained verifier rejected the path.
Definition trust_path.hxx:69
@ BundleInvalid
Snapshot digest, count or certificate parsing failed.
Definition trust_path.hxx:66
const char * BundledTLSRootsRevision() noexcept
Returns the immutable snapshot revision.
StormByte::Expected< void, PaymentPeerError > ExpectedPaymentPeer
Payment peer trust and revocation result.
Definition trust_path.hxx:98
std::chrono::sys_seconds TimePoint
Point in time with second precision, as stored in certificates.
Definition certificate.hxx:75
ExpectedTrustPath ValidateBundledTLSPath(const Certificate &leaf, std::span< const Certificate > intermediates, TimePoint at, const SubjectAltName &identity)
Validates only a server trust path and SAN identity against bundled admission.
PaymentPeerError
Fail-closed payment peer failures.
Definition trust_path.hxx:77
@ RevocationUnavailable
Evidence is missing for at least one non-anchor certificate.
Definition trust_path.hxx:79
@ CertificateRevoked
A validated CRL or OCSP response reports revocation.
Definition trust_path.hxx:81
@ TrustPathRejected
Path or selected bundled anchor validation failed.
Definition trust_path.hxx:78
@ RevocationUnknown
A validated OCSP response reports unknown status.
Definition trust_path.hxx:82
@ RevocationEvidenceRejected
Any evidence is malformed, invalid, stale or unauthorized.
Definition trust_path.hxx:80
StormByte::Expected< void, TrustPathError > ExpectedTrustPath
Path-only success or an explicit failure, with no revocation assertion.
Definition trust_path.hxx:93
ExpectedBundledTLSRoots LoadBundledTLSRoots()
Loads a verified copy of the versioned, curated Mozilla server roots.
const char * BundledTLSRootsSHA256() noexcept
Returns the embedded PEM integrity fingerprint.
ExpectedPaymentPeer VerifyPaymentPeer(const Certificate &leaf, std::span< const Certificate > intermediates, const Certificate &anchor, TimePoint at, const SubjectAltName &identity, std::span< const RevocationEvidence > evidence)
Validates the bundled path and all non-anchor certificates' revocation status.
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
STL namespace.
Borrowed DER evidence for one certificate in a chain.
Definition revocation.hxx:105
#define STORMBYTE_CRYPTO_PUBLIC
Definition visibility.h:53