mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-01 06:35:42 +00:00
381 lines
8.9 KiB
Perl
381 lines
8.9 KiB
Perl
#############################################################################
|
|
# $Id: Utils.pm,v 1.11 1999/01/21 23:52:43 leif%netscape.com Exp $
|
|
#
|
|
# The contents of this file are subject to the Mozilla Public License
|
|
# Version 1.0 (the "License"); you may not use this file except in
|
|
# compliance with the License. You may obtain a copy of the License at
|
|
# http://www.mozilla.org/MPL/
|
|
#
|
|
# Software distributed under the License is distributed on an "AS IS"
|
|
# basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing rights and limitations
|
|
# under the License.
|
|
#
|
|
# The Original Code is PerLDAP. The Initial Developer of the Original
|
|
# Code is Netscape Communications Corp. and Clayton Donley. Portions
|
|
# created by Netscape are Copyright (C) Netscape Communications
|
|
# Corp., portions created by Clayton Donley are Copyright (C) Clayton
|
|
# Donley. All Rights Reserved.
|
|
#
|
|
# Contributor(s):
|
|
#
|
|
# DESCRIPTION
|
|
# Lots of Useful Little Utilities, for LDAP related operations.
|
|
#
|
|
#############################################################################
|
|
|
|
package Mozilla::LDAP::Utils;
|
|
|
|
use Mozilla::LDAP::API qw(:constant);
|
|
use Mozilla::LDAP::Conn;
|
|
use vars qw(@ISA %EXPORT_TAGS);
|
|
|
|
require Exporter;
|
|
|
|
@ISA = qw(Exporter);
|
|
%EXPORT_TAGS = (
|
|
all => [qw(normalizeDN
|
|
isUrl
|
|
printEntry
|
|
printentry
|
|
encodeBase64
|
|
decodeBase64
|
|
str2Scope
|
|
askPassword
|
|
ldapArgs
|
|
unixCrypt
|
|
userCredentials
|
|
answer)]
|
|
);
|
|
|
|
|
|
# Add Everything in %EXPORT_TAGS to @EXPORT_OK
|
|
Exporter::export_ok_tags('all');
|
|
|
|
|
|
#############################################################################
|
|
# Normalize the DN string (first argument), and return the new, normalized,
|
|
# string (DN). This is useful to make sure that two syntactically
|
|
# identical DNs compare (eq) as the same string.
|
|
#
|
|
sub normalizeDN
|
|
{
|
|
my ($dn) = @_;
|
|
my (@vals);
|
|
|
|
return "" unless (defined($dn) && ($dn ne ""));
|
|
|
|
@vals = Mozilla::LDAP::API::ldap_explode_dn(lc $dn, 0);
|
|
|
|
return join(",", @vals);
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Checks if a string is a properly formed LDAP URL.
|
|
#
|
|
sub isURL
|
|
{
|
|
return ldap_is_ldap_url($_[0]);
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Print an entry, in LDIF format. This is sort of obsolete, we encourage
|
|
# you to use the :;LDAP::LDIF class instead.
|
|
#
|
|
sub printEntry
|
|
{
|
|
my $entry = $_[0];
|
|
my $attr;
|
|
local $_;
|
|
|
|
print "dn: ", $entry->{"dn"},"\n";
|
|
foreach $attr (@{$entry->{"_oc_order_"}})
|
|
{
|
|
next if ($attr =~ /^_.+_$/);
|
|
next if $entry->{"_${attr}_deleted_"};
|
|
foreach (@{$entry->{$attr}})
|
|
{
|
|
print "$attr: $_\n";
|
|
}
|
|
}
|
|
|
|
print "\n";
|
|
}
|
|
*printentry = \*printEntry;
|
|
|
|
|
|
#############################################################################
|
|
# Perform Base64 encoding, this is based on MIME::Base64.pm, written
|
|
# by Gisle Aas <gisle@aas.no>. If possible, use the MIME:: package instead.
|
|
#
|
|
sub encodeBase64
|
|
{
|
|
my $res = "";
|
|
my $eol = "$_[1]";
|
|
my $padding;
|
|
|
|
pos($_[0]) = 0; # ensure start at the beginning
|
|
while ($_[0] =~ /(.{1,45})/gs) {
|
|
$res .= substr(pack('u', $1), 1);
|
|
chop($res);
|
|
}
|
|
|
|
$res =~ tr|` -_|AA-Za-z0-9+/|; # `# help emacs
|
|
$padding = (3 - length($_[0]) % 3) % 3;
|
|
$res =~ s/.{$padding}$/'=' x $padding/e if $padding;
|
|
|
|
if (length $eol) {
|
|
$res =~ s/(.{1,76})/$1$eol/g;
|
|
}
|
|
|
|
return $res;
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Perform Base64 decoding, this is based on MIME::Base64.pm, written
|
|
# by Gisle Aas <gisle@aas.no>. If possible, use the MIME:: package instead.
|
|
#
|
|
sub decodeBase64
|
|
{
|
|
my $str = shift;
|
|
my $res = "";
|
|
my $len;
|
|
|
|
$str =~ tr|A-Za-z0-9+=/||cd;
|
|
Carp::croak("Base64 decoder requires string length to be a multiple of 4")
|
|
if length($str) % 4;
|
|
|
|
$str =~ s/=+$//; # remove padding
|
|
$str =~ tr|A-Za-z0-9+/| -_|; # convert to uuencoded format
|
|
while ($str =~ /(.{1,60})/gs)
|
|
{
|
|
$len = chr(32 + length($1)*3/4);
|
|
$res .= unpack("u", $len . $1 ); # uudecode
|
|
}
|
|
|
|
return $res;
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Convert a "human" readable string to an LDAP scope value
|
|
#
|
|
sub str2Scope
|
|
{
|
|
my $str = $_[0];
|
|
|
|
return $str if ($str =~ /^[0-9]+$/);
|
|
|
|
if ($str =~ /^sub/i)
|
|
{
|
|
return LDAP_SCOPE_SUBTREE;
|
|
}
|
|
elsif ($str =~ /^base/i)
|
|
{
|
|
return LDAP_SCOPE_BASE;
|
|
}
|
|
elsif ($str =~ /^one/i)
|
|
{
|
|
return LDAP_SCOPE_ONELEVEL;
|
|
}
|
|
|
|
# Default...
|
|
return LDAP_SCOPE_SUBTREE;
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Ask for a password, without displaying it on the TTY.
|
|
#
|
|
sub askPassword
|
|
{
|
|
my $prompt = $_[0];
|
|
my $hasReadKey = 0;
|
|
|
|
eval "use Term::ReadKey";
|
|
$hasReadKey=1 unless ($@);
|
|
|
|
print "LDAP password: " if $prompt;
|
|
if ($hasReadKey)
|
|
{
|
|
ReadMode(2);
|
|
chop($_ = ReadLine(0));
|
|
ReadMode(0);
|
|
}
|
|
else
|
|
{
|
|
system('/bin/stty -echo');
|
|
chop($_ = <STDIN>);
|
|
system('/bin/stty echo');
|
|
}
|
|
print "\n";
|
|
|
|
return $_;
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Handle some standard LDAP options, and construct a nice little structure
|
|
# that we can use later on. We really should have some appropriate defaults,
|
|
# perhaps from an Mozilla::LDAP::Config module.
|
|
#
|
|
sub ldapArgs
|
|
{
|
|
my ($bind, $base) = @_;
|
|
my %ld;
|
|
|
|
$main::opt_v = $main::opt_n if defined($main::opt_n);
|
|
$main::opt_p = LDAPS_PORT if (!defined($main::opt_p) &&
|
|
defined($main::opt_P) &&
|
|
($main::opt_P ne ""));
|
|
|
|
$ld{"host"} = $main::opt_h || "ldap";
|
|
$ld{"port"} = $main::opt_p || LDAP_PORT;
|
|
$ld{"root"} = $main::opt_b || $base || $ENV{'LDAP_BASEDN'};
|
|
$ld{"bind"} = $main::opt_D || $bind || "";
|
|
$ld{"pswd"} = $main::opt_w || "";
|
|
$ld{"cert"} = $main::opt_P || "";
|
|
$ld{"scope"} = (defined($main::opt_s) ? $main::opt_s : LDAP_SCOPE_SUBTREE);
|
|
|
|
if (($ld{"bind"} ne "") && ($ld{"pswd"} eq ""))
|
|
{
|
|
$ld{pswd} = askPassword(1);
|
|
}
|
|
|
|
return %ld;
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Create a Unix-type password, using the "crypt" function. A random salt
|
|
# is always generated, perhaps it should be an optional argument?
|
|
#
|
|
sub unixCrypt
|
|
{
|
|
my $ascii =
|
|
"./0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
|
|
my $salt = substr($ascii, rand(62), 1) . substr($ascii, rand(62), 1);
|
|
|
|
srand(time ^ $$);
|
|
crypt($_[0], $salt);
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Try to find a user to bind as, and possibly ask for the password. Pass
|
|
# a pointer to the hash array with LDAP parameters to this function.
|
|
#
|
|
sub userCredentials
|
|
{
|
|
my ($ld) = @_;
|
|
my ($conn, $entry, $pswd);
|
|
|
|
if ($ld->{"bind"} eq "")
|
|
{
|
|
$conn = new Mozilla::LDAP::Conn($ld);
|
|
die "Could't connect to LDAP server " . $ld->{"host"} unless $conn;
|
|
|
|
$search = "(&(objectclass=inetOrgPerson)(uid=$ENV{USER}))";
|
|
$entry = $conn->search($ld->{"root"}, "subtree", $search, 0, ("uid"));
|
|
return 0 if (!$entry || $conn->nextEntry());
|
|
|
|
$conn->close();
|
|
$ld->{"bind"} = $entry->getDN();
|
|
}
|
|
|
|
if ($ld->{"pswd"} eq "")
|
|
{
|
|
$ld->{"pswd"} = Mozilla::LDAP::Utils::askPassword(1);
|
|
}
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Ask a Y/N question, return "Y" or "N".
|
|
#
|
|
sub answer
|
|
{
|
|
die "Default string must be Y or N."
|
|
unless (($_[0] eq "Y") || ($_[0] eq "N"));
|
|
|
|
chop($_ = <STDIN>);
|
|
|
|
return $_[0] if /^$/;
|
|
return "Y" if /^[yY]/;
|
|
return "N" if /^[nN]/;
|
|
}
|
|
|
|
|
|
#############################################################################
|
|
# Mandatory TRUE return value.
|
|
#
|
|
1;
|
|
|
|
|
|
#############################################################################
|
|
# POD documentation...
|
|
#
|
|
__END__
|
|
|
|
=head1 NAME
|
|
|
|
Mozilla::LDAP::Utils.pm - Collection of useful little utilities.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
use Mozilla::LDAP::Utils;
|
|
|
|
=head1 ABSTRACT
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
=head1 OBJECT CLASS METHODS
|
|
|
|
=over 13
|
|
|
|
=item B<normalizeDN>
|
|
|
|
This function will remove all extraneous white spaces in the DN, and also
|
|
change all upper case characters to lower case. The only argument is the
|
|
DN string to normalize, and the return value is the new, clean DN.
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
There are plenty of examples to look at, in the examples directory. We are
|
|
adding more examples every day (almost).
|
|
|
|
=head1 INSTALLATION
|
|
|
|
Installing this package is part of the Makefile supplied in the
|
|
package. See the installation procedures which are part of this package.
|
|
|
|
=head1 AVAILABILITY
|
|
|
|
This package can be retrieved from a number of places, including:
|
|
|
|
http://www.mozilla.org/directory/
|
|
Your local CPAN server
|
|
|
|
=head1 CREDITS
|
|
|
|
Most of this code was developed by Leif Hedstrom, Netscape Communications
|
|
Corporation.
|
|
|
|
=head1 BUGS
|
|
|
|
None. :)
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<Mozilla::LDAP::Conn>, L<Mozilla::LDAP::Entry>, L<Mozilla::LDAP::API>, and
|
|
of course L<Perl>.
|
|
|
|
=cut
|