Eclipse+TomcatでHTTPSを設定する方法・自己署名証明書の作成から接続確認まで

このサイトはアフィリエイト広告(Amazonアソシエイト含む)を掲載しています。
Eclipseの開発環境をHTTPS化するイメージ。証明書、SSLの鍵マーク、localhost:8443を配置

ローカルの開発環境でも本番に近いHTTPS接続で動作を確認したい場面がありますよね。この記事ではEclipse上で起動するTomcatに自己署名証明書を設定しhttps://localhost:8443/でアクセスできるようにします。

今回はPleiades All in One(Eclipse + Tomcat)の構成でSSLを設定した手順をまとめます。JDKに同梱されているkeytoolコマンドで自己証明書(いわゆるオレオレ証明書)を作成しTomcatのserver.xmlに設定するだけなので、それほど難しくはありません。

この記事では Eclipse上で動かすローカル開発環境をHTTPS(SSL/TLS)対応させる方法を解説します。SSLエラーの対処ではなく、開発用の証明書を作成してHTTPS通信を有効化する手順です。

Eclipse上のTomcatをHTTPS化するにはkeytoolでlocalhost用の自己署名証明書を作成しserver.xmlの8443ポートへキーストアを設定します。Java 21ではキーストア形式の既定値がPKCS12なので、この記事のようにJKSを使う場合は-storetype JKSを明示しておくのが確実です。

検証環境(確認日:2025年12月)
マシン

MacBookAir M1, 2020

OS

macOS Sequoia 15.4.1

IDE

Pleiades All in One Eclipse 2025-09

Tomcat

8.5

Java

21

目次

keytool で自己証明書を作成する

JDKまたはJREのbinディレクトリにkeytoolが含まれています。WindowsでもmacOS/Linuxでも基本的に同じコマンドで作成できます。

keytoolの公式ドキュメントもどうぞ。

Step
keytool のある場所を確認する

Pleiades All in One を使っている場合、JDKはpleiades/java/以下に含まれています。コマンドプロンプト(またはターミナル)でそのbinディレクトリに移動します。

cd C:\pleiades\java\21\bin

Pleiades以外のJDKを使っている場合はインストールディレクトリ内のbinに同様にkeytoolがあります。

Step
keytool コマンドを実行する

-keystoreに出力するファイル名を指定します。ここではdev_ssl.jksという名前で作成します。

コマンド
.\keytool -genkeypair -alias tomcat -keystore dev_ssl.jks -storetype JKS -keyalg RSA -ext "SAN=dns:localhost,ip:127.0.0.1" -validity 365

macOS/Linuxの場合は.\ではなく./です。-ext "SAN=dns:localhost,ip:127.0.0.1"はこの証明書で使用する接続先を指定しています。この例ではlocalhostと127.0.0.1を登録しています。PC名や別のIPアドレスで接続する場合はその名前やIPアドレスも証明書に含める必要があります。

Step
パスワードを設定する

キーストアに設定するパスワードを入力します。6文字以上である必要があります。このパスワードは後ほどserver.xmlに設定するので控えておきます。

コマンド
キーストアのパスワードを入力してください:
新規パスワードを再入力してください:
Step
証明書の属性情報を入力する

姓名・組織名・国コードなどを順番に聞かれます。開発環境用なので適当な値で問題ありません。空白のままEnterでもOKです。

コマンド
姓名は何ですか。
  [Unknown]:  test1
組織単位名は何ですか。
  [Unknown]:  test2
組織名は何ですか。
  [Unknown]:  test3
都市名または地域名は何ですか。
  [Unknown]:  test4
都道府県名または州名は何ですか。
  [Unknown]:  test5
この単位に該当する2文字の国コードは何ですか。
  [Unknown]:  jp
Step
確認

最後に確認が出るのでYを入力して次に進みます。

コマンド
CN=test1, OU=test2, O=test3, L=test4, ST=test5, C=jpでよろしいですか。
  [いいえ]:  Y
Step
鍵パスワードの入力

<tomcat>の鍵パスワードを求められます。この記事の設定例ではキーストアと同じパスワードを使うためそのままEnterを押します。

コマンド
<tomcat>の鍵パスワードを入力してください
        (キーストアのパスワードと同じ場合はRETURNを押してください):
Step
作成完了

コマンドを実行したbinディレクトリにdev_ssl.jksが生成されています。このファイルはWebの公開エリア外に移動しておきます。

作成時に以下のような警告が表示されますが、開発用なので無視して問題ありません。

