/ 
URI-5.33
⭐ Starred 58 / URI::ldap
Security Advisories (1)
CVE-2026-19953 (2026-08-31)

URI versions before 5.36 for Perl encode non-NFC host names to non-standard punycode labels via missing normalization in nameprep. nameprep lowercases each host label but performs no Unicode normalization. IDNA requires a label to be normalized to Form C before it is encoded (RFC 5891), so a label that is not already in NFC is encoded to a different A-label than its normalized form. A label built from the precomposed Devanagari sequence U+0958 U+093E encodes to xn--72b5c without normalization but to xn--11b2fg after NFC normalization, and xn--72b5c does not round-trip back to the original label. Any caller that reads host() from a URI built from untrusted input and uses it for a security decision (an allow or deny list, an SSRF filter, deduplication, a cache key) sees the non-standard label, while a client that fetches the same URL resolves the NFC form, so the check and the fetch can disagree about the host.

NAME

URI::ldap - LDAP Uniform Resource Locators

SYNOPSIS

use URI;

$uri = URI->new("ldap:$uri_string");
$dn     = $uri->dn;
$filter = $uri->filter;
@attr   = $uri->attributes;
$scope  = $uri->scope;
%extn   = $uri->extensions;

$uri = URI->new("ldap:");  # start empty
$uri->host("ldap.itd.umich.edu");
$uri->dn("o=University of Michigan,c=US");
$uri->attributes(qw(postalAddress));
$uri->scope('sub');
$uri->filter('(cn=Babs Jensen)');
print $uri->as_string,"\n";

DESCRIPTION

URI::ldap provides an interface to parse an LDAP URI into its constituent parts and also to build a URI as described in RFC 2255.

METHODS

URI::ldap supports all the generic and server methods defined by URI, plus the following.

Each of the following methods can be used to set or get the value in the URI. The values are passed in unescaped form. None of these return undefined values, but elements without a default can be empty. If arguments are given, then a new value is set for the given part of the URI.

$uri->dn( [$new_dn] )

Sets or gets the Distinguished Name part of the URI. The DN identifies the base object of the LDAP search.

$uri->attributes( [@new_attrs] )

Sets or gets the list of attribute names which are returned by the search.

$uri->scope( [$new_scope] )

Sets or gets the scope to be used by the search. The value can be one of "base", "one" or "sub". If none is given in the URI then the return value defaults to "base".

$uri->_scope( [$new_scope] )

Same as scope(), but does not default to anything.

$uri->filter( [$new_filter] )

Sets or gets the filter to be used by the search. If none is given in the URI then the return value defaults to "(objectClass=*)".

$uri->_filter( [$new_filter] )

Same as filter(), but does not default to anything.

$uri->extensions( [$etype => $evalue,...] )

Sets or gets the extensions used for the search. The list passed should be in the form etype1 => evalue1, etype2 => evalue2,... This is also the form of list that is returned.

SEE ALSO

http://tools.ietf.org/html/rfc2255

AUTHOR

Graham Barr <gbarr@pobox.com>

Slightly modified by Gisle Aas to fit into the URI distribution.

COPYRIGHT

Copyright (c) 1998 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.