oid.h

Go to the documentation of this file.

/* 2020-2026 Quantum Resistant Cryptographic Solutions Corporation
 * All Rights Reserved.
 *
 * NOTICE:
 * This software and all accompanying materials are the exclusive property of
 * Quantum Resistant Cryptographic Solutions Corporation (QRCS). The intellectual
 * and technical concepts contained herein are proprietary to QRCS and are
 * protected under applicable Canadian, U.S., and international copyright,
 * patent, and trade secret laws.
 *
 * CRYPTOGRAPHIC ALGORITHMS AND IMPLEMENTATIONS:
 * - This software includes implementations of cryptographic primitives and
 *   algorithms that are standardized or in the public domain, such as AES
 *   and SHA-3, which are not proprietary to QRCS.
 * - This software also includes cryptographic primitives, constructions, and
 *   algorithms designed by QRCS, including but not limited to RCS, SCB, CSX, QMAC, and
 *   related components, which are proprietary to QRCS.
 * - All source code, implementations, protocol compositions, optimizations,
 *   parameter selections, and engineering work contained in this software are
 *   original works of QRCS and are protected under this license.
 *
 * LICENSE AND USE RESTRICTIONS:
 * - This software is licensed under the Quantum Resistant Cryptographic Solutions
 *   Public Research and Evaluation License (QRCS-PREL), 2025-2026.
 * - Permission is granted solely for non-commercial evaluation, academic research,
 *   cryptographic analysis, interoperability testing, and feasibility assessment.
 * - Commercial use, production deployment, commercial redistribution, or
 *   integration into products or services is strictly prohibited without a
 *   separate written license agreement executed with QRCS.
 * - Licensing and authorized distribution are solely at the discretion of QRCS.
 *
 * EXPERIMENTAL CRYPTOGRAPHY NOTICE:
 * Portions of this software may include experimental, novel, or evolving
 * cryptographic designs. Use of this software is entirely at the user's risk.
 *
 * DISCLAIMER:
 * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE, SECURITY, OR NON-INFRINGEMENT. QRCS DISCLAIMS ALL
 * LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
 * ARISING FROM THE USE OR MISUSE OF THIS SOFTWARE.
 *
 * FULL LICENSE:
 * This software is subject to the Quantum Resistant Cryptographic Solutions
 * Public Research and Evaluation License (QRCS-PREL), 2025-2026. The complete license terms
 * are provided in the accompanying LICENSE file or at https://www.qrcscorp.ca.
 *
 * Written by: John G. Underhill
 * Contact: contact@qrcscorp.ca
 */
 
#ifndef QSC_OID_H
#define QSC_OID_H
 
#include "qsccommon.h"
#include "asn1.h"
 
QSC_CPLUSPLUS_ENABLED_START


