Windows11、Apacheでの自己証明書(オレオレ証明書)のやり方メモ

サービスワーカーやクリップボードなど、localhostやhttpsじゃないと処理できないjsの機能が最近多く、ローカルでの実装が大変なでWindows、Apache環境での警告が出ない自己証明書（オレオレ証明書）の入れ方の備忘録を残しておきます。

環境

• Windows11
• Apache2.4

手順

証明書発行

• Apacheのconf/openssl.confに、以下を追加します。

• 同じくconf/openssl.confで、[ v3_ca ]という段落があるので探して以下を追記します。

[ v3_ca ]
# 省略
subjectAltName=@alternate_names
keyUsage= digitalSignature, keyEncipherment
# 省略 copy_all

• 同じくconf/openssl.confで、copy_extensionsという項目があるので、探してコメントアウトします。

# copy_extensions = copy
↓
copy_extensions = copy copy_all

• 上記設定完了後にコマンドプロンプト開いてopensslコマンドで証明書を発行します。
  この時、あらかじめopenssl.confのパスを指定する必要があるため、setコマンドも実行しています。

> set OPENSSL_CONF=C:\XXXXX\XXXXX\conf\openssl.cnf
> openssl genrsa -out private.key 3072
Generating RSA private key, 3072 bit long modulus (2 primes)
# 省略
> openssl req -new -x509 -key private.key -sha256 -out certificate.pem -days 730
You are about to be asked to enter information that will be incorporated
# 省略
# 色々聞かれますが、全てエンターキーでOKです。
Country Name (2 letter code) [AU]:
State or Province Name (full name) [Some-State]:
# 省略
Common Name (e.g. server FQDN or YOUR name) []:
Email Address []:copy_all

証明書インストール

上記までの処理を行うと、実行したディレクトリ上に以下の二つのファイルが作成されます。

• private.key
  いわずもがな秘密鍵です。
• certificate.crt
  いわずもがな証明書です。

certificate.crtを信頼できる証明書としてインストールしていきます。

1. まず、certificate.crtをダブルクリックすると、以下のようなウィンドウが開きます。
   
   「証明書のインストール」ボタンをクリックします。
2. 証明書のインポートウィザードが開きます。
   保存場所の「ローカルコンピューター」をクリックし、「次へ」をクリックします。
   
3. 「証明書をすべて次のストアに配置する」をクリックし、「参照」ボタンをクリックします。
   
4. 「証明書ストアの選択」ウィンドウが開くので、「信頼されたルート証明機関」をクリックし、「OK」ボタンをクリックします。
   
5. インポートウィザードに戻るので、「次へ」ボタンをクリックします。
   
6. 完了画面が表示されるので、「完了」ボタンをクリックします。
   
   

• conf/httpd.confを開いて以下を追加します。
  AddHandler、AddTypeは自分の環境に合わせてPHPの設定を入れていますが、実際は各自の環境に合わせて変更ください。

<Directory "C:\xxx\xxx"> # C:\xxx\xxxに任意のテストしたいサイトのディレクトリ
    AllowOverride All
    Require all granted
    Options Indexes FollowSymLinks
    AddHandler php-script .php .html
    AddType application/x-httpd-php .php .html
</Directory>
<VirtualHost *:443>
  ServerName test.test:443 # test.testは任意のテスト用ドメイン
  DocumentRoot "C:\xxx\xxx"
  ErrorLog "logs/ssl-test-error.log"
  CustomLog "logs/ssl-test.log" common
  SSLEngine on
  # 証明書発行手順で発行した鍵のディレクトリとファイル名
  SSLCertificateFile "C:\xxx\xxx\xxx.crt"
  SSLCertificateKeyFile "C:\xxx\xxx\xxx.key"
</VirtualHost> copy_all

xxx.xxx.xxx.xxx    test.test 
# xxx.xxx.xxx.xxx: 自分のローカルIP 
# test.test: テスト用ドメイン copy_all

• コマンドプロンプトを起動し、httpdサービスを再起動します。

httpd -k restart
or 
httpd -k gracefulcopy_all

確認

httpsでテストサイトにアクセスし、警告が表示されないことを確認します。

（chromeで確認しています。EdgeやFireFoxでも同じ手順でいけるのかは不明。）

• ngrok等は一時的とはいえ外部にサービス公開されるので嫌
• サーバー用意してLet's Encrypt入れて開発環境をちゃんとするのは趣味なのにお金かかるので嫌
• localhostで使用出来る機能もあるけど、実環境はhttpsでアクセスするし、意外とhttps接続やドメイン由来のエラーも多いのでちゃんとローカルと実機環境を近づけたい
• 適当なオレオレ証明書だと都度警告画面が出て来るのが面倒

参考リンク

• Chrome: オレオレ証明書でもセキュリティ警告画面が出ないようにする方法
  内容はほぼ上記と同じですが、Windowsだと証明書作成時にsetコマンドで「openssl.cnf」のパスを指定する必要があったのと、証明書のインストール方法が微妙に違っていたので記事を作成しました。

set OPENSSL_CONF=C:\XXXXX\XXXXX\conf\openssl.cnfcopy_all