4. 例

以下は、上記で定義されたフォーマットを使用したいくつかの LDAP URL の例です。最初の例は、ミシガン大学のエントリを参照する LDAP URL であり、クライアントが選択した LDAP サーバーから利用可能です。

ldap:///o=University%20of%20Michigan,c=US

次の例は、特定の ldap サーバー内のミシガン大学のエントリを参照する LDAP URL です。

ldap://ldap1.example.net/o=University%20of%20Michigan,c=US

これらの URL は両方とも、フィルタ "(objectclass=*)" を使用してすべての属性を要求する、"o=University of Michigan,c=US" エントリのベースオブジェクト検索に対応しています。

次の例は、ミシガン大学のエントリの postalAddress 属性のみを参照する LDAP URL です。

ldap://ldap1.example.net/o=University%20of%20Michigan,
       c=US?postalAddress

対応する LDAP 検索操作は前の例と同じですが、postalAddress 属性のみが要求されます。

次の例は、ポート 6666 上の指定された LDAP サーバーにクエリを実行し、"Babs Jensen" という共通名を持つエントリについてミシガン大学のサブツリー検索を実行して見つかったエントリのセットを参照し、すべての属性を取得する LDAP URL です。

ldap://ldap1.example.net:6666/o=University%20of%20Michigan,
       c=US??sub?(cn=Babs%20Jensen)

次の例は、c=GB エントリのすべての子を参照する LDAP URL です。

LDAP://ldap1.example.com/c=GB?objectClass?ONE

objectClass 属性がエントリとともに返されるように要求され、デフォルトのフィルタ "(objectclass=*)" が使用されます。

次の例は、"o=Question?,c=US" という名前の LDAP エントリの mail 属性を取得するための LDAP URL であり、予約文字 '?' でのパーセントエンコーディングメカニズムの使用を示しています。

ldap://ldap2.example.com/o=Question%3f,c=US?mail

次の例 (読みやすくするために 2 行に分かれています) は、フィルタ引用メカニズムの LDAP 文字列表現と URL 引用メカニズムの間の相互作用を示しています。

ldap://ldap3.example.com/o=Babsco,c=US
        ???(four-octet=%5c00%5c00%5c00%5c04)

この例のフィルタは、LDAP エスケープメカニズム \ を使用して、値内の 3 つのゼロまたは null バイトをエンコードします。LDAP では、フィルタは (four-octet=\00\00\00\04) と記述されます。URL では \ 文字をエスケープする必要があるため、URL エンコーディングでは \ が %5c (または %5C) としてパーセントエンコードされます。

次の例は、DN 引用メカニズムの LDAP 文字列表現と URL 引用メカニズムの間の相互作用を示しています。

ldap://ldap.example.com/o=An%20Example%5C2C%20Inc.,c=US

上記の URL でエンコードされた DN は次のとおりです。

o=An Example\2C Inc.,c=US

つまり、左端の RDN 値は次のとおりです。

An Example, Inc.

本文書の第 3 節で指定されているデフォルトルールが使用されていると仮定すると、以下の 3 つの URL は同等です。

ldap://ldap.example.net
ldap://ldap.example.net/
ldap://ldap.example.net/?

これら 3 つの URL は、ldap.example.net サーバー上のルート DSE を指します。

最後の 2 つの例は、架空の実験的なバインド名拡張の使用を示しています (拡張に関連付けられた値は LDAP DN です)。

ldap:///??sub??e-bindname=cn=Manager%2cdc=example%2cdc=com
ldap:///??sub??!e-bindname=cn=Manager%2cdc=example%2cdc=com

2 つの URL は同じですが、2 つ目の URL は e-bindname 拡張を重要 (critical) としてマークしています。e-bindname 拡張の識別名値内のカンマをエンコードするためにパーセントエンコーディングメカニズムが使用されていることに注意してください。