SSL証明書の設定

HTTPS で New Relic コレクターと通信するためには、アプリサーバーのトラストストアに、信頼できる署名者のための適切な証明書が必要です。デフォルトでは、ほとんどの JRE には、エージェントが newrelic.com に接続するための有効なルート証明書が含まれています。

SSL接続の問題については、 SSLまたは接続エラー（Java）を参照してください。

期限切れのSSL証明書のお知らせと証明書の削除

注意

Javaエージェントのバージョン6.1.0から6.4.2にバンドルされていたSSL証明書は、有効期限が切れていて使えなくなりました。これにより、Javaエージェントバージョン6.1.0～6.4.2では、New Relicとの接続を確立するために、エージェントにバンドルされている証明書を使用することができなくなり、お客様ご自身でSSL証明書をご用意いただく必要があります。

詳細については、こちらのコミュニティフォーラムの投稿をご覧ください。

重要

6.4.2 より新しいバージョンの Java エージェントは、エージェントにバンドルされた SSL 証明書と共に出荷されなくなりました。ca_bundle_path構成オプションを明示的に使用するか、JDK/JRE によって提供されるデフォルトのトラストストアを使用して、独自の SSL トラストストアをエージェントに提供する必要があります (エージェントはデフォルトで後者を使用するように見えます)。さらに、 use_private_ssl構成オプションは、Java エージェントバージョン 6.4.2 以降から削除されました。

グローバル証明書をローカルトラストストアに追加したいユーザーは、「その他のルート証明書」セクションで DigiCert からDigiCert グローバルルート CAをダウンロードできます。

Java エージェントバージョン 6.2.0 - 6.4.2

Java agent version 6.2.0より、 use_private_ssl 設定オプションが再導入され、エージェントjarにバンドルされているSSL証明書を使用できるようになりました。以下のバンドルされているSSL証明書は、リリース後1年まで有効です。

META-INF/certs/eu-newrelic-com.pem
META-INF/certs/eu01-nr-data-net.pem
META-INF/certs/newrelic-com.pem

重要

Javaエージェントは、バンドルされている証明書の有効期限まで3ヶ月を切った場合、アプリケーションの起動時に警告メッセージの記録を開始します。

バンドルされた証明書の有効期限が切れると、JavaエージェントはNew Relicに接続できなくなるため、最新のエージェントバージョンにアップデートするか、 ca_bundle_path の設定を使って有効な証明書を提供する必要があります。

グローバル証明書を自分のローカルトラストストアに追加したいユーザーは、DigiCert社から DigiCert Global Root CA をダウンロードしてください。

YAMLベースの設定の使用

common:  default_settings
  ca_bundle_path: /path/to/digicert.pem
  use_private_ssl: false

  #
  # ============================== LICENSE KEY ===============================

  # You must specify the license key associated with your New Relic account
  ...

概要

エージェントが New Relic への安全な接続を確立するために使用する証明書を決定する 2 つの構成設定があります。use_private_sslとca_bundle_pathです。それらがどのように連携するかは次のとおりです。

DEFAULT: 設定オプション ( ca_bundle_path / use_private_ssl ) は両方ともデフォルト値を使用しているため、提供されません。エージェントは、Java Development Kit (JDK) にバンドルされているデフォルトの SSL 証明書を使用します。これらの証明書が存在しないか、New Relic を信頼する証明書が含まれていない場合、エージェントは接続しません。有効な証明書を JDK 証明書バンドルにマージする必要があります。
use_private_sslのみが構成されています。エージェントは、バンドルされている SSL 証明書を使用します。
ca_bundle_pathのみが構成されています。エージェントは、構成されたパスでカスタム SSL 証明書バンドルを使用して接続を試みます。構成されたカスタム証明書バンドルに New Relic を信頼する証明書が含まれていない場合、エージェントは接続しません。有効な証明書をカスタム証明書バンドルにマージする必要があります。
use_private_sslとca_bundle_pathの両方が構成されています。ca_bundle_path構成設定が優先され、 use_private_ssl構成は無視されます。この動作は、 ca_bundle_pathのみを指定した場合と同じです。

Java エージェントバージョン 6.0.0/6.1.0

6.0.0 以降、Java エージェントにはnrcertグローバル証明書チェーンが含まれなくなりました。グローバル証明書をローカルのトラストストアに追加したいユーザーは、DigiCert からDigiCert グローバルルート CAをダウンロードする必要があります。

注意: バージョン6.1.0+では、Javaエージェントはリリース後1年まで有効なNew Relicのバンドルされた証明書を使用します。証明書の有効期限が切れる前に、エージェントを最新のバージョンにアップデートするか、 ca_bundle_path の設定を使って有効な証明書を提供する必要があります。

重要

YAMLベースの設定の使用

common:  default_settings
  ca_bundle_path: /path/to/digicert.pem

  #
  # ============================== LICENSE KEY ===============================

  # You must specify the license key associated with your New Relic account
  ...

6.0.0 より前のバージョンの Java エージェント (非推奨)

Javaエージェントのバージョンが6.0.0より前の場合、有効な証明書を必要とするアプリケーションは、以下の2つの方法のいずれかで証明書を追加することができます。

YAMLベースの設定を使用します。
New Relic の信頼できる署名者のバンドルされたリストをローカルストアに追加します。

YAMLベースの設定の使用

New Relic Java エージェントは、信頼できる署名者のリストをエージェントnewrelic.jarファイルにまとめます。ローカルのトラストストアを変更したくない場合は、 newrelic.ymlエージェント構成ファイルでuse_private_sslをtrueに設定してアクティブ化できます。

common:  default_settings
  use_private_ssl: true

  #
  # ============================== LICENSE KEY ===============================

  # You must specify the license key associated with your New Relic account
  ...

この機械翻訳は、参考として提供されています。

期限切れのSSL証明書のお知らせと証明書の削除.css-21sua1{background:none;border:none;width:0;padding:0;}

注意

重要

Java エージェント バージョン 6.2.0 - 6.4.2

重要

Java エージェント バージョン 6.0.0/6.1.0

重要

YAMLベースの設定の使用

6.0.0 より前のバージョンの Java エージェント (非推奨)

YAMLベースの設定の使用

期限切れのSSL証明書のお知らせと証明書の削除

Java エージェントバージョン 6.2.0 - 6.4.2

Java エージェントバージョン 6.0.0/6.1.0