JKSキーストアは独自の形式を使用しています。”keytool -importkeystore -srckeystore dev_ssl.jks -destkeystore dev_ssl.jks -deststoretype pkcs12″を使用する業界標準の形式であるPKCS12に移行することをお薦めします。

この警告はJKS形式がPKCS12形式より古い独自仕様であることを示しています。本番環境であれば移行を検討すべきですが、開発用の自己証明書としてはJKSのままで動作します。

Tomcatに証明書を設定する(server.xml の編集)

server.xmlに SSLのコネクター設定を追記します。Eclipse環境であれば下記をダブルクリックで開くのが手っ取り早いです。

プロジェクト・エクスプローラー → Servers → server.xml

以下は検証に使用したTomcat 8.5向けの設定例です。既存の8080ポートのConnectorは残し、その直後に8443ポートのConnectorを追加します。Tomcat 10.1を使用している場合は「Tomcat 10.1の場合」の設定例を使ってください。

server.xml
<!-- デフォルトで存在する8080ポートの設定 -->
<Connector connectionTimeout="20000" maxParameterCount="1000"
           port="8080" protocol="HTTP/1.1" redirectPort="8443"/>

<!-- 追加するSSLの設定 -->
<Connector
    port="8443"
    protocol="HTTP/1.1"
    SSLEnabled="true"
    scheme="https"
    secure="true"
    keystoreFile="【証明書のファイルパス】"
    keystorePass="【証明書のパスワード】"
    keystoreType="JKS"
    keyAlias="tomcat" />
  • port
    SSLでアクセスするポート番号です。443はOS側でroot/管理者権限が必要になる場合があるため、開発環境では8443を使うのが無難です。
  • keystoreFile
    Step7で移動したdev_ssl.jksの絶対パスを指定します。相対パスを使う場合の基準は実行中のTomcatのCATALINA_BASEです。
  • keystorePass
    Step3で設定したキーストアのパスワードを指定します。

編集するのはEclipseのServersプロジェクト内にある起動対象のTomcatに対応したserver.xmlです。Tomcatのインストール先にある同名ファイルと取り違えないようにしてください。

保存後、Serversビューで対象のTomcatを右クリックし、「公開(Publish)」を実行してから再起動します。「公開」はEclipseで編集した設定やアプリを実行先へ反映する操作です。インターネットへ公開する操作ではありません。

Tomcat 8.5は2024年3月31日にサポートを終了しています。上の設定は既存環境を確認するための参考とし、新しく環境を用意する場合はサポート中のバージョンを使用してください。

Tomcat 10.1の場合

Tomcat 10.1ではConnectorの中にSSLHostConfigとCertificateを配置し、Certificate側にキーストアの情報を指定します。前の手順で作成したdev_ssl.jksを使う場合の設定例は次のとおりです。

server.xml
<Connector
    port="8443"
    protocol="org.apache.coyote.http11.Http11NioProtocol"
    SSLEnabled="true">
    <SSLHostConfig>
        <Certificate
            certificateKeystoreFile="【dev_ssl.jksの絶対パス】"
            certificateKeystorePassword="【キーストアのパスワード】"
            certificateKeystoreType="JKS"
            certificateKeyAlias="tomcat"
            type="RSA" />
    </SSLHostConfig>
</Connector>

8443ポートのConnectorをすでに追加している場合はそのConnectorを上の設定へ置き換えます。(8443ポートのConnectorが2つ存在することがないように設定する。)

certificateKeystoreFileには移動後のdev_ssl.jksの絶対パスを指定します。鍵パスワードをキーストアのパスワードと別にした場合はCertificateにcertificateKeyPassword="【鍵パスワード】"も指定してください。


HTTPSの標準ポートは443番ですが設定を合わせれば別の番号でも通信できます。標準の番号を誰が管理しているのか、登録番号と違うポートでも動く理由はこちらで説明しています。

ブラウザでアクセスして確認する

Tomcatを起動したPCのブラウザでhttps://localhost:8443/【アプリのコンテキストパス】を開きます。たとえば普段のURLがhttp://localhost:8080/sample/なら確認するURLはhttps://localhost:8443/sample/です。

localhostはブラウザを動かしているPC自身を指します。別のPCやスマートフォンで同じURLを開いても開発用Tomcatには接続できません。

作成した自己署名証明書を信頼済みとして登録していない場合はブラウザに証明書の警告が表示されます。「詳細設定」をクリックし、「(ホスト名)にアクセスする」リンクからページへ進みます。

