1# Copyright (c) 2000-2004 Chris Ridd <chris.ridd@isode.com> and 2# Graham Barr <gbarr@pobox.com>. All rights reserved. This program is 3# free software; you can redistribute it and/or modify it under the 4# same terms as Perl itself. 5 6package Net::LDAPS; 7@Net::LDAPS::ISA = ( 'Net::LDAP' ); 8$Net::LDAPS::VERSION = "0.05"; 9 10use strict; 11use Net::LDAP; 12 13sub new { 14 shift->SUPER::new(@_, scheme => 'ldaps'); 15} 16 171; 18 19__END__ 20 21=head1 NAME 22 23Net::LDAPS - use LDAP over an SSL connection 24 25=head1 SYNOPSIS 26 27 use Net::LDAPS; 28 29 $ldaps = Net::LDAPS->new('myhost.example.com', 30 port => '10000', 31 verify => 'require', 32 capath => '/usr/local/cacerts/'); 33 34 # alternate way 35 use Net::LDAP; 36 37 $ldaps = Net::LDAP->new('ldaps://myhost.example.com:10000', 38 verify => 'require', 39 capath => '/usr/local/cacerts/'); 40 41=head1 DESCRIPTION 42 43Communicate using the LDAP protocol to a directory server using an 44encrypted (SSL) network connection. This mechanism is non-standard but 45widely supported; consider using LDAPv3 with the standard TLS 46extension if possible (many servers do not support it yet.) See 47L<Net::LDAP/start_tls>. 48 49All the normal C<Net::LDAP> methods can be used with a C<Net::LDAPS> 50object; see L<Net::LDAP> for details. 51 52=head1 CONSTRUCTOR 53 54=over 4 55 56=item new ( HOST [, OPTIONS ] ) 57 58Create a new connection. HOST is the hostname to contact. OPTIONS is a 59number of key/value pairs. See L<Net::LDAP/new> for details. 60 61=back 62 63=head1 SEE ALSO 64 65L<Net::LDAP>, 66L<IO::Socket::SSL> 67 68=head1 BUGS 69 70You cannot have more than one LDAPS connection at any one time, due to 71restrictions in the underlying Net::SSLeay code. 72 73=head1 AUTHOR 74 75Chris Ridd E<lt>chris.ridd@isode.comE<gt> 76 77=head1 COPYRIGHT 78 79Copyright (c) 2000-2004, Chris Ridd and Graham Barr. All rights reserved. This 80library is free software; you can redistribute it and/or modify 81it under the same terms as Perl itself. 82 83=cut 84 85