server.h

Go to the documentation of this file.

/* 2025 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 within this implementation 
 * are proprietary to QRCS and its authorized licensors and are protected under 
 * applicable U.S. and international copyright, patent, and trade secret laws.
 *
 * CRYPTOGRAPHIC STANDARDS:
 * - This software includes implementations of cryptographic algorithms such as 
 *   SHA3, AES, and others. These algorithms are public domain or standardized 
 *   by organizations such as NIST and are NOT the property of QRCS.
 * - However, all source code, optimizations, and implementations in this library 
 *   are original works of QRCS and are protected under this license.
 *
 * RESTRICTIONS:
 * - Redistribution, modification, or unauthorized distribution of this software, 
 *   in whole or in part, is strictly prohibited.
 * - This software is provided for non-commercial, educational, and research 
 *   purposes only. Commercial use in any form is expressly forbidden.
 * - Licensing and authorized distribution are solely at the discretion of QRCS.
 * - Any use of this software implies acceptance of these restrictions.
 *
 * DISCLAIMER:
 * This software is provided "as is," without warranty of any kind, express or 
 * implied, including but not limited to warranties of merchantability or fitness 
 * for a particular purpose. QRCS disclaims all liability for any direct, indirect, 
 * incidental, or consequential damages resulting from the use or misuse of this software.
 *
 * FULL LICENSE:
 * This software is subject to the **Quantum Resistant Cryptographic Solutions 
 * Proprietary License (QRCS-PL)**. The complete license terms are included 
 * in the LICENSE.txt file distributed with this software.
 *
 * Written by: John G. Underhill
 * Contact: john.underhill@protonmail.com
 */
 
#ifndef MPDC_SERVER_H
#define MPDC_SERVER_H
 
#include "common.h"
#include "certificate.h"
#include "commands.h"
#include "logger.h"
#include "mpdc.h"
#include "topology.h"
#include "../../QSC/QSC/collection.h"

 
/*---------------------------------------------------------------------------
  MACRO DEFINITIONS
---------------------------------------------------------------------------*/

#define MPDC_SERVER_MINIMUM_COMMAND_LENGTH 4

#define MPDC_SERVER_APPLICATION_STATE_SIZE (MPDC_STORAGE_DOMAINNAME_MAX + MPDC_STORAGE_HOSTNAME_MAX + \
    MPDC_STORAGE_ADDRESS_MAX + MPDC_STORAGE_PATH_MAX + MPDC_STORAGE_USERNAME_MAX + MPDC_CERTIFICATE_ISSUER_SIZE + \
    sizeof(uint16_t) + sizeof(uint8_t) + sizeof(uint8_t) + sizeof(uint16_t) + sizeof(bool) + sizeof(bool) + \
    MPDC_ASYMMETRIC_SIGNING_KEY_SIZE)
 
/*---------------------------------------------------------------------------
  ENUMERATIONS
---------------------------------------------------------------------------*/

MPDC_EXPORT_API typedef enum mpdc_server_server_loop_status
{
    mpdc_server_loop_status_stopped = 0x00,      
    mpdc_server_loop_status_started = 0x01,      
    mpdc_server_loop_status_paused  = 0x02,      
} mpdc_server_server_loop_status;
 
/*---------------------------------------------------------------------------
  DATA STRUCTURES
---------------------------------------------------------------------------*/

MPDC_EXPORT_API typedef struct mpdc_server_application_state
{
    char cmdprompt[MPDC_STORAGE_PROMPT_MAX];          
    char domain[MPDC_STORAGE_DOMAINNAME_MAX];         
    char hostname[MPDC_STORAGE_HOSTNAME_MAX];         
    char issuer[MPDC_CERTIFICATE_ISSUER_SIZE];         
    char localip[MPDC_STORAGE_ADDRESS_MAX];           
    char logpath[MPDC_STORAGE_PATH_MAX];              
    char username[MPDC_STORAGE_USERNAME_MAX];         
    uint8_t* kchain;                                  
    uint8_t* sigkey;                                  
    const char* aplpath;                              
    const char* banner;                               
    const char* cfgname;                              
    const char* prikeyname;                           
    const char* promptdef;                            
    const char* pubkeyname;                           
    const char* srvname;                              
    const char* topname;                              
    const char* wtitle;                               
    mpdc_child_certificate dla;                       
    mpdc_root_certificate root;                       
    mpdc_topology_list_state tlist;                   
    mpdc_command_actions action;                      
    mpdc_console_modes mode;                          
    uint16_t port;                                    
    mpdc_network_designations srvtype;               
    uint16_t timeout;                                 
    uint8_t retries;                                  
    bool joined;                                      
    bool loghost;                                     
} mpdc_server_application_state;
 
/*---------------------------------------------------------------------------
  FUNCTION PROTOTYPES
---------------------------------------------------------------------------*/

MPDC_EXPORT_API void mpdc_server_certificate_directory(const mpdc_server_application_state* state, char* dpath, size_t pathlen);

MPDC_EXPORT_API void mpdc_server_certificate_path(const mpdc_server_application_state* state, char* fpath, size_t pathlen, const char* issuer);

MPDC_EXPORT_API bool mpdc_server_child_certificate_export(const mpdc_server_application_state* state, const char* dpath);

