ヘッダーをスキップ
Oracle® Fusion Middleware Oracle Directory Server Enterprise Edition開発者ガイド
11g リリース1 (11.1.1.7.0)
B72440-01
  目次へ移動
目次		 索引へ移動
索引
前
前 		 次
次		  

A NameFinderアプリケーション

この章では、NameFinderをデプロイおよび構成する方法について説明します。

NameFinderは、便利なブラウザベース・インタフェースを備えたWebアプリケーションです。このアプリケーションによって、Lightweight Directory Access Protocol (LDAP)ディレクトリで連絡先と組織情報を検索できます。

この章の内容は、次のとおりです。

A.1 前提条件となるソフトウェア

NameFinderアプリケーションは、次の前提条件となるソフトウェア項目に依存します。

前提条件となるソフトウェアの次期バージョンも使用できます。NameFinderアプリケーションをデプロイする前に、前提条件となるソフトウェアをインストールして構成する必要があります。前提条件となるソフトウェアのインストールの詳細は、http://docs.oracle.com/cd/E19575-01/821-0844/のSun Java Enterprise System 7インストールおよびアップグレード・ガイド、またはより新しいエディションを参照してください。

A.2 NameFinderのデプロイ

NameFinderアプリケーションは、アプリケーション・サーバーまたはWebサーバーにデプロイできます。

A.2.1 アプリケーション・サーバーにデプロイするには

開始する前に

NameFinderアプリケーションをデプロイする前に、「前提条件となるソフトウェア」に一覧表示されたソフトウェアをインストールおよび構成していることを確認してください。

  1. アプリケーション・サーバーのブラウザベース管理インタフェースにログインします。

    たとえば、デフォルト・ポートを使用するようにアプリケーション・サーバーの管理インタフェースを構成した場合は、http://hostname:4848/に移動します。

  2. NameFinderアプリケーションをデプロイするサーバー・インスタンスを選択します。

    たとえば、デフォルト設定を使用するようにアプリケーション・サーバーを構成した場合は、server1を選択します。

  3. nfDSRK.warをWebアプリケーションとしてアップロードし、デフォルト設定を確定します。

    nfDSRK.war Webアプリケーション・アーカイブは、Directory Serverリソース・キットをインストールしたclassディレクトリ(install-path/dsrk/class/nfDSRK.war)にあります。

  4. サーバー・インスタンスに変更を適用します。

  5. 初めてNameFinderアプリケーションを表示します。

    たとえば、デフォルト設定を使用するようにアプリケーション・サーバーを構成した場合は、http://hostname:81/nfDSRK/に移動します。

    これで、「ディレクトリにアクセスするNameFinderの構成」に進むことができます。

A.2.2 Webサーバーにデプロイするには

開始する前に

NameFinderアプリケーションをデプロイする前に、「前提条件となるソフトウェア」に一覧表示されたソフトウェアをインストールおよび構成していることを確認してください。

  1. Webサーバーのブラウザベース管理インタフェースにログインします。

    たとえば、デフォルト・ポートを使用するようにWebサーバーの管理インタフェースを構成した場合は、http://hostname:8888/に移動します。

  2. Webサーバー・ホスト名ドロップダウン・メニューの横の「管理」をクリックします。

  3. 仮想サーバー・クラス・タブを選択し、仮想サーバー・クラス・ドロップダウン・メニューの横の管理をクリックします。

  4. 仮想サーバー・ドロップダウン・メニューの横の管理をクリックします。

    このページで、NameFinderアプリケーションをデプロイするサーバー・インスタンスを管理します。

  5. Webアプリケーション・タブを選択し、アプリケーション・デプロイのWebフォームを完成させます。

    nfDSRK.war Webアプリケーション・アーカイブは、Directory Serverリソース・キットをインストールしたclassディレクトリ(install-path/dsrk/class/nfDSRK.war)にあります。

    Webフォームを完成させる際には、インストール・ディレクトリがinstall-path/dsrk/class/であることに注意してください。

    さらに、アプリケーションURIの名前を変更できます。デフォルトは、/nfDSRKです。別の可能なアプリケーションURIは、/NameFinderです。

  6. 変更を適用します。

  7. サーバー・マネージャ・ページに戻ってサーバーを終了し、再度サーバーを起動します。

  8. 初めてNameFinderアプリケーションを表示します。

    たとえば、デフォルト設定を使用するようにWebサーバーを構成し、アプリケーションURIとして/nfDSRKを入力した場合は、http://hostname/nfDSRK/に移動します。

    これで、「ディレクトリにアクセスするNameFinderの構成」に進むことができます。

A.3 ディレクトリにアクセスするためのNameFinderの構成

アプリケーション・サーバーまたはWebサーバーで、ディレクトリにアクセスするようにNameFinderを構成できます。

A.3.1 アプリケーション・サーバーを使用する場合のアクセスを構成するには

NameFinderアプリケーションをデプロイした後、アプリケーション・サーバーは、NameFinderファイルを保持するWEB-INF/コンテナ・ディレクトリを作成します。このディレクトリの場所は、アプリケーション・サーバー・インスタンスをインストールした場所に依存します。

WEB-INF/classes/NameFinder.propertiesファイルで、取得するデータを保持するディレクトリにアクセスする方法を指定する必要があります。

  1. 必要に応じて、アプリケーション・サーバーのブラウザベース・インタフェースを使用して、NameFinderアプリケーションをデプロイしたパスを決定します。

    WEB-INF/classes/NameFinder.propertiesファイルは、そのディレクトリにあります。

  2. スーパーユーザーなど、ファイルを編集する権限を持つユーザーに変更します。

  3. WEB-INF/classes/NameFinder.propertiesファイルのプロパティを調整し、アプリケーションがディレクトリにアクセスして変更を保存できるようにします。

    NameFinder.propertiesファイルは、Javaプロパティ・ファイルです。ファイル内のすべての大文字と小文字が区別されます。少なくとも次の行を調整します。

    NameFinder.ldapBase=baseDN
NameFinder.ldapServers=serverList
NameFinder.ldapVersion=3
NameFinder.ldapPort=ldapPort
NameFinder.ldapUser=bindDN
NameFinder.ldapPasswd=bindPassword

    • baseDN: 組織内の個人のエントリのベースDNです(ou=people,dc=example,dc=comなど)。

    • serverList: ディレクトリ・サーバーの|で区切られたリストです(directory|backup-directory|ext-directory.example.comなど)。

    • ldapPort: サーバーがLDAPリクエストをリスニングするポート番号で、デフォルトは389です。

    • bindDN: 認証に使用されるDNです。

      バインドDNを引用符で囲まないでください。

    • bindPassword: 認証に使用されるパスワードです。

    調整できる項目に関するヒントは、WEB-INF/classes/sample.propertiesファイルのコメントを参照してください。

  4. アプリケーション・サーバーのブラウザベース・インタフェースで、変更の適用ボタンを押してサーバー・インスタンスに変更を適用します。

    変更を適用した後、NameFinderアプリケーションの使用を開始して、連絡先と組織情報を検索できます。

  5. ブラウザベース・インタフェースを使用し、自分自身など既知のユーザーを検索してNameFinderアプリケーションが機能していることを確認します。

    NameFinderアプリケーションが機能していることがわかったら、組織向けにアプリケーションをカスタマイズできます。

A.3.2 Webサーバーを使用する場合のアクセスを構成するには

NameFinderアプリケーションをデプロイした後、Webサーバーは、NameFinderファイルを保持するWEB-INF/コンテナ・ディレクトリを作成します。このディレクトリの場所は、Webサーバー・インスタンスをインストールした場所に依存します。

WEB-INF/classes/NameFinder.propertiesファイルで、取得するデータを保持するディレクトリにアクセスする方法を指定する必要があります。

  1. 必要に応じて、Webサーバーのブラウザベース・インタフェースを使用して、NameFinderアプリケーションをデプロイしたパスを決定します。

    WEB-INF/classes/NameFinder.propertiesファイルは、そのディレクトリにあります。

  2. スーパーユーザーなど、ファイルを編集する権限を持つユーザーに変更します。

  3. WEB-INF/classes/NameFinder.propertiesファイルのプロパティを調整し、アプリケーションがディレクトリにアクセスして変更を保存できるようにします。

    NameFinder.propertiesファイルは、Javaプロパティ・ファイルです。ファイル内のすべての大文字と小文字が区別されます。少なくとも次の行を調整します。

    NameFinder.ldapBase=baseDN
NameFinder.ldapServers=serverList
NameFinder.ldapVersion=3
NameFinder.ldapPort=ldapPort
NameFinder.ldapUser=bindDN
NameFinder.ldapPasswd=bindPassword

    • baseDN: 組織内の個人のエントリのベースDNです(ou=people,dc=example,dc=comなど)。

    • serverList: ディレクトリ・サーバーの|で区切られたリストです(directory|backup-directory|ext-directory.example.comなど)。

    • ldapPort: サーバーがLDAPリクエストをリスニングするポート番号で、デフォルトは389です。

    • bindDN: 認証に使用されるDNです。

      バインドDNを引用符で囲まないでください。

    • bindPassword: 認証に使用されるパスワードです。

    調整できる項目に関するヒントは、WEB-INF/classes/sample.propertiesファイルのコメントを参照してください。

    変更を有効にするには、Webサーバーを再起動する必要があります。

  4. Webサーバーのブラウザベース・インタフェースのサーバー・マネージャ・ページに戻ってサーバーを終了し、再度起動します。

    これで、NameFinderアプリケーションの使用を開始して、連絡先と組織情報を検索できます。

  5. ブラウザベース・インタフェースを使用し、自分自身など既知のユーザーを検索してNameFinderアプリケーションが機能していることを確認します。

    NameFinderアプリケーションが機能していることがわかったら、組織向けにアプリケーションをカスタマイズできます。

