モジュールjava.naming

モジュールjava.naming

Java Naming and Directory Interface (JNDI) APIを定義します。

JNDIプロバイダでサポートされる可能性のある共通の標準JNDI環境プロパティは、Contextで定義およびドキュメント化されています。 特定のJNDIプロバイダの実装は、実装に固有の他の環境またはシステム・プロパティもサポートする場合があります。

実装上のノート:

JDKのデフォルトのLDAPネーミング・サービス・プロバイダ実装では、次の実装固有の環境プロパティがサポートされています:

• com.sun.jndi.ldap.connect.timeout:
  このプロパティの値は、接続タイムアウト(ミリ秒)を表す整数の文字列表現です。 LDAPプロバイダがこの値の期間中に接続を確立できないと、接続の試行は中止されます。 整数は0より大きい必要があります。 0以下の整数を指定した場合は、TCPなどのネットワーク・プロトコルのタイム・アウト値が使用されます。
  このプロパティが指定されない場合は、接続が確立されるのを待機するか、またはベースとなるネットワークのタイム・アウトまで待機します。
• com.sun.jndi.ldap.read.timeout:
  このプロパティの値は、LDAP演算の読取りタイムアウト(ミリ秒)を表す整数の文字列表現です。 LDAPプロバイダがこの値の期間中にLDAP応答を取得できないと、読取りの試行は中止されます。 整数は0より大きい必要があります。 0以下の整数は、読取りタイム・アウトが指定されていないことを表し、応答があるまで無限に待機するということです。
  このプロパティを指定しないと、デフォルトは応答があるまで待つという設定になります。
• com.sun.jndi.ldap.tls.cbtype:
  このプロパティの値は、SSL/TLS経由のLDAP接続に必要なTLSチャネル・バインディング・タイプを表す文字列です。 可能な値は次のとおりです :
  • "tls-server-end-point" - チャネル・バインディング・データはTLSサーバー証明書に基づいて作成されます。
  
  "tls-unique" TLSチャネル・バインド・タイプがRFC-5929で指定されていますが、サポートされていません。
  このプロパティを指定しない場合、クライアントはチャネル・バインディング情報をサーバーに送信しません。

JDKのデフォルトのLDAPネーミング・サービス・プロバイダ実装では、次の実装固有のシステム・プロパティがサポートされています:

• com.sun.jndi.ldap.object.trustSerialData:
  このシステム・プロパティの値は、javaSerializedData LDAP属性からのjavaオブジェクトの直列化復元、javaRemoteLocation LDAP属性からのRMI参照の再構築およびjavaReferenceAddress LDAP属性からのバイナリ参照アドレスの再構築を制御するブール値の文字列表現です。 javaSerializedData、javaRemoteLocationまたはjavaReferenceAddress属性からのjavaオブジェクトの直列化復元または再構築を可能にするには、システム・プロパティ値をtrue (大文字小文字を区別しません)に設定できます。
  プロパティが指定されていない場合、javaSerializedDataからのjavaオブジェクトの直列化復元、javaRemoteLocationまたはjavaReferenceAddress属性は許可されません。
• jdk.jndi.object.factoriesFilter:
  このシステム・プロパティの値は、JNDIランタイム実装によって使用されるフィルタを定義して、ネーミング/ディレクトリ・システムによって返されるオブジェクト参照からオブジェクトをインスタンス化できる一連のオブジェクト・ファクトリ・クラスを制御します。 参照インスタンスで指定されたファクトリ・クラスがこのフィルタと照合されます。 フィルタ・プロパティは、jdk.serialFilterと同じ形式でパターン・ベースのフィルタ構文をサポートします。 フィルタ・プロパティで指定された制限パターンは使用されません。 このプロパティは、「セキュリティ・プロパティ」と指定することもできます。 このプロパティは、「デフォルトのJNDI RMIプロバイダ」でもサポートされています。
  デフォルト値では、参照インスタンスで指定されたオブジェクト・ファクトリ・クラスによって、参照オブジェクトを再作成できます。
• jdk.jndi.ldap.object.factoriesFilter:
  このシステム・プロパティの値は、JDK LDAPプロバイダ実装で使用されるフィルタを定義し、LDAPシステムによって返されるオブジェクト参照からオブジェクトをインスタンス化できるオブジェクト・ファクトリ・クラスのセットをさらに制限します。 最初に「参照インスタンス」で指定されたファクトリ・クラスは、この特定のフィルタに対して照合され、次にグローバル・フィルタに対して照合されます。 ファクトリ・クラスは、これら2つのフィルタのいずれかが拒否した場合、またはいずれも許可しない場合、拒否されます。 filterプロパティは、jdk.serialFilterと同じ書式のパターン・ベースのフィルタ構文をサポートしています。 フィルタ・プロパティで指定された制限パターンは使用されません。
  デフォルト値では、JDK LDAPプロバイダ実装によって提供されるオブジェクト・ファクトリ・クラスを使用できます。
  このシステム・プロパティは、グローバルObjectFactoryBuilderが「未設定」の場合にのみ、LDAP固有のオブジェクト・ファクトリをフィルタするために使用されます。

他のプロバイダは、モジュールの説明に追加のプロパティを定義できます:

• DNSネーミング・プロバイダ
• RMIネーミング・プロバイダ

モジュール・グラフ:

導入されたバージョン:

9

パッケージ

エクスポート

パッケージ	説明
javax.naming	ネーム・サービスにアクセスするためのクラスおよびインタフェースを提供します。
javax.naming.directory
javax.naming.event	ネーミングおよびディレクトリ・サービスにアクセスする場合、イベント通知のサポートを提供します。
javax.naming.ldap	LDAPv3の拡張操作とコントロールのサポートを提供します。
javax.naming.ldap.spi
javax.naming.spi	javax.namingおよび関連パッケージを使用して、ネーミングおよびディレクトリ・サービスにアクセスするためのサポートを動的にプラグインする手段を提供します。

サービス

提供

型

説明

Provider

このクラスは、Java Security APIの「プロバイダ」を表します。プロバイダとは、Javaセキュリティの全体または一部を実装するものです。

使用

型

説明

InitialContextFactory

このインタフェースは、初期コンテキストを生成するファクトリを表します。

LdapDnsProvider

LDAP操作を実行するときのDNSルックアップのサービス提供クラス。

StartTlsResponse

このクラスは、Lightweight Directory Access Protocol (v3): Extension for Transport Layer Securityで定義された、StartTLSのLDAPv3拡張応答を実装します。StartTLSのオブジェクト識別子は1.3.6.1.4.1.1466.20037です。拡張応答の値は定義されていません。