The peer identity and negotiated-parameter summary exposed by the TLS socket wrapper. More...

#include <tlssocket.h>

Data Fields
char	subject [QSC_X509_NAME_ATTRIBUTE_STRING_MAX]
char	issuer [QSC_X509_NAME_ATTRIBUTE_STRING_MAX]
char	common_name [QSC_X509_NAME_ATTRIBUTE_STRING_MAX]
char	dns_name [QSC_X509_NAME_ATTRIBUTE_STRING_MAX]
qsc_tls_socket_result	result
qsc_tls_cipher_suite	cipher_suite
qsc_tls_named_group	named_group
qsc_tls_signature_scheme	signature_scheme
qsc_x509w_status	x509_status
qsc_x509_verify_status	verify_status
bool	authenticated
bool	hostname_matched
bool	hostname_checked
bool	chain_valid
bool	psk_accepted
bool	early_data_accepted
bool	alpn_selected
char	selected_alpn [QSC_TLS_SOCKET_ALPN_SIZE_MAX+1U]

Detailed Description

The peer identity and negotiated-parameter summary exposed by the TLS socket wrapper.

The negotiated cipher suite, named group, signature scheme, PSK state, and early-data state are populated from the TLS connection state. The subject, issuer, common-name, and DNS-name fields are copied from the bounded peer certificate summary retained by the built-in X.509 bridge. The result field mirrors the last wrapper, TLS, socket, X.509, verification, and alert status values associated with the connection.

Field Documentation

◆ alpn_selected

bool alpn_selected

Indicates whether ALPN selected a mutually supported application protocol.

◆ authenticated

bool authenticated

Indicates whether the peer was authenticated.

◆ chain_valid

bool chain_valid

Indicates whether the peer certificate chain validated.

◆ cipher_suite

qsc_tls_cipher_suite cipher_suite

The negotiated TLS cipher suite.

◆ common_name

char common_name[QSC_X509_NAME_ATTRIBUTE_STRING_MAX]

The peer certificate common name, when available.

◆ dns_name

char dns_name[QSC_X509_NAME_ATTRIBUTE_STRING_MAX]

The matched peer DNS name, when available.

◆ early_data_accepted

bool early_data_accepted

Indicates whether early data was accepted.

◆ hostname_checked

bool hostname_checked

Indicates whether hostname verification was requested.

◆ hostname_matched

bool hostname_matched

Indicates whether hostname verification succeeded.

◆ issuer

char issuer[QSC_X509_NAME_ATTRIBUTE_STRING_MAX]

The peer certificate issuer string, when available.

◆ named_group

qsc_tls_named_group named_group

The negotiated TLS named group.

◆ psk_accepted

bool psk_accepted

Indicates whether PSK resumption was accepted.

◆ result

qsc_tls_socket_result result

The last structured wrapper, TLS, socket, X.509, verification, and alert result.

◆ selected_alpn

char selected_alpn[QSC_TLS_SOCKET_ALPN_SIZE_MAX+1U]

The selected ALPN protocol as a null-terminated string when selected.

◆ signature_scheme

qsc_tls_signature_scheme signature_scheme

The negotiated TLS signature scheme.

◆ subject

char subject[QSC_X509_NAME_ATTRIBUTE_STRING_MAX]

The peer certificate subject string, when available.

◆ verify_status

qsc_x509_verify_status verify_status

The X.509 verification status for the peer certificate.

◆ x509_status

qsc_x509w_status x509_status

The X.509 wrapper status for the peer certificate operation.

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

C:/Users/stepp/Documents/Visual Studio 2022/Projects/C/QSC/QSC/tlssocket.h

Data Fields