A.4 NameFinderのカスタマイズ

この項では、提供されたJavaプロパティ・ファイルのみを使用して、NameFinder Webアプリケーションでカスタマイズできる項目を説明します。個々のプロパティの詳細は、アプリケーションをデプロイしたディレクトリのWEB-INF/classes/sample.propertiesファイルを参照してください。


注意:

NameFinderは、Sunの内部Webアプリケーションとして設計されました。そのため、デフォルトの構成は、デフォルトのLDAPスキーマとDirectory Serverに付属のディレクトリ情報ツリー(DIT)に依存します。このスキーマとDITは、組織で使用中のスキーマとDITとは異なる可能性があります。

アプリケーション内でのカスタマイズに加え、検索フィールドのオプションを使用することによって検索をカスタマイズすることもできます。さらに、ブラウザベース・インタフェース内に表示する属性をカスタマイズできます。詳細は、NameFinderのオンライン・ヘルプを参照してください。

A.4.1 接続プロパティ

「ディレクトリにアクセスするNameFinderの構成」の説明に従って、アプリケーションからディレクトリにアクセスできるようにWEB-INF/classes/NameFinder.propertiesファイルをカスタマイズします。

通常、接続パラメータは、Javaプロパティ・ファイルの最初の数行に含まれています。NameFinderが接続するホストとポートの組合せを構成できます。また、LDAP v2またはv3を使用するかどうか、および特定のユーザーとしてバインドするかどうかも構成できます。

NameFinderの接続プロパティでは、ディレクトリに対する単純な認証接続のみを構成できます。接続プロパティを使用して、SSLまたはSASLメカニズムを使用して接続するようにNameFinderを構成することはできません。

A.4.2 検索属性プロパティ

NameFinderによって、検索オプション、検索する属性および戻される値のラベルを定義する属性が構成されます。そのような属性に対するJavaプロパティの定義は、次の形式になります。

NameFinder.attr#=optChar|colChar|attr|label|colLabel
#

10進数

順序内の数値が、コメント・アウトすることにより空白にならないようにしてください。NameFinderは、数値が昇順で並んでおり、空白がないことを想定しています。

optChar

検索で使用するオプション文字

たとえば、Pは、デフォルトで電話番号オプションです。NameFinderの検索フィールドに-P "1 234 567 8910"と入力することによって、電話番号1 234 567 8910を持つエントリを検索します。

Fをオプション文字として使用しないでください。この文字は、-F "(telephoneNumber=1 234 567 8910)"など、直接LDAP検索フィルタを入力できるように予約されています。

このパラメータは、WEB-INF/classes/sample.propertiesでarg1と呼ばれています。

colChar

NameFinderに対するパラメータとして表の列の定義に使用する文字

たとえば、デフォルトの構成を使用できます。複数のエントリを戻す検索で、NameFinderに対するURLのオプションの1つとしてfields=nfePを渡すことによって、デフォルトを使用します。NameFinderは、列のラベルがLastname、Firstname、eMailおよびPhone #の4列で構成される表で結果を表示します。

この引数は、WEB-INF/classes/sample.propertiesでarg2と呼ばれています。

attr

optCharを使用するときに検索するLDAP属性

この引数は、WEB-INF/classes/sample.propertiesでarg3と呼ばれています。

label

単一のLDAPエントリの結果を表示するときに、対応するattr値に対して表示するラベル

この引数は、WEB-INF/classes/sample.propertiesでarg4と呼ばれています。

colLabel

複数のLDAPエントリの結果を表示するときに、対応するattr値の表ヘッダーに表示する列ラベル

この引数は、WEB-INF/classes/sample.propertiesでarg5と呼ばれています。

検索属性プロパティの定義では、変数を空白のままにすることができます。

A.4.3 その他のプロパティ

接続プロパティと検索属性プロパティに加え、NameFinderによってWEB-INF/classes/NameFinder.propertiesファイルの複数のその他のプロパティを定義できます。これらのその他のプロパティは、次の項目を制御します。

  • 検索によって複数のエントリが戻される場合に結果を表示するデフォルトの表レイアウト

  • 電話番号と電子メール・アドレスを検索する場合に検索するLDAP属性のリスト

  • NameFinder属性フィールドに対応するLDAP属性(これによって、NameFinderを特定のLDAPスキーマから抽出できます)

  • チーム表示とマネージャの直属の部下の表を表示する表レイアウト

詳細は、WEB-INF/classes/sample.propertiesを参照してください。

  前
前 		 次
次
  目次へ移動
目次		 索引へ移動
索引