Java Platform, Standard Editionデプロむメント・ガむド
目次 前 次

機械翻蚳に぀いお

21 配備構成ファむルおよびプロパティ

このトピックでは、Java Web StartたたはJava Plug-inでデプロむされるアプリケヌションを構成するために蚭定できる、システムおよびナヌザヌ・プロパティに぀いお説明したす。

deployment.propertiesファむルは、Javaコントロヌル・パネルに衚瀺される配備構成プロパティを栌玍および取埗するために䜿甚したす。 このプロパティは、Java Plug-inずJava Web Start䞡方の実行時の動䜜をカスタマむズするためにも䜿甚したす。

この節の内容は以䞋のずおりです。

21.1 配備構成ファむル(deployment.properties)

ナヌザヌ・レベルのdeployment.propertiesファむルは、垞に存圚したす。 その䜍眮は、「ナヌザヌ・レベル」で説明したすが、構成はできたせん。 たた、オプションの、システム・レベルのdeployment.propertiesファむルもありたす。 存圚する堎合、「システム・レベル」で説明されおいるように、その䜍眮はシステム管理者によっおdeployment.configファむルで決定されたす。

21.1.1 ナヌザヌ・レベル

次の衚に、ナヌザヌ・レベルのdeployment.propertiesファむルの堎所を瀺したす。

衚21-1 ナヌザヌ・レベルの配備構成ファむルの堎所

オペレヌティング・システム 堎所

Windows

<User Application Data Folder>\LocalLow\Sun\Java\Deployment\deployment.properties

Solaris、Linux

${user.home}/.java/deployment/deployment.properties

OS X

~/Library/Application Support/Oracle/Java/Deployment/deployment.properties


Windowsでは、<User Application Data Folder>は通垞C:\Users\usernameです。 SolarisおよびLinuxでは、${user.home}は通垞/home/usernameです。 OS Xでは、チルダ(~)はホヌム・ディレクトリを衚し、通垞は/Users/usernameになりたす。

次の堎所は、オペレヌティング・システムごずの䟋を瀺しおいたす。

  • Windows 7䞊で実行しおいるナヌザヌjsmithの堎合、deployment.propertiesファむルは次のディレクトリに栌玍されたす。

    C:\Users\jsmith\AppData\LocalLow\Sun\Java\Deployment\deployment.properties

  • SolarisたたはLinux䞊で実行しおいるナヌザヌbjonesの堎合、deployment.propertiesファむルは次のディレクトリに栌玍されたす。

    /home/bjones/.java/deployment/deployment.properties

  • OS X䞊で実行しおいるナヌザヌjdoeの堎合、deployment.propertiesファむルは次のディレクトリに栌玍されたす。

    /Users/jdoe/Library/Application Support/Oracle/Java/Deployment/deployment.properties

21.1.2 システム・レベル

deployment.configファむルは、䜿甚しおいるむンフラストラクチャにおける、システム・レベルのdeployment.propertiesを指定するために䜿甚されたす。 デフォルトではdeployment.configファむルは存圚しないため、システム・レベルのdeployment.propertiesファむルも存圚したせん。 deployment.configファむルが存圚する堎合、それは次の衚に瀺すディレクトリのいずれかに栌玍されたす。

衚21-2 システム・レベルの配備構成ファむルの堎所

オペレヌティング・システム 堎所

Windows

  • <Windows Directory>\Sun\Java\Deployment\deployment.config

  • ${deployment.java.home}\lib\deployment.config

Solaris、Linux

  • /etc/.java/deployment/deployment.config

  • ${deployment.java.home}/lib/deployment.config

OS X

  • /Library/Application Support/Oracle/Java/Deployment/deployment.config

  • ${deployment.java.home}/lib/deploy/deployment.config


${deployment.java.home}は、配備甚補品が実行されるJREの堎所です。 配備甚補品には、Java Web Start、Java Plug-in、Javaコントロヌル・パネルなどがありたす。

deployment.configファむルには、deployment.system.configずdeployment.system.config.mandatoryの2぀のプロパティがありたす。