MPDC_EXPORT_API bool mpdc_server_child_certificate_from_issuer(mpdc_child_certificate* ccert, const mpdc_server_application_state* state, const char* issuer);

MPDC_EXPORT_API bool mpdc_server_child_certificate_from_serial(mpdc_child_certificate* ccert, const mpdc_server_application_state* state, const uint8_t* serial);

MPDC_EXPORT_API void mpdc_server_child_certificate_generate(mpdc_server_application_state* state, mpdc_child_certificate* ccert, uint64_t period);

MPDC_EXPORT_API bool mpdc_server_child_certificate_import(mpdc_child_certificate* lcert, mpdc_server_application_state* state, const char* fpath);

MPDC_EXPORT_API void mpdc_server_child_certificate_path(const mpdc_server_application_state* state, char* fpath, size_t pathlen);

MPDC_EXPORT_API void mpdc_server_child_certificate_path_from_issuer(const mpdc_server_application_state* state, char* fpath, size_t pathlen, const char* issuer);

MPDC_EXPORT_API bool mpdc_server_child_certificate_print(const char* fpath, size_t pathlen);

MPDC_EXPORT_API void mpdc_server_local_certificate_store(mpdc_server_application_state* state, const mpdc_child_certificate* ccert, const char* address);

MPDC_EXPORT_API void mpdc_server_clear_config(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_clear_log(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_erase_all(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_log_host(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_log_print(mpdc_server_application_state* state);

MPDC_EXPORT_API bool mpdc_server_log_write_message(mpdc_server_application_state* state, mpdc_application_messages msgtype, const char* message, size_t msglen);

MPDC_EXPORT_API void mpdc_server_mfkcol_path(const mpdc_server_application_state* state, char* fpath, size_t pathlen);

MPDC_EXPORT_API bool mpdc_server_mfkcol_from_file(qsc_collection_state* mfkcol, const mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_mfkcol_to_file(const qsc_collection_state* mfkcol, const mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_print_banner(const mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_print_error(const mpdc_server_application_state* state, mpdc_application_messages appmsg, const char* message, mpdc_protocol_errors error);

MPDC_EXPORT_API void mpdc_server_print_configuration(const mpdc_server_application_state* state);

MPDC_EXPORT_API bool mpdc_server_root_certificate_export(const mpdc_server_application_state* state, const char* dpath);

MPDC_EXPORT_API bool mpdc_server_root_import_dialogue(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_root_certificate_generate(mpdc_server_application_state* state, mpdc_root_certificate* rcert, uint64_t period);

MPDC_EXPORT_API bool mpdc_server_root_certificate_load(const mpdc_server_application_state* state, mpdc_root_certificate* root, const mpdc_topology_list_state* tlist);

MPDC_EXPORT_API bool mpdc_server_root_certificate_print(const char* fpath, size_t pathlen);

MPDC_EXPORT_API void mpdc_server_root_certificate_store(mpdc_server_application_state* state, const mpdc_root_certificate* rcert);

MPDC_EXPORT_API void mpdc_server_set_command_prompt(mpdc_server_application_state* state);

MPDC_EXPORT_API bool mpdc_server_set_console_timeout(mpdc_server_application_state* state, const char* snum, size_t numlen);

MPDC_EXPORT_API bool mpdc_server_set_domain_name(mpdc_server_application_state* state, const char* name, size_t namelen);

MPDC_EXPORT_API bool mpdc_server_set_host_name(mpdc_server_application_state* state, const char* name, size_t namelen);

MPDC_EXPORT_API bool mpdc_server_set_ip_address(mpdc_server_application_state* state, const char* address, size_t addlen);

MPDC_EXPORT_API bool mpdc_server_set_password_retries(mpdc_server_application_state* state, const char* snum, size_t numlen);

MPDC_EXPORT_API void mpdc_server_erase_signature_key(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_state_backup_restore(const mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_state_backup_save(const mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_state_initialize(mpdc_server_application_state* state, mpdc_network_designations srvtype);

MPDC_EXPORT_API bool mpdc_server_state_store(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_state_unload(mpdc_server_application_state* state);

MPDC_EXPORT_API bool mpdc_server_topology_dla_fetch(const mpdc_server_application_state* state, mpdc_child_certificate* dcert);

MPDC_EXPORT_API bool mpdc_server_topology_load(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_topology_print_list(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_topology_purge_externals(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_topology_remove_certificate(mpdc_server_application_state* state, const char* issuer);

MPDC_EXPORT_API void mpdc_server_topology_remove_node(mpdc_server_application_state* state, const char* issuer);

MPDC_EXPORT_API void mpdc_server_topology_reset(mpdc_server_application_state* state);

MPDC_EXPORT_API bool mpdc_server_topology_local_fetch(const mpdc_server_application_state* state, mpdc_child_certificate* ccert);

MPDC_EXPORT_API bool mpdc_server_topology_root_exists(const mpdc_server_application_state* state);

MPDC_EXPORT_API bool mpdc_server_topology_root_fetch(const mpdc_server_application_state* state, mpdc_root_certificate* rcert);

MPDC_EXPORT_API void mpdc_server_topology_to_file(mpdc_server_application_state* state);

MPDC_EXPORT_API bool mpdc_server_user_login(mpdc_server_application_state* state);

MPDC_EXPORT_API void mpdc_server_user_logout(mpdc_server_application_state* state);
 
#endif