NAME

Connector::Proxy::SOAP::Lite

DESCRIPTION

Make a SOAP call using the SOAP::Lite package. Use get if your SOAP call expects a scalar result or get_hash for a hashref. get_meta, get_list and set methods are not supported yet.

USAGE

minimal setup

  Connector::Proxy::SOAP::Lite->new({
    LOCATION => 'https://127.0.0.1/soap',
    uri => 'http://schema.company.org/SOAP/Endpoint',
    method => 'GetInfo'
  });

additional options

do_not_use_charset

Boolean, sets $SOAP::Constants::DO_NOT_USE_CHARSET = 1;

use_microsoft_dot_net_compatible_separator

Boolean, set the parameter seperator to "/" (forward slash)

named_parameters

By default, the passed arguments are used as postional arguments in the soap call. If you want to use a named parameter, set this to a list of names used as keys with the passed parameters. If you pass a string, it is split into a list a the whitespace character (usefull with Config::Std, etc).

attrmap

Optional, if set keys of the returned hash are mapped from the given hash. Keys must be the names of the SOAP response fields, values are the names of the keys in the connector response. Can be used with get to extract a single field from the response, must contain one element, value is ignored.

SSL support

This connector supports client authentication using certificates.

use_net_ssl

Set this to a true value to use Net::SSL as backend library (otherwise IO::Socket::SSL is used). Be aware the Net::SSL does not check the hostname of the server certificate so Man-in-the-Middle-Attacks might be possible. You should use this only with a really good reason or if you need support for PKCS12 containers.

ssl_ignore_hostname

Do not validate the hostname of the server certificate (only useful with IO::Socket::SSL as Net::SSL does not check the hostname at all).

certificate_file

Path to a PEM encoded certificate file.

certificate_key_file

Path to a PEM encoded key file.

certificate_p12_file

Path to a PKCS12 container file. This is only supported by Net:SSL and can not be used together with certificate_file/certificate_key_file.

certificate_key_password

The plain password of your encrypted key or PKCS12 container. Note that Net::SSL does not support password protected keys. You need to use a PKCS12 container instead! Leave this empty if your key is not protected by a password.

ca_certificate_path

Path to a directory with trusted certificates (with openssl hashed names). Also used to validate the server certificate even if no client authentication is used.

ca_certificate_file

Same as ca_certificate_path pointing to a single file.