[Top]
Protocols
Protocols.LDAP
|
Method Protocols.LDAP.canonicalize_dn()
- Method
canonicalize_dn
string canonicalize_dn(string dn, void|int strict)
- Description
Returns the given distinguished name on a canonical form, so it
reliably can be used in comparisons for equality. This means
removing surplus whitespace, lowercasing attributes, normalizing
quoting in string attribute values, lowercasing the hex digits in
binary attribute values, and sorting the RDN parts separated by
"+".
The returned string follows RFC 2253. The input string may
use legacy LDAPv2 syntax and is treated according to section 4 in
RFC 2253.
If strict is set then errors will be thrown if the given DN is
syntactically invalid. Otherwise the invalid parts remain
untouched in the result.
- Note
The result is not entirely canonical since no conversion is done
from or to hexadecimal BER encodings of the attribute values. It's
assumed that the input already has the suitable value encoding
depending on the attribute type.
- Note
No UTF-8 encoding or decoding is done. The function can be used on
both encoded and decoded input strings, and the result will be
likewise encoded or decoded.
|