NAME
Net::DRI::Transport::HTTP - HTTP/HTTPS Transport for Net::DRI
DESCRIPTION
This module implements an HTTP/HTTPS stream 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
https_debug https_version https_cert_file https_key_file https_ca_file https_ca_dir
all key materials for https access, if needed
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. (Ex: Net::DRI::Protocol::OpenSRS::XCP::Connection or Net::DRI::Protocol::EPP::Extensions::PL::Connection)
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.
log_fh
(optional) either a reference to something that have a print() method or a filehandle (ex: \*STDERR or an anonymous filehandle) on something already opened for write ; if defined, all exchanges (messages sent to server, messages received from server) will be printed to this filehandle
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/704opensrs_xcp_live.t
local_host
(optional) the local address (hostname or IP) you want to use to connect (if you are multihomed)
trid
(optional) code reference of a subroutine generating transaction id ; if not defined, Net::DRI::Util::create_trid_1 is used
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 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.