StormByte-Crypto 3.1.0
C++26 cryptography module of the StormByte suite
Loading...
Searching...
No Matches
StormByte::Crypto::TLS::Configuration Struct Reference

Mutable input with independent ordered preference lists. More...

#include <StormByte/crypto/tls/policy.hxx>

Collaboration diagram for StormByte::Crypto::TLS::Configuration:

Public Member Functions

 Configuration ()=default
 Construct the mutable default TLS 1.3 profile.
 Configuration (const Configuration &other)=default
 Independently copy the mutable preference lists.
 Configuration (Configuration &&other) noexcept=default
 Transfer the mutable lists, leaving the source lists empty.
 ~Configuration () noexcept=default
 Release the Base-owned preference lists.
Configuration & operator= (const Configuration &other)=default
 Replace the mutable input with independent copies.
Configuration & operator= (Configuration &&other) noexcept=default
 Replace the mutable lists by transferring their ownership.

Public Attributes

Version version = Version::TLS13
 Only TLS 1.3 is accepted.
StormByte::Safe::Vector< CipherSuite > cipher_suites
 Allowed suites in descending preference order.
StormByte::Safe::Vector< Group > groups {Group::X25519, Group::Secp256r1}
 Allowed groups in descending preference order, independent of suites.
StormByte::Safe::Vector< SignatureScheme > signature_schemes
 Allowed signature schemes in descending preference order.

Detailed Description

Mutable input with independent ordered preference lists.

Defaults contain the complete supported profile, preferred entries first (not a security-strength ranking). Subsets and reordering are permitted; validation neither sorts nor inserts fallbacks. Construction and copying can throw Base allocation errors.

Constructor & Destructor Documentation

◆ Configuration() [1/3]

StormByte::Crypto::TLS::Configuration::Configuration ( )
default

Construct the mutable default TLS 1.3 profile.

Exceptions
StormByte::Safe::AllocationErrorPreference storage cannot be allocated.

◆ Configuration() [2/3]

StormByte::Crypto::TLS::Configuration::Configuration ( const Configuration & other)
default

Independently copy the mutable preference lists.

Parameters
otherConfiguration to copy.
Exceptions
StormByte::Safe::AllocationErrorPreference storage cannot be allocated.

◆ Configuration() [3/3]

StormByte::Crypto::TLS::Configuration::Configuration ( Configuration && other)
defaultnoexcept

Transfer the mutable lists, leaving the source lists empty.

Parameters
otherConfiguration to move; requires reconfiguration before validation.

◆ ~Configuration()

StormByte::Crypto::TLS::Configuration::~Configuration ( )
defaultnoexcept

Release the Base-owned preference lists.

Member Function Documentation

◆ operator=() [1/2]

Configuration & StormByte::Crypto::TLS::Configuration::operator= ( Configuration && other)
defaultnoexcept

Replace the mutable lists by transferring their ownership.

Parameters
otherConfiguration to move; its lists are left empty.
Returns
This configuration.

◆ operator=() [2/2]

Configuration & StormByte::Crypto::TLS::Configuration::operator= ( const Configuration & other)
default

Replace the mutable input with independent copies.

Parameters
otherConfiguration to copy.
Returns
This configuration.
Exceptions
StormByte::Safe::AllocationErrorPreference storage cannot be allocated.

Member Data Documentation

◆ cipher_suites

StormByte::Safe::Vector<CipherSuite> StormByte::Crypto::TLS::Configuration::cipher_suites
Initial value:
{
}
@ TLS_AES_256_GCM_SHA384
AES-256-GCM with SHA-384 transcript and HKDF.
Definition policy.hxx:81
@ TLS_AES_128_GCM_SHA256
AES-128-GCM with SHA-256 transcript and HKDF.
Definition policy.hxx:80

Allowed suites in descending preference order.

◆ groups

StormByte::Safe::Vector<Group> StormByte::Crypto::TLS::Configuration::groups {Group::X25519, Group::Secp256r1}

Allowed groups in descending preference order, independent of suites.

◆ signature_schemes

StormByte::Safe::Vector<SignatureScheme> StormByte::Crypto::TLS::Configuration::signature_schemes
Initial value:
{
}
@ ECDSA_SECP256R1_SHA256
P-256 ECDSA/SHA-256.
Definition policy.hxx:98
@ RSA_PSS_RSAE_SHA256
RSA-PSS/SHA-256 with an rsaEncryption certificate key.
Definition policy.hxx:99

Allowed signature schemes in descending preference order.

◆ version

Version StormByte::Crypto::TLS::Configuration::version = Version::TLS13

Only TLS 1.3 is accepted.


The documentation for this struct was generated from the following file: