| CFLDAP | |||||||||
| 説明
Netscape Directory Server などの LDAP (Lightweight Directory Access Protocol) ディレクトリサーバーへのインターフェイスを提供します。 |
|||||||||
| カテゴリ
インターネットプロトコルタグ | |||||||||
シンタックス<cfldap server = "server_name" port = "port_number" username = "name" password = "password" action = "action" name = "name" timeout = "seconds" maxRows = "number" start = "distinguished_name" scope = "scope" attributes = "attribute, attribute" returnAsBinary = "column_name, column_name" filter = "filter" sort = "attribute[, attribute]..." sortControl = "nocase" および "desc"、"asc" dn = "distinguished_name" startRow = "row_number" modifyType = "replace"、"add"、"delete" rebind = "yes"、"no" referral = "number_of_allowed_hops" secure = "multi_field_security_string" separator = "separator_character" delimiter = "delimiter_character"> |
|||||||||
| 関連項目
cfftp、cfhttp、cfmail、cfmailparam、cfpop、『ColdFusion MX 開発ガイド』の第23章の「LDAP ディレクトリの管理」 |
|||||||||
| ヒストリ
ColdFusion MX 7: returnAsBinary 属性が追加されました。 ColdFusion MX:
|
|||||||||
| 使用方法
query アクションを使用すると、cfldap ではクエリーオブジェクトが作成されるため、次の表に示すようにクエリー変数の情報にアクセスできます。
security="CFSSL_BASIC" オプションを使用した場合、ColdFusion は、サーバーの資格情報と ColdFusion MX で使用される JRE の jre/lib/security/cacerts キーストア内の情報とを比較することで、サーバーを信頼するかどうかを判断します。ColdFusion MX のデフォルトの cacerts ファイルには、数多くの認証機関についての情報が含まれています。このファイルを追加情報で更新しなければならない場合は、ColdFusion の jre/bin ディレクトリにあるキーツールユーティリティを使用して、X.509 形式の資格情報をインポートします。たとえば、以下を入力してください。 keytool -import -keystore cacerts -alias ldap -file ldap.crt -keypass bl19mq その後、ColdFusion MX を再起動します。キーツールユーティリティの初期 keypass パスワードは "change it" です。キーツールユーティリティの使い方については、Sun JDK ドキュメントを参照してください。 ColdFusion では無効な文字が、LDAP の属性名に使用されていることがあります。結果として、cfldap タグが作成するクエリー結果セットの中に、CFML でアクセスできない無効な文字を含む名前の列が含まれる可能性があります。ColdFusion では、無効な文字は自動的にアンダースコア文字にマッピングされます。したがって、クエリー結果セットの列名は LDAP 属性の名前とは正確には一致しない場合があります。 使用例については、『ColdFusion MX 開発ガイド』を参照してください。 |
|||||||||
例<h3>cfldap の例</h3>
<p>LDAP ディレクトリサーバーへのインターフェイスを提供します。この例では
コネチカット大学のパブリック LDAP サーバーを使用します。パブリック LDAP サーバーの詳細については、
<a href="http://www.emailman.com">http://www.emailman.com</a> を参照してください。</p>
<p>名前を入力し、パブリック LDAP リソースを検索してください。
名前の前後のアスタリスクはワイルドカードとして機能します。</p>
<!--- form.name が存在する場合は、フォームが送信されているのでクエリーを実行します。 --->
<cfif IsDefined("form.name")>
<!--- 名前がリストされていることをチェックします。 --->
<cfif form.name is not "">
<!--- LDAP クエリーを作成します。 --->
<cfldap
server = "ldap.uconn.edu"
action = "query"
name = "results"
start = "dc=uconn,dc=edu"
filter = "cn=#name#"
attributes = "cn,o,title,mail,telephonenumber"
sort = "cn ASC">
<!--- 結果を表示します。 --->
<center>
<table border = 0 cellspacing = 2 cellpadding = 2>
<tr>
<th colspan = 5>
<cfoutput>#results.recordCount# matches found
</cfoutput></TH>
</tr>
<tr>
<th><font size = "-2">名前</font></TH>
<th><font size = "-2">組織</font></TH>
<th><font size = "-2">役職</font></TH>
<th><font size = "-2">電子メール</font></TH>
<th><font size = "-2">電話</font></TH>
</tr>
<cfoutput query = "results">
<tr>
<td><font size = "-2">#cn#</font></td>
<td><font size = "-2">#o#</font></td>
<td><font size = "-2">#title#</font></td>
<td><font size = "-2">
<A href = "mailto:#mail#">#mail#</A></font></td>
<td><font size = "-2">#telephonenumber#</font></td>
</tr>
</cfoutput>
</table>
</center>
</cfif>
</cfif>
<form action="#cgi.script_name#" method="POST">
<p>データベース内で検索する名前を入力します。
<p>
<input type="Text" name="name">
<input type="Submit" value="検索" name="">
</form>
|
|||||||||