The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

POE::Component::Server::NRPE::SSLify - Makes using NRPE SSL in the world of POE easy!

SYNOPSIS

        # Import the module
        use POE::Component::Server::NRPE::SSLify qw( Server_SSLify SSLify_Initialise);

        eval { SSLify_Initialise(); };
        if ( $@ ) {
                # Unable to initialise the SSL CTX
        }

        # Create a normal SocketFactory wheel or something
        my $factory = POE::Wheel::SocketFactory->new( ... );

        # Converts the socket into a SSL socket POE can communicate with
        eval { $socket = Server_SSLify( $socket ) };
        if ( $@ ) {
                # Unable to SSLify it...
        }

        # Now, hand it off to ReadWrite
        my $rw = POE::Wheel::ReadWrite->new(
                Handle  =>      $socket,
                ...
        );

        # Use it as you wish...

ABSTRACT

        Makes NRPE SSL use in POE a breeze!

DESCRIPTION

This is a hack of POE::Component::SSLify to support NRPE's SSL negotitation which uses TLSv1 and DH ciphers.

FUNCTIONS

SSLify_Initialise

        Initialises the server-side CTX by loading the NRPE Diffie-Hellman Parameters.

Server_SSLify

        Accepts a socket, returns a brand new socket SSLified

        NOTE: SSLify_Initialise must be set first!

BUGS

On Win32 platforms SSL support is pretty shaky, please help me out with detailed error descriptions if it happens to you!

SEE ALSO

POE

POE::Component::SSLify

Net::SSLeay

AUTHOR

Apocalypse <apocal@cpan.org>

PROPS

        Original code is entirely Rocco Caputo ( Creator of POE ) -> I simply
        packaged up the code into something everyone could use and accepted the burden
        of maintaining it :)

        From the PoCo::Client::HTTP code =]
        # TODO - This code should probably become a POE::Kernel method,
        # seeing as it's rather baroque and potentially useful in a number
        # of places.

        Big thanks to Florian Ragwitz for his help and advice the minefield that is
        OpenSSL.

COPYRIGHT AND LICENSE

Copyright 2007 by Apocalypse/Rocco Caputo

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.