typedef enum qsc_oid_id_t
{
    QSC_OID_ID_NONE = 0,                            
 
    QSC_OID_ID_RSA_ENCRYPTION,                      
    QSC_OID_ID_MD5_WITH_RSA_ENCRYPTION,             
    QSC_OID_ID_SHA1_WITH_RSA_ENCRYPTION,            
    QSC_OID_ID_SHA256_WITH_RSA_ENCRYPTION,          
    QSC_OID_ID_SHA384_WITH_RSA_ENCRYPTION,          
    QSC_OID_ID_SHA512_WITH_RSA_ENCRYPTION,          
 
    QSC_OID_ID_EC_PUBLIC_KEY,                       
    QSC_OID_ID_PRIME256V1,                          
    QSC_OID_ID_SECP384R1,                           
    QSC_OID_ID_SECP521R1,                           
    QSC_OID_ID_ECDSA_WITH_SHA1,                     
    QSC_OID_ID_ECDSA_WITH_SHA256,                   
    QSC_OID_ID_ECDSA_WITH_SHA384,                   
    QSC_OID_ID_ECDSA_WITH_SHA512,                   
 
    QSC_OID_ID_SHA1,                                
    QSC_OID_ID_SHA224,                              
    QSC_OID_ID_SHA256,                              
    QSC_OID_ID_SHA384,                              
    QSC_OID_ID_SHA512,                              
 
    QSC_OID_ID_COMMON_NAME,                         
    QSC_OID_ID_SURNAME,                             
    QSC_OID_ID_SERIAL_NUMBER,                       
    QSC_OID_ID_COUNTRY_NAME,                        
    QSC_OID_ID_LOCALITY_NAME,                       
    QSC_OID_ID_STATE_OR_PROVINCE_NAME,              
    QSC_OID_ID_STREET_ADDRESS,                      
    QSC_OID_ID_ORGANIZATION_NAME,                   
    QSC_OID_ID_ORGANIZATIONAL_UNIT_NAME,            
    QSC_OID_ID_TITLE,                               
    QSC_OID_ID_DESCRIPTION,                         
    QSC_OID_ID_GIVEN_NAME,                          
    QSC_OID_ID_INITIALS,                            
    QSC_OID_ID_GENERATION_QUALIFIER,                
    QSC_OID_ID_DN_QUALIFIER,                        
    QSC_OID_ID_PSEUDONYM,                           
    QSC_OID_ID_DOMAIN_COMPONENT,                    
    QSC_OID_ID_EMAIL_ADDRESS,                       
 
    QSC_OID_ID_SUBJECT_KEY_IDENTIFIER,              
    QSC_OID_ID_KEY_USAGE,                           
    QSC_OID_ID_SUBJECT_ALT_NAME,                    
    QSC_OID_ID_ISSUER_ALT_NAME,                     
    QSC_OID_ID_BASIC_CONSTRAINTS,                   
    QSC_OID_ID_NAME_CONSTRAINTS,                    
    QSC_OID_ID_CRL_DISTRIBUTION_POINTS,             
    QSC_OID_ID_CERTIFICATE_POLICIES,                
    QSC_OID_ID_CRL_NUMBER,                          
    QSC_OID_ID_AUTHORITY_KEY_IDENTIFIER,            
    QSC_OID_ID_EXTENDED_KEY_USAGE,                  
    QSC_OID_ID_AUTHORITY_INFO_ACCESS,               
    QSC_OID_ID_SUBJECT_INFO_ACCESS,                 
 
    QSC_OID_ID_ANY_EXTENDED_KEY_USAGE,              
    QSC_OID_ID_SERVER_AUTH,                         
    QSC_OID_ID_CLIENT_AUTH,                         
    QSC_OID_ID_CODE_SIGNING,                        
    QSC_OID_ID_EMAIL_PROTECTION,                    
    QSC_OID_ID_TIME_STAMPING,                       
    QSC_OID_ID_OCSP_SIGNING,                        
 
    QSC_OID_ID_OCSP,                                
    QSC_OID_ID_CA_ISSUERS,                          
 
    QSC_OID_ID_ML_DSA_44,                           
    QSC_OID_ID_ML_DSA_65,                           
    QSC_OID_ID_ML_DSA_87,                           
 
    QSC_OID_ID_ML_KEM_512,                          
    QSC_OID_ID_ML_KEM_768,                          
    QSC_OID_ID_ML_KEM_1024                          
} qsc_oid_id;

QSC_EXPORT_API typedef struct qsc_oid_entry_t
{
    qsc_oid_id id;                  
    const uint8_t* data;            
    size_t length;                  
    const char* dotted;             
    const char* name;               
} qsc_oid_entry;

QSC_EXPORT_API size_t qsc_oid_registry_count(void);

QSC_EXPORT_API const qsc_oid_entry* qsc_oid_registry_at(size_t index);

QSC_EXPORT_API const qsc_oid_entry* qsc_oid_get_entry(qsc_oid_id id);

QSC_EXPORT_API qsc_oid_id qsc_oid_identify(const qsc_asn1_oid* oid);

QSC_EXPORT_API bool qsc_oid_equals_id(const qsc_asn1_oid* oid, qsc_oid_id id);

QSC_EXPORT_API bool qsc_oid_get_encoded(qsc_oid_id id, const uint8_t** data, size_t* length);

QSC_EXPORT_API bool qsc_oid_to_asn1(qsc_oid_id id, qsc_asn1_oid* oid);

QSC_EXPORT_API const char* qsc_oid_get_dotted(qsc_oid_id id);

QSC_EXPORT_API const char* qsc_oid_get_name(qsc_oid_id id);

QSC_EXPORT_API const char* qsc_oid_get_name_from_oid(const qsc_asn1_oid* oid);
 
QSC_CPLUSPLUS_ENABLED_END
 
#endif