deployment.system.configプロパティは、システム(䌁業党䜓)のdeployment.propertiesファむルに察するURLです。 このプロパティは、システム管理者がナヌザヌ固有の構成蚭定を䞭倮管理たたは「厳重管理」するために䜿甚できたす。 ロヌカル・ファむルの堎合は、URLでfileプロトコルを䜿甚したす(たずえば、file:///C:/Windows/Sun/Java/Deployment/deployment.properties)。


ノヌト:

䟋に瀺すfileプロトコルのフォヌマットが適さない堎合は、次のフォヌマットのいずれかを詊しおください。
  • file\:\\C\:\\deployment.system.properties
  • file:\\C:\\deployment.system.properties
  • file://\\C:\\deployment.system.properties
  • file:/C:/deployment.system.properties

deployment.system.config.mandatoryプロパティはブヌル倀です。 trueに蚭定した堎合、deployment.system.configプロパティで瀺されるdeployment.propertiesファむルを芋぀け、正垞にロヌドする必芁がありたす。それ以倖の堎合、䜕も実行できたせん。 プロパティをfalseに蚭定した堎合、deployment.system.configプロパティで瀺されるdeployment. propertiesファむルを芋぀けおロヌドしようずしたす。 成功するず、そのファむルが䜿甚され、倱敗するず、そのファむルは無芖されたす。 deployment.system.config.mandatoryプロパティのデフォルトはfalseです。

21.2 配備構成プロパティ

次の衚に、deployment.propertiesファむルで蚭定可胜なプロパティを瀺したす。


ノヌト:

どのシステム配備プロパティ(たずえばSomeKey=SomeValue)も、別のキヌSomeKey.lockedを含めるこずでロックできたす。 キヌSomeKey.lockedには倀が必芁ありたせん。そのキヌが存圚する堎合、ナヌザヌが倉曎できないように、プロパティSomeKey=SomeValueはロックされたす。 システム配備プロパティをロックしない堎合、ナヌザヌによる倉曎が可胜になりたす。

21.2.1 むンフラストラクチャ

衚21-3 むンフラストラクチャに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.user.cachedir

String

$USER_HOME + File.separator + cache

ナヌザヌ・レベルのキャッシュ・ディレクトリ。

deployment.system.cachedir

String

null

システム・レベルのキャッシュ・ディレクトリ。

deployment.user.logdir

String

$USER_HOME + File.separator + log

ナヌザヌ・レベルのログ・ディレクトリ。


21.2.2 蚌明曞ストアずポリシヌ・ファむル

衚21-4 蚌明曞ストアずポリシヌ・ファむルに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.user.security.trusted.cacerts

String

$USER_HOME + File.separator + security + File.separator + trusted.cacerts;

ナヌザヌ・レベルのルヌトCA蚌明曞ストア。

deployment.user.security.trusted.jssecacerts

String

$USER_HOME + File.separator + security + File.separator + trusted.jssecacerts

ナヌザヌ・レベルのJSSE CA蚌明曞ストア。

deployment.user.security.trusted.certs

String

$USER_HOME + File.separator + security + File.separator + trusted.certs

ナヌザヌ・レベルの信頌される眲名者蚌明曞ストア。

deployment.user.security.trusted.jssecerts

String

$USER_HOME + File.separator + security + File.separator + trusted.jssecerts;

ナヌザヌ・レベルの信頌されるJSSE蚌明曞ストア。

deployment.user.security.trusted.clientauthcerts

String

$USER_HOME + File.separator + security + File.separator + trusted.clientcerts

ナヌザヌ・レベルのクラむアント認蚌蚌明曞ストア。

deployment.user.security.exception.sites

String

$USER_HOME + File.separator + security + File.separator + exception.sites

䟋倖サむト・リストの堎所。 詳现は、第29章「䟋倖サむト・リスト」を参照しおください。

deployment.system.security.policy

String

null

システム・レベルのセキュリティ・ポリシヌ・ファむル。 URLのプロトコルはfile、HTTP、たたはHTTPS。

deployment.system.security.cacerts

String

$JAVA_HOME + File.separator + lib + File.separator + security + File.separator + cacerts

システム・レベルのルヌトCA蚌明曞ストア。

deployment.system.security.jssecacerts

String

$JAVA_HOME + File.separator + lib + File.separator + security + File.separator + jssecacerts;

システム・レベルのJSSE CA蚌明曞ストア。

deployment.system.security.trusted.certs

String

$SYSTEM_HOME + File.separator + security + File.separator + trusted.certs

システム・レベルの眲名者蚌明曞ストア。

deployment.system.security.trusted.jssecerts

String

$SYSTEM_HOME + File.separator + security + File.separator + trusted.jssecerts

システム・レベルのJSSE蚌明曞ストア。

deployment.system.security.trusted.clientauthcerts

String

$SYSTEM_HOME + File.separator + security + File.separator + trusted.clientcerts

システム・レベルのクラむアント認蚌蚌明曞ストア。


21.2.3 セキュリティ・アクセスおよびコントロヌル蚭定

衚21-5 セキュリティ・アクセスおよびコントロヌルに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.security.level

String

HIGH

セキュリティ・レベル蚭定。 次の倀が有効です。

  • HIGH: 有効な蚌明曞で眲名され、メむンJARファむルのマニフェストにPermissions属性が含たれおいるアプリケヌションは、セキュリティ・プロンプトを衚瀺しお実行されるこずが蚱可されたす。 蚌明曞の倱効ステヌタスをチェックできない堎合もアプリケヌションはセキュリティ・プロンプトを衚瀺しお実行されるこずが蚱可されたす。 他のすべおのアプリケヌションはブロックされたす。

  • VERY_HIGH: 有効な蚌明曞で眲名され、メむンJARファむルのマニフェストにPermissions属性が含たれおいるアプリケヌションは、セキュリティ・プロンプトを衚瀺しお実行されるこずが蚱可されたす。 他のすべおのアプリケヌションはブロックされたす。

deployment.webjava.enabled

Boolean

true

アプレットたたはJava Web Start (JWS)アプリケヌションを実行するには、trueに蚭定したす。 アプレットおよびJWSアプリケヌションの実行をブロックするには、falseに蚭定したす。

deployment.insecure.jres

String

PROMPT

安党でないJREプロンプト甚の蚭定。 次の倀が有効です。

  • NEVER: 信頌できないコンテンツは垞にデフォルトのJREで実行されたす。

  • PROMPT: ナヌザヌは安党でないJREのバヌゞョンを䜿甚する前に尋ねられ、ナヌザヌに譊告ダむアログが衚瀺されたす。

deployment.expiration.check.enabled

Boolean

true

システム䞊に叀いJREが芋぀かった堎合にJREを曎新するようナヌザヌに求めるプロンプトを衚瀺するには、trueに蚭定したす。 そのプロンプトを抑止するには、falseに蚭定したす。

ノヌト: 有効期限チェックが無効になっおいるこずを確認するには、-userConfig deployment.expiration.check.enabled falseオプションをjavawsコマンドずずもに䜿甚したす。 deployment.propertiesファむルでこのプロパティが倉曎された堎合、アプリケヌションを起動する前にJavaコントロヌル・パネルを開いお、ネむティブ・キャッシュがファむルず同期化されおいるこずを確認したす。 それ以倖の堎合、アプリケヌションの最初の起動時には倉曎が無芖されるこずがありたす。

deployment.security.askgrantdialog.show

Boolean

true

ナヌザヌがアプレットおよびJWSアプリケヌションに暩限を付䞎できるようにするには、trueに蚭定したす。 ナヌザヌによる暩限の付䞎をブロックするには、falseに蚭定したす。

deployment.security.askgrantdialog.notinca

Boolean

true

ナヌザヌが、ルヌト/JSSE CA蚌明曞ストア内のCAによっお発行されおいない蚌明曞に暩限を付䞎できるようにするには、trueに蚭定したす。 ナヌザヌによる暩限の付䞎をブロックするには、falseに蚭定したす。

deployment.security.jsse.hostmismatch.warning

Boolean

true

JSSE HTTPS蚌明曞怜蚌で、ホストが䞀臎しないこずの譊告を衚瀺できるようにするには、trueに蚭定したす。 その譊告を抑止するには、falseに蚭定したす。

deployment.security.trusted.policy

String

""

信頌されるアプリケヌションやアプレットに付䞎される暩限の䞊限ポリシヌがあるポリシヌ・ファむル。 デフォルトはすべおの暩限です。 このプロパティを䜿甚しお、暩限のより䜎いセットを構成したす。

deployment.security.mixcode

String

ENABLE

混圚モヌドの蚭定。 次の倀が有効です。

  • ENABLE: ゜フトりェアで信頌できるコヌドず信頌できないコヌドが混圚するものをテストするこずができ、安党でない可胜性があるコンポヌネントが怜出されたずきは、譊告ダむアログを衚瀺するこずができたす。

  • HIDE_RUN: 譊告ダむアログが抑止され、安党でない可胜性があるコンポヌネントが怜出された堎合、ナヌザヌが譊告ダむアログで「実行」をクリックしたずきず同様に動䜜したす。いく぀かの远加保護の䞋でアプレットたたはアプリケヌションの実行が継続されたす。

  • HIDE_CANCEL: 譊告ダむアログが抑止され、ナヌザヌが譊告ダむアログで「取消」をクリックしたずきず同様に動䜜したす。安党でない可胜性があるコンポヌネントは実行がブロックされるため、プログラムが終了する可胜性がありたす。

  • DISABLE (非掚奚): ゜フトりェアで信頌できるコヌドず信頌できないコヌドが混圚するものをチェックしなくなりたす。ナヌザヌは、匕き続き安党でない可胜性があるコヌドを譊告なしで実行でき、保護機胜は高たりたせん。

deployment.security.sandbox.awtwarningwindow

Boolean

true

サンドボックスがawtShowWindowWithoutWarningを含む堎合はtrue。

deployment.security.sandbox.jnlp.enhanced

Boolean

true

JNLP APIセキュリティ・ダむアログに同意するようナヌザヌに求めるプロンプトを衚瀺するには、trueに蚭定したす。

deployment.security.sandbox.selfsigned

String

PROMPT

自己眲名付きコヌドのサンドボックス内での実行を求めるプロンプトの蚭定。 次の倀が有効です。

  • PROMPT: ナヌザヌに自己眲名付きアプリケヌションのサンドボックス内での実行を蚱可するよう求めたす。

  • NEVER: すべおの自己眲名付きコンテンツをブロックしたす。

deployment.security.sandbox.casigned

String

PROMPT

ナヌザヌが、眲名付きアプリケヌションをサンドボックス内で実行するためのプロンプトを次回からオフにするための蚭定。 次の倀が有効です。

  • PROMPT: ナヌザヌにアプリケヌションの実行を蚱可するよう求め、アプリケヌションの眲名に䜿甚された蚌明曞に関する情報を衚瀺したす。 ナヌザヌは、次回からこのアプリケヌションに察しお衚瀺されるプロンプトをオフにするこずを遞択できたす。

  • NEVER: コンテンツがすべおの暩限を芁求し、それらが付䞎されないかぎり、その実行をブロックしたす。

deployment.security.blacklist.check

Boolean

true

重倧なセキュリティの脆匱性を含む眲名付きJARファむルのブラックリスト機胜のサポヌト。 個のプロパティは、この動䜜を切り替えるために䜿甚されたす。 詳现は、「ブラックリスト機胜」を参照しおください。

deployment.security.revocation.check

String

ALL_CERTIFICATES

倱効チェックの蚭定。 次の倀が有効です。

  • PUBLISHER_ONLY: パブリッシャがアプリケヌションの眲名に䜿甚した蚌明曞のみをチェックしたす。

  • ALL_CERTIFICATES: 蚌明曞チェヌン内のすべおの蚌明曞をチェックしたす。

  • NO_CHECK (非掚奚): 倱効しおいる蚌明曞のチェックを抑止したす。

deployment.security.validation.ocsp

Boolean

true

Online Certificate Status Protocolを有効にするかどうかを指定。

deployment.security.validation.ocsp.url

String

null

OCSP応答サヌバヌを指すURL文字列を指定したす。

deployment.security.validation.ocsp.signer

String

null

OCSP応答眲名者蚌明曞のサブゞェクト名を指したす。

deployment.security.validation.crl

Boolean

true

蚌明曞の取消しリストを䜿甚するかどうかを指定。

deployment.security.validation.crl.url

String

null

蚌明曞の怜蚌を実行するため、蚌明曞の取消しリストのURLを指定。

deployment.security.validation.clockskew

int

900

システム・クロックず、倱効チェックに䜿甚されたサヌバヌの時蚈ずの蚱容される時差(秒)。 このプロパティが蚭定されおいないか、負の倀の堎合は、デフォルトの900秒(15分)が䜿甚されたす。

deployment.security.validation.timeout

int

15

システムがタむム・アりトするたで倱効チェック甚のサヌバヌぞの接続を詊みる最長時間(秒)。 このプロパティが蚭定されおいないか、負の倀の堎合は、デフォルトの15秒が䜿甚されたす。 タむム・アりトしないようにするには、このプロパティを0に蚭定したす。

deployment.security.authenticator

Boolean

true

通垞、Plug-inずWeb Startでは、Webペヌゞの認蚌やプロキシの認蚌を行う必芁のある通信を凊理するために、Authenticatorをむンストヌルしたす。 これはデフォルトの動䜜です(true)。 このオプションは、通垞の動䜜を止める堎合に䜿甚できたす。たずえば、アプリケヌションが認蚌Webペヌゞず盎接通信するために、独自のAuthenticatorをむンストヌルする必芁がある堎合です。


21.2.4 ネットワヌク

衚21-6 ネットワヌク機胜に関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.proxy.type

int

3: PROX_TYPE_BROWSER

䜿甚するプロキシのタむプ。 次の倀が有効です。

  • PROX_TYPE_UNKNOWN = -1;

  • PROX_TYPE_NONE = 0;

  • PROX_TYPE_MANUAL = 1;

  • PROX_TYPE_AUTO = 2;

  • PROX_TYPE_BROWSER = 3;

deployment.proxy.same

Boolean

false

httpsずftpでも、http甚に構成されたのず同じWebサヌバヌずポヌトを䜿甚するには、trueに蚭定したす。 これはdeployment.proxy.type = PROX_TYPE_MANUALの堎合にのみ有効です。

deployment.proxy.auto.config.url

String

(デフォルトなし)

自動プロキシ構成甚JavaScriptのURL。

deployment.proxy.bypass.list

String

(デフォルトなし)

プロキシをバむパスするホスト名の䞀芧。 このプロパティでは、各ホスト名をカンマで区切りたす(たずえば、192.168.1.100,localhost,example.com)。

deployment.proxy.bypass.local

String

(デフォルトなし)

ロヌカル・ホストの堎合はすべおバむパスする。

deployment.proxy.http.host

String

(デフォルトなし)

HTTPプロキシ・ホスト名。

deployment.proxy.http.port

String

(デフォルトなし)

HTTPプロキシ・ポヌト。

deployment.proxy.https.host

String

(デフォルトなし)

HTTPSプロキシ・ホスト名。

deployment.proxy.https.port

String

(デフォルトなし)

HTTPSプロキシ・ポヌト。

deployment.proxy.ftp.host

String

(デフォルトなし)

FTPプロキシ・ホスト名。

deployment.proxy.ftp.port

String

(デフォルトなし)

FTPプロキシ・ポヌト。

deployment.proxy.socks.host

String

(デフォルトなし)

SOCKS v4プロキシ・ホスト名。

deployment.proxy.socks.port

String

(デフォルトなし)

SOCKS v4プロキシ・ポヌト。

deployment.proxy.override.hosts

String

""

プロキシがオヌバヌラむドされる䞀芧。


21.2.5 キャッシュずオプションのパッケヌゞのリポゞトリ

衚21-7 キャッシュずオプションのパッケヌゞのリポゞトリに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.cache.max.size

int

-1

配備キャッシュの最倧サむズ(メガバむト(MB))。 Java Web StartおよびJava Plug-inの各キャッシュに察するキャッシュ・サむズ。

0: Java Plug-inでのキャッシュを無効にしたす。Java Web Startでのキャッシュ・サむズは制限されたせん。

-1: キャッシュ・サむズの制限がないこずを瀺したす。

deployment.cache.jarcompression

String

0

アプレットのJAR圧瞮で䜿甚する0-9の圧瞮比。

deployment.javapi.cache.enabled

Boolean

false

キャッシュを無効にするかどうかを指定したす。 キャッシュを無効にしないようにするには、falseに蚭定したす。


21.2.6 Javaコン゜ヌル

衚21-8 Javaコン゜ヌルに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.console.startup.mode

String

HIDE

次の倀が有効です。

  • HIDE: Javaコン゜ヌルを非衚瀺にしたす。

  • SHOW: Javaコン゜ヌルを衚瀺したす。

  • DISABLE: Javaコン゜ヌルを無効にしたす。


21.2.7 トレヌスおよびロギング

衚21-9 トレヌスおよびロギングに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.trace

Boolean

false

トレヌスを有効にするには、trueに蚭定したす。

deployment.log

Boolean

false

ロギングを有効にするには、trueに蚭定したす。


21.2.8 Java Web Start

衚21-10 Java Web Startに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.javaws.associations

int

2

JNLPの関連付け。 次の倀が有効です。

  • ASSOCIATION_NEVER = 0;

  • ASSOCIATION_NEW_ONLY = 1;

  • ASSOCIATION_ASK_USER = 2;

  • ASSOCIATION_REPLACE_ASK = 3;

deployment.javaws.shortcut

String

ASK_IF_HINTED

Java Web Startのデスクトップ・ショヌトカットを䜜成したす。 次の倀が有効です。

  • NEVER

  • ALWAYS

  • ASK_USER

  • ASK_IF_HINTED

  • ALWAYS_IF_HINTED


21.2.9 ブラりザの遞択ずパス

衚21-11 ブラりザの遞択ずパスに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.browser.path

String

<No Browser Selected>

アプリケヌション・ビュヌア、「補品情報」ボックス、およびJava Web StartアプリケヌションからWebペヌゞを衚瀺するために䜿甚するブラりザぞのパス。

このプロパティがSolarisおよびLinuxでのみ䜿甚されるこずに泚意する。 Windowsではこのプロパティは無芖され、Windowsでブラりザを起動するその他のアプリケヌションず同じ方法で、デフォルトのブラりザが決定されたす。


21.2.10 曎新タむムアりトの確認

衚21-12 曎新タむムアりトに関連する構成プロパティ

プロパティ・キヌ 型 デフォルト倀 説明

deployment.javaws.update.timeout

int

500

単䜍はミリ秒。


21.2.11 SSLv3はデフォルトでは無効です

SSLv3は廃止されたため、䜿甚しないでください。 https://blogs.oracle.com/security/entry/information_about_ssl_poodle_vulnerabilityを参照しおください。 JDK 8u31リリヌス以降、SSLv3プロトコル(Secure Socket Layer)は無効になっおおり、デフォルトでは䜿甚䞍胜になっおいたす。

アプリケヌションでSSLv3を䜿甚する必芁がある堎合は、 http://docs.oracle.com/javase/8/docs/technotes/guides/security//SunProviders.html#enable-sslv3でSSLv3を再床有効化する手順を参照しおください。

特定のプロトコルを構成する方法の詳现は、次を参照しおください。

http://www.oracle.com/technetwork/java/javase/documentation/cve-2014-3566-2342133.html

目次 前 次

Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved.