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