NAME

Munin::Node::TLS - Abstract base class implementing the STARTTLS protocol

SYNOPSIS

Should not be called directly. See synopsis for Munin::Common::TLSServer and Munin::Common::TLSClient.

METHODS

new

my $tls = Munin::Common::TLSFoo->new({ # Substitute Foo with Client or Server
    # Mandatory attributes:  
    logger      => \&a_logger_func,
    read_fd     => fileno($socket),
    read_func   => \&a_socket_read_func,
    write_fd    => fileno($socket),
    write_func  => \&a_socket_read_func,
    # Optional attributes                          DEFAULTS
    DEBUG              => 0,                       # 0
    tls_ca_cert        => "path/to/ca/cert.pem",   # ''
    tls_cert           => "path/to/cert.pem",      # ''
    tls_paranoia       => 1,                       # 0
    tls_priv           => "path/to/priv_key.pem",  # ''
    tls_vdepth         => 5,                       # 0
    tls_verify         => 1,                       # 0
});

Constructor. Should not be called directly. This documents the attributes that are in common for Munin::Common::TLSServer and Munin::Common::TLSClient.

read

my $msg = $tls->read();

Encrypted read.

write

$tls->write($msg);

Encrypted write.

session_started

my $bool = $tls->session_started();

Returns true if the TLS object is ready to read/write encrypted data.