Crate psk_client

This is a simple wrapper around the PSK functionality exposed by the openssl crate. PR's to make this more generic, useable and informative (in terms of errors) are more than welcome.

Features

PSK Client has one feature which is openssl-vendored which simply enables the vendored feature on the openssl crate, for further information, see the openssl-rs docs.

Usage

use psk_client::{PskClient, error::PskClientError};
use std::io::Write;
 
fn main() -> Result<(), PskClientError> {
    let client = PskClient::builder("127.0.0.1:4433")
        .reset_ciphers()
        .cipher("PSK-AES128-CBC-SHA")
        .cipher("PSK-AES256-CBC-SHA")
        .identity("Client_identity")
        .key("4836525835726d466c743469426c55356e377375436254566d51476937724932")
        .build()?;
 
    match client.connect() {
        Ok(mut connection) => {
            if let Err(msg) = connection.write_all(b"Hello, World!") {
                eprintln!("Error writing to client: {}", msg);
            }
        }
        Err(e) => eprintln!("{}", e)
    }
 
    Ok(())
}

//! ## Default Ciphers

By default the client will use the following cipher string, this can be cleared by calling reset_ciphers() on a PskClientBuilder. You can supply your own ciphers, either after clearing the pre-defined cipers, or in addition to them by calling cipher("<cipher>") on a PskClientBuilder

+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL

Modules

error

module for error handling.

Structs

PskClient	The PSK client, this contains all the required information to generate and return a connection to a TCP socket over SSL where PSK negotiation has taken place.
PskClientBuilder	The builder for a PSK client, somewhat simplifies creating a new PSK client and makes it more ergonomic.