4. Esempi
Di seguito sono riportati alcuni URL LDAP di esempio che utilizzano il formato definito sopra. Il primo esempio è un URL LDAP che fa riferimento alla voce dell'Università del Michigan, disponibile da un server LDAP scelto dal client:
ldap:///o=University%20of%20Michigan,c=US
L'esempio successivo è un URL LDAP che fa riferimento alla voce dell'Università del Michigan in un particolare server ldap:
ldap://ldap1.example.net/o=University%20of%20Michigan,c=US
Entrambi questi URL corrispondono a una ricerca dell'oggetto base della voce "o=University of Michigan,c=US" utilizzando un filtro di "(objectclass=*)", richiedendo tutti gli attributi.
L'esempio successivo è un URL LDAP che fa riferimento solo all'attributo postalAddress della voce dell'Università del Michigan:
ldap://ldap1.example.net/o=University%20of%20Michigan,
c=US?postalAddress
L'operazione di ricerca LDAP corrispondente è la stessa dell'esempio precedente, tranne per il fatto che viene richiesto solo l'attributo postalAddress.
L'esempio successivo è un URL LDAP che fa riferimento all'insieme di voci trovate interrogando il server LDAP specificato sulla porta 6666 ed eseguendo una ricerca nel sottoalbero dell'Università del Michigan per qualsiasi voce con un nome comune di "Babs Jensen", recuperando tutti gli attributi:
ldap://ldap1.example.net:6666/o=University%20of%20Michigan,
c=US??sub?(cn=Babs%20Jensen)
L'esempio successivo è un URL LDAP che fa riferimento a tutti i figli della voce c=GB:
LDAP://ldap1.example.com/c=GB?objectClass?ONE
L'attributo objectClass deve essere restituito insieme alle voci e viene utilizzato il filtro predefinito di "(objectclass=*)".
L'esempio successivo è un URL LDAP per recuperare l'attributo mail per la voce LDAP denominata "o=Question?,c=US", che illustra l'uso del meccanismo di codifica percentuale sul carattere riservato '?'.
ldap://ldap2.example.com/o=Question%3f,c=US?mail
L'esempio successivo (che è suddiviso in due righe per leggibilità) illustra l'interazione tra la rappresentazione di stringa LDAP del meccanismo di citazione dei filtri e i meccanismi di citazione degli URL.
ldap://ldap3.example.com/o=Babsco,c=US
???(four-octet=%5c00%5c00%5c00%5c04)
Il filtro in questo esempio utilizza il meccanismo di escape LDAP di \ per codificare tre byte zero o nulli nel valore. In LDAP, il filtro verrebbe scritto come (four-octet=\00\00\00\04). Poiché il carattere \ deve essere sottoposto a escape in un URL, i \ sono codificati in percentuale come %5c (o %5C) nella codifica URL.
L'esempio successivo illustra l'interazione tra la rappresentazione di stringa LDAP del meccanismo di citazione dei DN e i meccanismi di citazione degli URL.
ldap://ldap.example.com/o=An%20Example%5C2C%20Inc.,c=US
Il DN codificato nell'URL sopra è:
o=An Example\2C Inc.,c=US
Cioè, il valore RDN più a sinistra è:
An Example, Inc.
I seguenti tre URL sono equivalenti, supponendo che vengano utilizzate le regole di impostazione predefinita specificate nella Sezione 3 di questo documento:
ldap://ldap.example.net
ldap://ldap.example.net/
ldap://ldap.example.net/?
Questi tre URL puntano al DSE radice sul server ldap.example.net.
Gli ultimi due esempi mostrano l'uso di un'ipotetica estensione sperimentale del nome di associazione (il valore associato all'estensione è un DN LDAP).
ldap:///??sub??e-bindname=cn=Manager%2cdc=example%2cdc=com
ldap:///??sub??!e-bindname=cn=Manager%2cdc=example%2cdc=com
I due URL sono gli stessi, tranne per il fatto che il secondo contrassegna l'estensione e-bindname come critica. Notare l'uso del meccanismo di codifica percentuale per codificare le virgole all'interno del valore del nome distinto nell'estensione e-bindname.