ChromeでlocalhostにHTTPS接続した際にNET::ERR_CERT_AUTHORITY_INVALIDの警告が表示され、「詳細設定」ボタンを赤枠で示した画面
証明書エラーの警告画面で「詳細設定」をクリックします
Chromeで自己署名証明書を使用したlocalhostへのHTTPS接続時に警告の詳細を開き、「localhostにアクセスする」リンクを赤枠で示した画面
自己署名証明書の警告から「localhostにアクセスする」をクリックして先へ進みます

証明書の警告が出る場合とサーバーへ接続できない場合では確認する箇所が異なります。

表示・症状確認すること
証明書の発行元を信頼できないという警告自分で作成した開発用証明書か確認します。
接続が拒否されるTomcatが起動しているか、8443のConnectorが正常に起動したかをEclipseのコンソールで確認します。
HTTPSで404が表示されるアプリのコンテキストパスと配置状態を確認します。ルートの/にアプリがなければhttps://localhost:8443/だけでは目的の画面を表示できません。
起動時にキーストア関連のエラーが出るファイルのパス、パスワード、aliasが設定と一致しているか確認します。

この操作は自分で作成した証明書とわかっている開発環境でのみ行ってください。見知らぬサイトでこの警告が出た場合は同様の操作はお勧めしません。

証明書の詳細では作成した証明書が使われていることに加え、有効期間と接続先に対応する名前が「サブジェクトの別名(SAN)」に含まれていることを確認します。ブラウザでの確認画面は次の節に掲載しています。


Windowsで8443ポートへのTCP接続を確認したい場合はPowerShellを使う方法もあります。コマンドと結果の読み方はこちらで説明しています。証明書の信頼性やHTTPSでの表示は、ブラウザで確認してください。

ブラウザで証明書の内容をみてみる

作成した証明書の内容をブラウザで見てみます。アドレスバーの部分から確認できます。

EclipseでSSL設定したlocalhostをChromeで開き、アドレスバーの「保護されていない通信」から「証明書の詳細」を選択する画面
「保護されていない通信」を開き、「証明書の詳細」をクリックしてSSL証明書を確認します

入力した姓名・組織名などを確認できます。有効期間と「サブジェクトの別名(SAN)」も開きこの手順で指定したlocalhostと127.0.0.1が含まれているか確認してください。

証明書ビューアの発行先に表示された一般名test1、組織test3、組織単位test2を赤枠で示した画面
keytoolで入力した一般名・組織名・組織単位が証明書の発行先に反映されています。

迷いやすいポイント

「接続がプライベートではありません」警告を毎回スキップするのが面倒

警告を出さずに接続するには使用するOSやブラウザで開発用の証明書を信頼する設定が必要です。登録先や操作は環境によって異なります。

dev_ssl.jksには秘密鍵も含まれています。ブラウザへ登録する証明書とTomcatが使うキーストアを混同しないようにしてください。

keytoolが見つからないと言われる

JDKのbinディレクトリにパスが通っていない可能性があります。java -versionが通るか確認し、同じディレクトリのkeytoolを実行してみてください。Pleiades All in One に含まれるJDKのパスはpleiades/java/【バージョン】/binです。


Windowsでkeytoolをどこからでも実行したい場合はPathの仕組みと設定方法をこちらで整理しています。

開発環境でSSLは必須?

すべての開発環境で必須ではありません。本番と同じHTTPS接続で動作を確認したい場合や利用するサービスがHTTPSのコールバックURLを要求する場合に設定します。localhostを例外扱いするブラウザやサービスもあるため、必要な条件を確認してください。

自己署名証明書でも問題ない?

自分のPC内でHTTPS接続を確認する用途には使えます。接続するブラウザやアプリがその証明書を信頼するとは限りません。一般公開するWebサイトでは利用者のブラウザが信頼する認証局から発行された証明書を使用してください。


Eclipseまわりの設定やトラブル対処をまとめて確認したい場合はこちらも参考になります。

まとめ

  • keytoolはJDK/JREのbinディレクトリに含まれているよ。
  • -genkeypair -keyalg RSAで自己証明書(JKSファイル)を作成できるよ。
  • server.xmlのConnectorにSSL設定を追加するだけでhttpsが有効になるよ。
  • 開発環境ではポート443より8443を使うほうがトラブルが少ないよ。
  • ブラウザの警告は自己証明書に対する正常な動作だよ。
  • URLをコピーしました!
目次