MastersThesis/PQ_TIIGER_TLS/include/tls_x509.h

/*
* JS update 14.04.2024
* Upravenie definovanych kriviek
* Pridane krivky pre algoritmy ML-KEM a ML-DSA
* Testovane s novou verziou liboqs 0.10.0
*/

/*
* JS update 29.02.2024
* Definovanie "novych" kriviek na rozlisenie pouzitych PQ algoritmov
*/

/**
 * @file tls_x509.h
 * @author Mike Scott
 * @brief X509 function Header File
 *
 * defines structures
 * declares functions
 *
 */

#ifndef TLS_X509_H
#define TLS_X509_H

// Supported Encryption Methods

#define X509_ECC 1      /**< Elliptic Curve data type detected */
#define X509_RSA 2      /**< RSA data type detected */
#define X509_ECD 3      /**< Elliptic Curve (Ed25519) detected */
#define X509_PQ 4       /**< Post Quantum method */
#define X509_HY 5       /**< Hybrid Post_Quantum */

// Supported Hash functions

#define X509_H256 2     /**< SHA256 hash algorithm used */
#define X509_H384 3     /**< SHA384 hash algorithm used */
#define X509_H512 4     /**< SHA512 hash algorithm used */
#define X509_SHAKE256 5 /**< SHA3 SHAKE256 algorithm used */

#define X509_MLKEM 98
#define X509_MLDSA 99

// Supported Curves

#define USE_NIST256 0    /**< For the NIST 256-bit standard curve - WEIERSTRASS only */
#define USE_ED25519 1     /**< Bernstein's Modulus 2^255-19 - EDWARDS */
#define USE_ED448 4     /**< Goldilocks Modulus Ed448 - EDWARDS */
//#define USE_BRAINPOOL 2  /**< For Brainpool 256-bit curve - WEIERSTRASS only */
//#define USE_ANSSI 3      /**< For French 256-bit standard curve - WEIERSTRASS only */
#define USE_NIST384 10   /**< For the NIST 384-bit standard curve - WEIERSTRASS only */
#define USE_NIST521 12   /**< For the NIST 521-bit standard curve - WEIERSTRASS only */

// JS update
// Definovanie curve hodnoty pre rozne PQ algoritmy
#define USE_DILITHIUM2 100
#define USE_DILITHIUM3 101
#define USE_DILITHIUM5 102
#define USE_MLDSA44 103
#define USE_MLDSA65 104
#define USE_MLDSA87 105
#define USE_FALCON512 106
#define USE_FALCON1024 107
#define USE_SPHINCSSHA2128FSIMPLE 108
#define USE_SPHINCSSHA2128SSIMPLE 109
#define USE_SPHINCSSHAKE128FSIMPLE 110
#define USE_SPHINCSSHA2192FSIMPLE 111

extern octad X509_CN;  /**< Country Name */
extern octad X509_ON;  /**< organisation Name */
extern octad X509_EN;  /**< email */
extern octad X509_LN;  /**< local name */
extern octad X509_UN;  /**< Unit name (aka Organisation Unit OU) */
extern octad X509_MN;  /**< My Name (aka Common Name) */
extern octad X509_SN;  /**< State Name */

extern octad X509_AN;  /**< Alternate Name */
extern octad X509_KU;  /**< Key Usage */
extern octad X509_BC;  /**< Basic Constraints */

/**
 * @brief Public key type
 */
typedef struct
{
    int type;  /**< signature type (ECC or RSA) */
    int hash;  /**< hash type */
    int curve; /**< elliptic curve used or RSA key length in bits  */
} pktype;


/** @brief in-place ECDSA signature encoding
 *
    @param c an ecdsa signature to be converted from r|s form to ASN.1
*/
extern void ecdsa_sig_encode(octad *c);

/** @brief in-place ECDSA signature decoding
 *
    @param c an ecdsa signature to be converted from ASN.1 to simple r|s form
    @return index into c where conversion ended
*/
extern int ecdsa_sig_decode(octad *c);

/* X.509 functions */

/** @brief Extract private key
 *
    @param c an X.509 private key 
    @param pk the extracted private key - for RSA octad = p|q|dp|dq|c, for ECC octad = k
    @return 0 on failure, or indicator of private key type (ECC or RSA)
*/
extern pktype X509_extract_private_key(octad *c,octad *pk);

/** @brief Extract certificate signature
 *
    @param c an X.509 certificate
    @param s the extracted signature
    @return 0 on failure, or indicator of signature type (ECC or RSA)

*/
extern pktype X509_extract_cert_sig(octad *c, octad *s);
/** @brief
 *
    @param sc a signed certificate
    @param c the extracted certificate
    @return 0 on failure
*/
extern int X509_extract_cert(octad *sc, octad *c);

/** @brief
 *
    @param c an X.509 certificate
    @param ptr pointer to ASN.1 raw public key
    @return length of raw public key
*/
extern int X509_find_public_key(octad *c,int *ptr);

/** @brief
 *
    @param c an ASN.1 encoded public key
    @param key the extracted public key
    @return indicator of public key type (ECC or RSA)
*/
extern pktype X509_get_public_key(octad *c,octad *key);


/** @brief
 *
    @param c an X.509 certificate
    @param k the extracted key
    @return 0 on failure, or indicator of public key type (ECC or RSA)
*/
extern pktype X509_extract_public_key(octad *c, octad *k);
/** @brief
 *
    @param c an X.509 certificate
    @param len length of issuer field
    @return 0 on failure, or pointer to issuer field in cert
*/
extern int X509_find_issuer(octad *c,int *len);
/** @brief
 *
    @param c an X.509 certificate
    @return 0 on failure, or pointer to validity field in cert
*/
extern int X509_find_validity(octad *c);
/** @brief
 *
    @param c an X.509 certificate
    @param len length of suject field
    @return 0 on failure, or pointer to subject field in cert
*/
extern int X509_find_subject(octad *c,int *len);

/** @brief
 *
    @param c an X.509 certificate
    @return true if self-signed, else false
*/
extern int X509_self_signed(octad *c);

/** @brief
 *
    @param c an X.509 certificate
    @param S is OID of property we are looking for
    @param s is a pointer to the section of interest in the cert
    @param f is pointer to the length of the property
    @return 0 on failure, or pointer to the property
*/
extern int X509_find_entity_property(octad *c, octad *S, int s, int *f);
/** @brief
 *
    @param c an X.509 certificate
    @param s is a pointer to the start of the validity field
    @return 0 on failure, or pointer to the start date
*/
extern int X509_find_start_date(octad *c, int s);
/** @brief
 *
    @param c an X.509 certificate
    @param s is a pointer to the start of the validity field
    @return 0 on failure, or pointer to the expiry date
*/
extern int X509_find_expiry_date(octad *c, int s);

/** @brief
 *
    @param c an X.509 certificate
    @return 0 on failure (or no extensions), or pointer to extensions field in cert
*/
extern int X509_find_extensions(octad *c);
/** @brief
 *
    @param c an X.509 certificate
    @param S is OID of particular extension we are looking for
    @param s is a pointer to the section of interest in the cert
    @param f is pointer to the length of the extension
    @return 0 on failure, or pointer to the extension
*/
extern int X509_find_extension(octad *c, octad *S, int s, int *f);

/** @brief
 *
    @param c an X.509 certificate
    @param s is a pointer to certificate extension SubjectAltNames
    @param name is a URL
    @return 0 on failure, 1 if URL is in list of alt names
*/
extern int X509_find_alt_name(octad *c,int s,char *name);

#endif