ローカルの開発環境でも本番に近い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を明示しておくのが確実です。
- マシン
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の公式ドキュメントもどうぞ。
Pleiades All in One を使っている場合、JDKはpleiades/java/以下に含まれています。コマンドプロンプト(またはターミナル)でそのbinディレクトリに移動します。
cd C:\pleiades\java\21\binPleiades以外のJDKを使っている場合はインストールディレクトリ内のbinに同様に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 365macOS/Linuxの場合は.\ではなく./です。-ext "SAN=dns:localhost,ip:127.0.0.1"はこの証明書で使用する接続先を指定しています。この例ではlocalhostと127.0.0.1を登録しています。PC名や別のIPアドレスで接続する場合はその名前やIPアドレスも証明書に含める必要があります。
キーストアに設定するパスワードを入力します。6文字以上である必要があります。このパスワードは後ほどserver.xmlに設定するので控えておきます。
キーストアのパスワードを入力してください:
新規パスワードを再入力してください:姓名・組織名・国コードなどを順番に聞かれます。開発環境用なので適当な値で問題ありません。空白のままEnterでもOKです。
姓名は何ですか。
[Unknown]: test1
組織単位名は何ですか。
[Unknown]: test2
組織名は何ですか。
[Unknown]: test3
都市名または地域名は何ですか。
[Unknown]: test4
都道府県名または州名は何ですか。
[Unknown]: test5
この単位に該当する2文字の国コードは何ですか。
[Unknown]: jp最後に確認が出るのでYを入力して次に進みます。
CN=test1, OU=test2, O=test3, L=test4, ST=test5, C=jpでよろしいですか。
[いいえ]: Y<tomcat>の鍵パスワードを求められます。この記事の設定例ではキーストアと同じパスワードを使うためそのままEnterを押します。
<tomcat>の鍵パスワードを入力してください
(キーストアのパスワードと同じ場合はRETURNを押してください):コマンドを実行したbinディレクトリにdev_ssl.jksが生成されています。このファイルはWebの公開エリア外に移動しておきます。
作成時に以下のような警告が表示されますが、開発用なので無視して問題ありません。
JKSキーストアは独自の形式を使用しています。”keytool -importkeystore -srckeystore dev_ssl.jks -destkeystore dev_ssl.jks -deststoretype pkcs12″を使用する業界標準の形式であるPKCS12に移行することをお薦めします。
Tomcatに証明書を設定する(server.xml の編集)
server.xmlに SSLのコネクター設定を追記します。Eclipse環境であれば下記をダブルクリックで開くのが手っ取り早いです。
プロジェクト・エクスプローラー → Servers → server.xml
以下は検証に使用したTomcat 8.5向けの設定例です。既存の8080ポートのConnectorは残し、その直後に8443ポートのConnectorを追加します。Tomcat 10.1を使用している場合は「Tomcat 10.1の場合」の設定例を使ってください。
<!-- デフォルトで存在する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 10.1の場合
Tomcat 10.1ではConnectorの中にSSLHostConfigとCertificateを配置し、Certificate側にキーストアの情報を指定します。前の手順で作成したdev_ssl.jksを使う場合の設定例は次のとおりです。
<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には接続できません。
作成した自己署名証明書を信頼済みとして登録していない場合はブラウザに証明書の警告が表示されます。「詳細設定」をクリックし、「(ホスト名)にアクセスする」リンクからページへ進みます。


証明書の警告が出る場合とサーバーへ接続できない場合では確認する箇所が異なります。
| 表示・症状 | 確認すること |
|---|---|
| 証明書の発行元を信頼できないという警告 | 自分で作成した開発用証明書か確認します。 |
| 接続が拒否される | Tomcatが起動しているか、8443のConnectorが正常に起動したかをEclipseのコンソールで確認します。 |
| HTTPSで404が表示される | アプリのコンテキストパスと配置状態を確認します。ルートの/にアプリがなければhttps://localhost:8443/だけでは目的の画面を表示できません。 |
| 起動時にキーストア関連のエラーが出る | ファイルのパス、パスワード、aliasが設定と一致しているか確認します。 |
証明書の詳細では作成した証明書が使われていることに加え、有効期間と接続先に対応する名前が「サブジェクトの別名(SAN)」に含まれていることを確認します。ブラウザでの確認画面は次の節に掲載しています。
Windowsで8443ポートへのTCP接続を確認したい場合はPowerShellを使う方法もあります。コマンドと結果の読み方はこちらで説明しています。証明書の信頼性やHTTPSでの表示は、ブラウザで確認してください。

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

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

迷いやすいポイント
Eclipseまわりの設定やトラブル対処をまとめて確認したい場合はこちらも参考になります。
まとめ
- keytoolはJDK/JREのbinディレクトリに含まれているよ。
-genkeypair -keyalg RSAで自己証明書(JKSファイル)を作成できるよ。- server.xmlのConnectorにSSL設定を追加するだけでhttpsが有効になるよ。
- 開発環境ではポート
443より8443を使うほうがトラブルが少ないよ。 - ブラウザの警告は自己証明書に対する正常な動作だよ。



