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/live/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.