Interstage Application Server ディレクトリサービス運用ガイド

7.1.2 検索フィルタ

　Interstage ディレクトリサービスのクライアントで使用できる検索フィルタ(RFC1558準拠)とその使用例を次に示します。

使用できる検索フィルタ

　検索フィルタには、以下の5つを指定することができます。

フィルタ	内容
同値 (equal)	指定した値と同じ属性値がある場合に、取り出します。
部分文字列 (substring)	指定した部分文字列を含む属性値がある場合に、取り出します。 部分文字列には、前方一致、後方一致、任意一致、およびこれらを組み合わせて指定することができます。
より大きい (greater)	指定した値より大きい値の属性値がある場合に、取り出します。
より小さい (less)	指定した値より小さい値の属性値がある場合に、取り出します。
存在 (present)	属性値がある場合に、取り出します。

　また、上記の各フィルタを組み合わせることで、より詳細に指定することができます。以下に組み合わせに使用する論理演算を示します。

論理演算	内容
論理積 (AND)	複数のフィルタを論理積（AND）条件で結びます。 すべての条件が真の場合に、有効となります。
論理和 (OR)	複数のフィルタを論理和（OR）条件で結びます。 いずれかの条件が真の場合に、有効となります。
否定 (NOT) (RDBを使用する場合にだけ有効です。)	指定した条件が偽の場合に、有効となります。1つの条件にだけ指定できます。 例: (!(cn=Fujitsu)) (!(cn=Fujitsu)(uid=0123))という使い方はできません。

検索フィルタの文法

　検索フィルタの文法は、以下のRFC文書に記述されています。

• RFC1960 ： “A String Representation of LDAP Search Filters”
• RFC2254 ： “The String Representation of LDAP Search Filters”

• 同値（=）
  　cnがUser001であるエントリを検索します。

  (cn=User001)

  
  

  　

• 部分文字列（文字列*）
  　cnがFujitsuで始まるエントリだけを検索します。

  (cn=Fujitsu*)

  　

• より大きい（>=）、より小さい（<=）
  　dnQualifierが「abc」より大きいエントリを検索します。

  (dnQualifier>=abc)

  　

• 存在（=*）
  　cnを含む全エントリを検索します。

  (cn=*)

  　

• 論理積（&）
  　cnがUser001で、かつsnがFujitsuであるエントリを検索します。

  (&(cn=User001)(sn=Fujitsu))

  　

• 論理和（|）
  　givenNameがUser001、またはUser002であるエントリを検索します。

  (|(givenName=User001)(givenName=User002))

  　

• 否定（!）(RDBを使用する場合にだけ有効です。)
  　cnがFujitsuで始まらないエントリだけを検索します。

  (!(cn=Fujitsu*))

  　

• 検索フィルタを指定する場合は、検索フィルタを引用符で囲んで指定してください。ldapsearchコマンドで検索フィルタを指定するときには、使用するコマンドラインに応じて、シングル引用符とダブル引用符のどちらかで囲んでください。
• 標準データベースを使用する場合に、論理和を指定して、検索条件を指定できるのは、2つまでです。
  以下のような指定は不正な検索フィルタとなります。

  (|(givenName=User001)(givenName=User002)(mail=*))

  
  
• RDBを使用する場合に、3つ以上の検索条件を組み合わせて指定する場合は、以下のように2つの条件で区切ったものを組み合わせて指定してください。

  (&(&(cn=User001)(sn=Fujitsu))(givenName=User001))

特殊文字の指定方法

　検索フィルタの値に、検索する値として以下の特殊文字を指定する場合、その特殊文字を「\」(エンマーク)でエスケープします。

　ldapsearchコマンドでは、1つのエスケープ文字「\」に続けて、16進数として指定する必要があります。

　C APIでは、2つのエスケープ文字「\\」に続けて、16進数として指定する必要があります。

　JNDIでは、16進数にする必要はありません。以下のように指定します。

特殊文字	ldapsearchコマンド	C API	JNDI
*	\2a	\\2a	\\*
(	\28	\\28	\\(
)	\29	\\29	\\)
\	\5c	\\5c	\\\\

　検索フィルタの値に「富士通(株)」を指定する場合、以下のように指定します。

ldapsearchコマンド

"o=富士通\28株\29"

C API

(o=富士通\\28株\\29)

JNDI

(o=富士通\\(株\\))