Struct FingerprintBuilder

pub struct FingerprintBuilder { /* private fields */ }

A builder for constructing a Fingerprint with customizable configurations. The builder allows specific aspects of the TLS fingerprint to be overridden, ensuring that the final crate::ClientConfig and ClientHello align with desired specifications or testing conditions.

Implementations

impl FingerprintBuilder

pub fn do_not_override_alpn(self) -> Self

Disables the overriding of the ALPN settings. Use this option when working with HTTP clients, such as hyper, that internally manage ALPN settings; they may raise issues if ALPN is set externally. While this option skips setting ALPN, it still validates the ALPN during TLS handshakes against expected values. Non-compliance will lead to a panic, ensuring adherence to the specified ALPN requirements.

pub fn dangerous_disable_override_keyshare(self) -> Self

Disables the override of key share configurations. Intended only for testing purposes, this option allows the default key share behavior to be used, bypassing the key share settings specified in the Fingerprint. This can help in testing scenarios where non-standard key share configurations are to be evaluated or default behavior is required.

pub fn dangerous_disable_override_suite(self) -> Self

Disables the override of cipher suites. Intended only for testing purposes

pub fn dangerous_craft_test_mode(self) -> Self

Enters a craftls test mode that disables various overrides and strict checking against the Fingerprint. This mode is intended for testing and should be used with caution as it relaxes the constraints normally enforced by the builder, potentially allowing configurations that deviate from the specified Fingerprint. This can be useful for testing how the system behaves under non-standard or unexpected configurations.

Trait Implementations

impl Clone for FingerprintBuilder

fn clone(&self) -> FingerprintBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FingerprintBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.