QSC Post Quantum Cryptographic Library 1.1.0.2 (B2)
A post quantum secure library written in Ansi C
Loading...
Searching...
No Matches
x509store.h
Go to the documentation of this file.
1/* 2020-2026 Quantum Resistant Cryptographic Solutions Corporation
2 * All Rights Reserved.
3 *
4 * NOTICE:
5 * This software and all accompanying materials are the exclusive property of
6 * Quantum Resistant Cryptographic Solutions Corporation (QRCS). The intellectual
7 * and technical concepts contained herein are proprietary to QRCS and are
8 * protected under applicable Canadian, U.S., and international copyright,
9 * patent, and trade secret laws.
10 *
11 * CRYPTOGRAPHIC ALGORITHMS AND IMPLEMENTATIONS:
12 * - This software includes implementations of cryptographic primitives and
13 * algorithms that are standardized or in the public domain, such as AES
14 * and SHA-3, which are not proprietary to QRCS.
15 * - This software also includes cryptographic primitives, constructions, and
16 * algorithms designed by QRCS, including but not limited to RCS, SCB, CSX, QMAC, and
17 * related components, which are proprietary to QRCS.
18 * - All source code, implementations, protocol compositions, optimizations,
19 * parameter selections, and engineering work contained in this software are
20 * original works of QRCS and are protected under this license.
21 *
22 * LICENSE AND USE RESTRICTIONS:
23 * - This software is licensed under the Quantum Resistant Cryptographic Solutions
24 * Public Research and Evaluation License (QRCS-PREL), 2025-2026.
25 * - Permission is granted solely for non-commercial evaluation, academic research,
26 * cryptographic analysis, interoperability testing, and feasibility assessment.
27 * - Commercial use, production deployment, commercial redistribution, or
28 * integration into products or services is strictly prohibited without a
29 * separate written license agreement executed with QRCS.
30 * - Licensing and authorized distribution are solely at the discretion of QRCS.
31 *
32 * EXPERIMENTAL CRYPTOGRAPHY NOTICE:
33 * Portions of this software may include experimental, novel, or evolving
34 * cryptographic designs. Use of this software is entirely at the user's risk.
35 *
36 * DISCLAIMER:
37 * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
38 * IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
39 * FOR A PARTICULAR PURPOSE, SECURITY, OR NON-INFRINGEMENT. QRCS DISCLAIMS ALL
40 * LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
41 * ARISING FROM THE USE OR MISUSE OF THIS SOFTWARE.
42 *
43 * FULL LICENSE:
44 * This software is subject to the Quantum Resistant Cryptographic Solutions
45 * Public Research and Evaluation License (QRCS-PREL), 2025-2026. The complete license terms
46 * are provided in the accompanying LICENSE file or at https://www.qrcscorp.ca.
47 *
48 * Written by: John G. Underhill
49 * Contact: contact@qrcscorp.ca
50 */
51
52#ifndef QSC_X509_STORE_H
53#define QSC_X509_STORE_H
54
55#include "qsccommon.h"
56#include "x509types.h"
57#include "x509verify.h"
58
59QSC_CPLUSPLUS_ENABLED_START
60
77
90QSC_EXPORT_API void qsc_x509_store_initialize(qsc_x509_store* store, qsc_x509_trust_anchor* anchors, size_t capacity);
91
107QSC_EXPORT_API qsc_asn1_status qsc_x509_store_add_anchor(qsc_x509_store* store, const qsc_x509_certificate* certificate, bool selfsigned);
108
121QSC_EXPORT_API const qsc_x509_trust_anchor* qsc_x509_store_find_anchor_for_certificate(const qsc_x509_store* store, const qsc_x509_certificate* certificate);
122
135QSC_EXPORT_API const qsc_x509_trust_anchor* qsc_x509_store_find_anchor_by_subject(const qsc_x509_store* store, const qsc_x509_name* subject);
136
150QSC_EXPORT_API const qsc_x509_trust_anchor* qsc_x509_store_find_anchor_by_subject_key_identifier(const qsc_x509_store* store, const uint8_t* keyidentifier, size_t keyidentifierlen);
151
164QSC_EXPORT_API bool qsc_x509_store_contains_anchor(const qsc_x509_store* store, const qsc_x509_certificate* certificate);
165
179QSC_EXPORT_API const qsc_x509_certificate* qsc_x509_store_find_issuer(const qsc_x509_store* store, const qsc_x509_certificate* certificate);
180
201QSC_EXPORT_API qsc_x509_verify_status qsc_x509_chain_build(const qsc_x509_certificate* leaf, const qsc_x509_certificate* intermediates,
202 size_t intermediatecount, const qsc_x509_store* store, qsc_x509_certificate* output, size_t outputcount, qsc_x509_chain* chain);
203
204QSC_CPLUSPLUS_ENABLED_END
205
206#endif
enum qsc_asn1_status_t qsc_asn1_status
ASN.1 helper status codes.
Contains common definitions for the Quantum Secure Cryptographic (QSC) library.
#define QSC_EXPORT_API
API export macro for Microsoft compilers when importing from a DLL.
Definition qsccommon.h:605
QSC_EXPORT_API const qsc_x509_trust_anchor * qsc_x509_store_find_anchor_for_certificate(const qsc_x509_store *store, const qsc_x509_certificate *certificate)
Find a trust anchor applicable to a certificate.
Definition x509store.c:166
QSC_EXPORT_API qsc_x509_verify_status qsc_x509_chain_build(const qsc_x509_certificate *leaf, const qsc_x509_certificate *intermediates, size_t intermediatecount, const qsc_x509_store *store, qsc_x509_certificate *output, size_t outputcount, qsc_x509_chain *chain)
Build a certification chain from a leaf certificate to a trust anchor.
Definition x509store.c:208
QSC_EXPORT_API const qsc_x509_trust_anchor * qsc_x509_store_find_anchor_by_subject_key_identifier(const qsc_x509_store *store, const uint8_t *keyidentifier, size_t keyidentifierlen)
Find a trust anchor by Subject Key Identifier.
Definition x509store.c:123
QSC_EXPORT_API void qsc_x509_store_initialize(qsc_x509_store *store, qsc_x509_trust_anchor *anchors, size_t capacity)
Initialize a certificate store.
Definition x509store.c:72
QSC_EXPORT_API const qsc_x509_trust_anchor * qsc_x509_store_find_anchor_by_subject(const qsc_x509_store *store, const qsc_x509_name *subject)
Find a trust anchor by subject name.
Definition x509store.c:103
QSC_EXPORT_API const qsc_x509_certificate * qsc_x509_store_find_issuer(const qsc_x509_store *store, const qsc_x509_certificate *certificate)
Find an issuer certificate in the trust store.
Definition x509store.c:200
QSC_EXPORT_API bool qsc_x509_store_contains_anchor(const qsc_x509_store *store, const qsc_x509_certificate *certificate)
Test whether a store contains a certificate as a trust anchor.
Definition x509store.c:146
QSC_EXPORT_API qsc_asn1_status qsc_x509_store_add_anchor(qsc_x509_store *store, const qsc_x509_certificate *certificate, bool selfsigned)
Add a trust anchor to a store from a certificate.
Definition x509store.c:84
X.509 certificate and certification-path verification interface.