The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Net::DRI::Transport::HTTP - HTTP/HTTPS Transport for Net::DRI

DESCRIPTION

This module implements an HTTP/HTTPS transport for establishing connections in Net::DRI

METHODS

At creation (see Net::DRI new_profile) you pass a reference to an hash, with the following available keys:

timeout

time to wait (in seconds) for server reply

ssl_key_file ssl_cert_file ssl_ca_file ssl_ca_path ssl_cipher_list ssl_version ssl_passwd_cb

if remote_url begins with https://, all key materials, see IO::Socket::SSL documentation for corresponding options

ssl_verify

see IO::Socket::SSL documentation about verify_mode (by default 0x00 here)

ssl_verify_callback

see IO::Socket::SSL documentation about verify_callback, it gets here as first parameter the transport object then all parameter given by IO::Socket::SSL; it is explicitly verified that the subroutine returns a true value, and if not the connection is aborted.

remote_url

URL to access

client_login client_password

protocol login & password

client_newpassword

(optional) new password if you want to change password on login for registries handling that at connection

protocol_connection

Net::DRI class handling protocol connection details. Specifying it should not be needed, as the registry driver should have correct default values.

protocol_data

(optional) opaque data given to protocol_connection class. For EPP, a key login_service_filter may exist, whose value is a code ref. It will be given an array of services, and should give back a similar array; it can be used to filter out some services from those given by the registry.

verify_response

(optional) a callback (code ref) executed after each exchange with the registry, being called with the following parameters: the transport object, the phase (1 for greeting+login, 2 for all normal operations, 3 for logout), the count (if we retried multiple times to send the same message), the message sent (HTTP::Request object) and the response received (HTTP::Response object). This can be used to verify/diagnose SSL details, see example in file t/remote/opensrs_xcp.t

local_host

(optional) the local address (hostname or IP) you want to use to connect (if you are multihomed)

SUPPORT

For now, support questions should be sent to:

<netdri@dotandco.com>

Please also see the SUPPORT file in the distribution.

SEE ALSO

<http://www.dotandco.com/services/software/Net-DRI/>

AUTHOR

Patrick Mevzek, <netdri@dotandco.com>

COPYRIGHT

Copyright (c) 2008-2011,2013,2015 Patrick Mevzek <netdri@dotandco.com>. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

See the LICENSE file that comes with this distribution for more details.