4. Exemples
Ce qui suit sont quelques exemples d'URL LDAP qui utilisent le format défini ci-dessus. Le premier exemple est une URL LDAP faisant référence à l'entrée de l'Université du Michigan, disponible à partir d'un serveur LDAP choisi par le client :
ldap:///o=University%20of%20Michigan,c=US
L'exemple suivant est une URL LDAP faisant référence à l'entrée de l'Université du Michigan dans un serveur ldap particulier :
ldap://ldap1.example.net/o=University%20of%20Michigan,c=US
Ces deux URL correspondent à une recherche d'objet de base de l'entrée "o=University of Michigan,c=US" utilisant un filtre de "(objectclass=*)", demandant tous les attributs.
L'exemple suivant est une URL LDAP faisant référence uniquement à l'attribut postalAddress de l'entrée de l'Université du Michigan :
ldap://ldap1.example.net/o=University%20of%20Michigan,
c=US?postalAddress
L'opération de recherche LDAP correspondante est la même que dans l'exemple précédent, sauf que seul l'attribut postalAddress est demandé.
L'exemple suivant est une URL LDAP faisant référence à l'ensemble des entrées trouvées en interrogeant le serveur LDAP donné sur le port 6666 et en effectuant une recherche de sous-arbre de l'Université du Michigan pour toute entrée avec un nom commun de "Babs Jensen", récupérant tous les attributs :
ldap://ldap1.example.net:6666/o=University%20of%20Michigan,
c=US??sub?(cn=Babs%20Jensen)
L'exemple suivant est une URL LDAP faisant référence à tous les enfants de l'entrée c=GB :
LDAP://ldap1.example.com/c=GB?objectClass?ONE
L'attribut objectClass est demandé pour être renvoyé avec les entrées, et le filtre par défaut de "(objectclass=*)" est utilisé.
L'exemple suivant est une URL LDAP pour récupérer l'attribut mail pour l'entrée LDAP nommée "o=Question?,c=US", illustrant l'utilisation du mécanisme d'encodage en pourcentage sur le caractère réservé '?'.
ldap://ldap2.example.com/o=Question%3f,c=US?mail
L'exemple suivant (qui est divisé en deux lignes pour la lisibilité) illustre l'interaction entre la représentation de chaîne LDAP du mécanisme de citation des filtres et les mécanismes de citation d'URL.
ldap://ldap3.example.com/o=Babsco,c=US
???(four-octet=%5c00%5c00%5c00%5c04)
Le filtre dans cet exemple utilise le mécanisme d'échappement LDAP de \ pour encoder trois octets zéro ou nul dans la valeur. En LDAP, le filtre serait écrit comme (four-octet=\00\00\00\04). Parce que le caractère \ doit être échappé dans une URL, les \ sont encodés en pourcentage comme %5c (ou %5C) dans l'encodage de l'URL.
L'exemple suivant illustre l'interaction entre la représentation de chaîne LDAP du mécanisme de citation des DN et les mécanismes de citation d'URL.
ldap://ldap.example.com/o=An%20Example%5C2C%20Inc.,c=US
Le DN encodé dans l'URL ci-dessus est :
o=An Example\2C Inc.,c=US
C'est-à-dire que la valeur RDN la plus à gauche est :
An Example, Inc.
Les trois URL suivantes sont équivalentes, en supposant que les règles de défaut spécifiées dans la section 3 de ce document sont utilisées :
ldap://ldap.example.net
ldap://ldap.example.net/
ldap://ldap.example.net/?
Ces trois URL pointent vers le DSE racine sur le serveur ldap.example.net.
Les deux derniers exemples montrent l'utilisation d'une extension hypothétique et expérimentale de nom de liaison (la valeur associée à l'extension est un DN LDAP).
ldap:///??sub??e-bindname=cn=Manager%2cdc=example%2cdc=com
ldap:///??sub??!e-bindname=cn=Manager%2cdc=example%2cdc=com
Les deux URL sont les mêmes, sauf que la seconde marque l'extension e-bindname comme critique. Notez l'utilisation du mécanisme d'encodage en pourcentage pour encoder les virgules dans la valeur du nom distinctif dans l'extension e-bindname.