Ubuntuに独自CAを追加してHTTPSを信頼させる方法
opensslでプライベートCAとリーフ証明書を作成し、ルート証明書を/usr/local/share/ca-certificatesへ配置してupdate-ca-certificatesを実行します。Ubuntu 24.04での手順と検証結果を確認できます。
Ubuntu の信頼ストアに独自の CA を追加する
独自の CA を Ubuntu の信頼ストアに追加するには、ルート証明書を /usr/local/share/ca-certificates/ に .crt で終わる名前でコピーし、その後 sudo update-ca-certificates を実行します。CA(認証局)は、他の証明書への署名を許可された証明書を持つ鍵ペアです。マシンがルートを信頼すると、そのルートが署名したすべての証明書が受け入れられるため、自分のサービス間の HTTPS で検証エラーが発生しなくなります。
このガイドでは、openssl を使って証明書チェーン全体をオフラインで構築します。ルート鍵とルート証明書を作成し、サーバー用のリーフ証明書を 1 つ発行してから、ルートをインストールします。その後、同じ検証コマンドの結果がどのように変わるかを確認します。この順序が重要です。インストール前後で検証することで、結果を変えたのがインストールであることを確認できます。
Ubuntu 24.04 のデフォルトイメージには OpenSSL 3 と ca-certificates パッケージが含まれているため、最初にインストールするものはありません(2026 年 8 月に確認済みです)。
独自の CA を運用すべきタイミング
Let's Encrypt などのパブリック CA では、パブリック DNS に登録された名前と、CA から到達できるサーバーが必要です。内部名は対象になりません。プライベートネットワーク上のデータベースや、トンネルにバインドされた管理パネルは、パブリック証明書を取得できません。証明書を取得するためだけにインターネットへ公開すべきでもありません。
Ubuntu 上の自己署名証明書で解決できるのは、1 台のホストだけです。すべてのクライアントでその証明書を信頼する必要があり、次のホストでは同じ作業を繰り返します。プライベート CA では、信頼の設定を 1 段階上に移せます。クライアントでルート証明書を 1 回信頼すれば、その後にルートが署名するすべての証明書が信頼されます。まだ存在しないホスト向けの証明書も対象です。
コストも無視できません。ルートキーは、制約で許可されたあらゆる証明書に署名できます。そのため、ca.key を読める人物は、マシンが受け入れる証明書を発行できます。SSH キー管理で秘密鍵を保護する場合と同じ方法で、ルートキーを保護してください。サービスにパブリック DNS 名がある場合は、これらをすべて省略してパブリック CA を使用します。nginx と Let's Encrypt で Certbot を使用するほうが作業が少なく、クライアント側に何もインストールする必要がありません。
CA 鍵とルート証明書を作成する
自分のユーザーだけが開けるディレクトリで作業します。ルート鍵をそのディレクトリの外に出してはいけません。
install -d -m 700 ~/ca
cd ~/ca
openssl genrsa -aes256 -out ca.key 4096
chmod 600 ca.key-aes256 は、選択したパスフレーズで鍵を暗号化します。この鍵で署名する後続のコマンドでは、毎回そのパスフレーズが必要です。別の方法で -passin を指定しない限り、OpenSSL は端末でパスフレーズを求めます。-passin にはファイルまたは環境変数を指定できるため、自動化のために配置した場所でも鍵を保護する必要があります。-aes256 を省略すると、鍵は平文のままディスクに保存されます。その場合、バックアップまたは別の管理者アカウントだけで、あなたのマシンが信頼する証明書を発行できる状態になります。
次に、CA 鍵自身で署名するルート証明書を作成します。
openssl req -x509 -new -key ca.key -sha256 -days 3650 \
-subj "/O=Example Internal/CN=Example Internal Root CA" \
-addext "basicConstraints=critical,CA:TRUE,pathlen:0" \
-addext "keyUsage=critical,keyCertSign,cRLSign" \
-addext "subjectKeyIdentifier=hash" \
-addext "nameConstraints=critical,permitted;DNS:internal.example" \
-out ca.crtinternal.example を実際に使用する名前のサフィックスに置き換えます。最後の拡張を残す前に、次のセクションを読んでください。
各拡張には1つの役割があります。
basicConstraintsとCA:TRUEにより、これが CA 証明書になります。これがないと、署名自体が正しくても、この鍵で署名した証明書をクライアントは拒否します。pathlen:0は、CA がリーフ証明書を署名できること、およびその下位に追加の CA を置けないことを示します。keyUsageは、鍵の用途を証明書と失効リストへの署名に限定します。そのため、誤って同じ鍵を TLS サーバー鍵として使用できません。subjectKeyIdentifierは、ルートに識別子を付与します。リーフ証明書はこの識別子を参照するため、数百の証明書を含むストア内からクライアントが正しい発行者を見つけられます。nameConstraintsは、この CA が保証できる名前を制限します。
コマンドが意図どおりに動作したと仮定せず、作成した内容を読み取って確認します。
openssl x509 -noout -subject -issuer -serial -dates -in ca.crt
openssl x509 -noout -text -in ca.crtルート証明書は自分自身で署名するため、Subject と issuer には同じ文字列が表示されます。serial と2つの日付は、直前に作成したファイルの内容に基づきます。そのため、ガイドに記載された値ではなく、その出力から確認してください。
CA が署名できる範囲を制限する
システムストアに登録された root は、別途指定しない限り、インターネット上のすべての名前を信頼します。1 台のサーバーにある 1 つのファイルに、これほど大きな権限を持たせることになります。nameConstraints でその範囲を制限できます。root に permitted;DNS:internal.example を設定すると、internal.example の範囲外の名前に対するこの CA からのチェーンは、署名が正しくても拒否されます。
信頼ストアに登録するのではなく、その動作をテストします。
openssl req -new -newkey rsa:2048 -nodes -keyout /tmp/outside.key -out /tmp/outside.csr \
-subj "/CN=www.example.com"
openssl x509 -req -in /tmp/outside.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
-days 30 -sha256 \
-extfile <(printf 'subjectAltName=DNS:www.example.com\n') -out /tmp/outside.crt
openssl verify -CAfile ca.crt /tmp/outside.crt
echo $?CA は要求された内容に対して署名するため、証明書自体は発行されます。失敗するのは検証時です。終了ステータスは 0 以外になり、OpenSSL は該当した制約を示します。これが拡張機能の効果です。CA の鍵が盗まれても、サブツリーの範囲外の名前に対して有効な証明書を作成することはできません。完了したら rm /tmp/outside.* で残ったファイルを削除します。
制約を適用する前に、4 つの点を理解しておく必要があります。この拡張機能には critical が付いているため、拡張機能を理解しないクライアントは無視せず、チェーンを拒否する必要があります。これは安全な動作ですが、古い TLS ライブラリでは問題になることがあります。DNS 名に対する許可サブツリーは、IP アドレスの SAN を制限しません。サブツリーが指定されていない名前の種類は制限されないため、証明書に IP アドレスを含める場合は、同じ拡張機能に permitted;IP:10.0.0.0/255.255.0.0 も追加します。サブツリーには、今後発行するすべての名前を含める必要があります。短いホスト名も対象です。そのため、単独の名前 app に対する証明書は、上記の例では検証に失敗します。さらに、この制約は root に組み込まれます。方針を変更する場合は、新しい root 証明書を作成し、すべてのクライアントに再インストールする必要があります。
CA で署名したリーフ証明書を発行する
リーフ証明書は、サーバーがクライアントに提示する証明書です。まず、リーフ証明書用の鍵と CSR(certificate signing request)を作成します。CSR には公開鍵と要求する名前が含まれます。また、リーフ鍵で署名することで、要求者が秘密鍵を保持していることを証明します。
openssl req -new -newkey rsa:2048 -nodes \
-keyout app.key -out app.csr \
-subj "/CN=app.internal.example"
chmod 600 app.key重要な名前は CSR ではなく、拡張ファイルに記載します。クライアントはホスト名を subjectAltName(SAN)と照合します。ブラウザーと Go は common name を完全に無視します。curl など、現在も common name にフォールバックするクライアントも、証明書に DNS または IP の SAN が1つもない場合に限って使用します。そのため、CN があり SAN がない証明書は、一部のツールでは機能しても、別のツールでは失敗します。SAN にはすべての名前を列挙し、CN はラベルとして扱ってください。
basicConstraints = CA:FALSE
keyUsage = critical, digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = DNS:app.internal.example, DNS:api.internal.example
subjectKeyIdentifier = hash
authorityKeyIdentifier = keyid:alwaysこれを app.ext として保存し、CA でリクエストに署名します。
openssl x509 -req -in app.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
-days 397 -sha256 -extfile app.ext -out app.crt-CAcreateserial は CA の隣に ca.srl を作成します。このファイルには次のシリアル番号が記録されるため、この CA から発行した証明書でシリアル番号が重複しません。このファイルは CA ディレクトリに保管してください。-days 397 は選択項目であり、ツールによる制限ではありません。ここでは公開 CA の場合よりも短い有効期間が重要です。プライベート CA には失効インフラストラクチャがないためです。自分で構築しない限り CRL も OCSP responder も存在しません。そのため、漏えいしたリーフ鍵は証明書の有効期限が切れるまで使用可能なままです。
trust store に触れる前に、結果を確認します。
openssl x509 -noout -subject -issuer -serial -dates -in app.crt
openssl x509 -noout -ext subjectAltName -in app.crtissuer 行には、リーフ証明書自身ではなく CA の名前が表示されます。SAN 行には、この証明書が有効な名前が列挙されます。クライアントはその一覧だけを照合します。
明示的な -CAfile を指定して、インストール前に確認する
openssl verify -CAfile ca.crt app.crt
echo $?これは、app.crt が ca.crt の証明書まで連鎖するかという、1 つの点だけを確認します。コマンドラインで root を OpenSSL に渡しているため、このマシンが何を信頼しているかは確認できません。ここで失敗する場合は、証明書自体に問題があります。先に修正してから続行してください。
次に、マシンの信頼ストアを確認します。
openssl verify app.crt
echo $?-CAfile を指定しない場合、OpenSSL は組み込みの証明書ディレクトリを使用します。openssl version -d はビルドで使用されるベースディレクトリを表示します。Ubuntu では、その下の certs ディレクトリは /etc/ssl/certs に解決されます。まだ root はそこにないため、検証は失敗します。証明書チェーンは、ストアにない発行者まで到達し、追加で確認できる場所も残っていないためです。終了ステータスを確認してください。2 ステップ後に変わるのは、この値です。
openssl verify よりも、実際のクライアントを使うほうが適切です。証明書チェーンだけでなく、ホスト名も確認できるためです。証明書を提供して取得します。
openssl s_server -accept 8443 -cert app.crt -key app.key -www &
curl --resolve app.internal.example:8443:127.0.0.1 https://app.internal.example:8443/--resolve は接続先を 127.0.0.1 にしながら、app.internal.example を要求します。そのため SAN が一致し、残る問題は信頼だけになります。curl は失敗し、証明書チェーンを検証できなかった理由を表示します。詳細を表示するには -v を追加してください。テストサーバーは起動したままにします。
ルート証明書を /usr/local/share/ca-certificates にインストールする
sudo cp ca.crt /usr/local/share/ca-certificates/example-internal-root.crt
sudo chmod 644 /usr/local/share/ca-certificates/example-internal-root.crt
sudo update-ca-certificatesこれが正しく機能するかどうかを左右する詳細は以下の通りです。
- ファイル名は
.crtで終わる必要があります。update-ca-certificatesのマニュアルページには、/usr/local/share/ca-certificates配下にある.crt拡張子の証明書がインクルードされ、暗黙的に信頼されると記載されています。root.pemやroot.cerという名前のファイルは、何も通知されずにスキップされます。 - 内容は PEM 形式である必要があります。これは
BEGIN CERTIFICATEおよびEND CERTIFICATE行で囲まれた base64 ブロックです。update-ca-certificatesはファイルの中身を精査しないため、DER ファイルを.crtにリネームしてもスキップされません。その場合、/etc/ssl/certsにリンクされ、クライアントが PEM テキストを期待しているバンドルに生のバイト列が追記されますが、追加されたものとしてカウントされます。コピー前にopenssl x509 -noout -subject -in ca.crtでファイルを確認してください。DER 入力の場合は失敗するため、その際はopenssl x509 -inform DER -in ca.der -out ca.crtで変換してください。 - ここに配置すべきはルート証明書のみです。CA の秘密鍵やリーフ証明書を信頼ストアに含めてはいけません。
update-ca-certificates は、追加および削除された証明書の数を表示します。追加数が 0 の場合、原因はファイル名の拡張子にあります。カウントが 1 であっても、それは .crt ファイルが見つかったことを意味するだけであり、ファイルが有効な証明書を保持しているとは限りません。そのため、そのメッセージではなくシステム側から変更を確認してください。
ls -l /etc/ssl/certs/$(openssl x509 -noout -subject_hash -in /usr/local/share/ca-certificates/example-internal-root.crt).0
grep -c 'BEGIN CERTIFICATE' /etc/ssl/certs/ca-certificates.crt最初のコマンドは、証明書自身のサブジェクトハッシュからファイル名を生成し、一覧表示します。update-ca-certificates は openssl rehash を実行してそのシンボリックリンクを作成しており、インストールしたファイルを指しています。DER ファイルの場合、openssl rehash は PEM として読み取れないファイルのハッシュリンクを作成しないため、このチェックで失敗します。2 番目のコマンドは、単一ファイルバンドル内の証明書数をカウントします。インストール前にも実行し、数値が 1 増えることを確認してください。
この root を別のマシンへコピーする場合は、インストールする前にコピーが完全に到着したことを確認してください。root 証明書は、内容を誤るとシステムに深刻な影響を与えるファイルです。そのため、使用前に チェックサムで検証する他のダウンロードと同じように扱います。Rocky Linux と AlmaLinux のマシンでは、root を別のディレクトリと update-ca-trust で取り込み、update-ca-certificates は使用しません。そのため、これらの環境では Rocky Linux と AlmaLinux で CA を追加する手順に従ってください。
システムストアに対して再度検証する
openssl verify app.crt
echo $?
curl --resolve app.internal.example:8443:127.0.0.1 https://app.internal.example:8443/同じコマンド、同じ証明書ファイルでも、結果は異なります。app.crtには何も変更を加えておらず、サーバーも先ほど起動したものです。唯一の違いは、クライアントが参照するストアに root が配置されたため、チェーンが完成したことです。覚えておくべき仕組みは、検証とはクライアントがすでに信頼している発行者を検索する処理であり、CA をインストールすると、その発行者が検索対象の場所に登録されるということです。
kill %1でテストサーバーを停止します。
なぜ /etc/ssl/certs にファイルを配置してはいけないのか
/etc/ssl/certs は生成された出力です。update-ca-certificates は、実際の証明書ファイルへのシンボリックリンクをそこに作成し、連結されたバンドルファイルである /etc/ssl/certs/ca-certificates.crt をその隣に書き出します。
手動でそのディレクトリにコピーした証明書は、どのプロセスからも認識されません。OpenSSL のディレクトリ検索は、証明書のサブジェクトハッシュに基づいて命名されたファイルしか開かないため、myca.crt という名前のファイルは無視されます。Ubuntu 上の curl はバンドルファイルを読み込みますが、このバンドルは登録済みのソースから再構築されるため、コピーしたファイルはそこにも含まれません。update-ca-certificates --fresh は、2 つのソースディレクトリを指すリンクや、リンク切れとなったものを削除し、ソースに含まれるものだけを再構築します。
もう一方の半分は /usr/share/ca-certificates であり、これは ca-certificates パッケージに属し、/etc/ca-certificates.conf にリストされています。パッケージの更新によってこのファイルは上書きされます。/usr/local/share/ca-certificates はローカル管理者のために予約されたディレクトリであるため、残りの部分を管理するパッケージがアップグレードされても、配置した CA 証明書は保持されます。
システムの trust store を使用しないプログラム
OpenSSL を呼び出すか /etc/ssl/certs を読み取るプログラムには、root をインストールすれば対応できます。curl、wget、git、Python の標準 ssl モジュール、Linux でシステムファイルを読み取る Go プログラムが該当します。独自の証明書リストを同梱するランタイムには影響しません。インストールが正常に完了した後も混乱が生じる主な原因はここにあります。
- Node.js はコンパイル済みのリストを使用します。プロセスの開始前に環境変数で
NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/example-internal-root.crtを設定し、root を指定してください。Node は起動時にこの変数を 1 回だけ読み取るためです。現在の Node リリースには、システムの store を読み取るオプションもあります。node --help | grep -i system-caを実行して、使用中のバージョンに対応しているか確認してください。 - Python の
requestsライブラリはcertifibundle を使用します。そのプロセスにREQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crtを設定するか、呼び出し時にverify="/etc/ssl/certs/ca-certificates.crt"を渡してください。pipも同じ理由で--certを受け取ります。 - Java は keystore を読み取ります。Ubuntu では
ca-certificates-javapackage が/etc/ca-certificates/update.d/に hook をインストールします。その package が存在すれば、update-ca-certificatesによって Java keystore も更新されます。存在しない場合は、keytool -importcertで root を import してください。 - Firefox は独自の store を保持しており、
/etc/ssl/certsを参照しません。証明書設定から import してください。Linux の Chromium はユーザーごとの NSS database を読み取ります。libnss3-toolspackage のcertutilで編集します。 - コンテナには独自の filesystem があるため、host の store はコンテナ内では意味を持ちません。root を image にコピーし、build 中に
update-ca-certificatesを実行してください。サービスを VPS 上の Docker Compose で実行する場合は、この点をあらかじめ考慮してください。
正常にインストールした後もプログラムが証明書を拒否する場合は、ほかの変更を加える前に、どのファイルを開いているか確認してください。strace -f -e trace=openat <command> 2>&1 | grep -i cert は単純な方法ですが、多くの場合この疑問に答えられます。これは openat 呼び出しだけを追跡し、パスに cert という語を含まない bundle を filter で隠します。そのため何も出力されない場合は、プログラムがファイルを読み取っていないと判断する前に、grep なしでもう一度実行してください。コンパイル済みのリストを使用している場合は、ファイルを読み取らないように見えます。
長期的に CA を使用できる状態に保つ
リーフ証明書を再発行するには、同じ app.ext ファイルを使って、CSR の作成手順と署名手順をもう一度実行します。信頼する root が変わっていないため、クライアント側での作業は不要です。次回の発行を記憶から再構築せず、正常に動作したコマンドを再実行できるよう、CA ディレクトリ内の ca.srl とすべての .ext ファイルを保持してください。
ca.key と ca.crt は、暗号化したままマシンの外部にもバックアップしてください。鍵を失うと、新しい証明書を発行できません。2 つ目の CA を構築し、その root を、最初の CA の root を配置したすべての場所にインストールする必要があります。root を受け取ったすべてのマシンとアプリケーションストアを記録した一覧を作成してください。この一覧がなければ、ローテーションや削除を実施できません。
root 自体の有効期限が近づいたら、早めに後継の root を生成し、両方の root を並行してインストールします。ストアに 2 つの root があっても問題なく、クライアントはどちらも受け入れられます。新しい root でリーフ証明書を再発行し、古い root に依存するものがなくなったら削除します。
信頼ストアからCAを削除する
sudo rm /usr/local/share/ca-certificates/example-internal-root.crt
sudo update-ca-certificates --fresh--freshを実行すると、/etc/ssl/certs内にあるソースディレクトリへのシンボリックリンクが削除されます。これには、削除したファイルによってリンク切れとなったものも含まれます。その後、残っているソースからリンクが再構築されるため、削除されたルート証明書はディレクトリとバンドルの両方から取り除かれます。インストール時と同様の方法で、削除が正しく行われたかを確認してください。
openssl verify app.crt
echo $?
grep -c 'BEGIN CERTIFICATE' /etc/ssl/certs/ca-certificates.crt
ls -l /etc/ssl/certs/$(openssl x509 -noout -subject_hash -in ~/ca/ca.crt).0検証が再び失敗し、証明書の数が元の状態に戻り、ハッシュ化されたシンボリックリンクが消えていれば完了です。
このコマンドはシステムストアのみを変更します。その他の場所で行ったインストールは手作業で取り消してください。NODE_EXTRA_CA_CERTSをクリアし、Javaのキーストアからエイリアスを削除し、各ブラウザプロファイルからルート証明書を削除し、それを組み込んでいるコンテナイメージを再ビルドしてください。ルート証明書を削除しても、その証明書が署名した証明書は無効になりません。それらを信頼しているすべてのマシン上で有効なままとなります。これが、プライベートCAを運用する際にルート証明書の配布先リストを記録しておく必要がある実務上の理由です。完全に撤回できないCAは恒久的なセキュリティホールとなります。リストが短いうちに、セットアップした当日に1台のマシンで削除のテストを行ってください。
FAQ
Ubuntu で CA 証明書を配置する場所はどこですか?
/usr/local/share/ca-certificates/ に配置します。ファイル名は .crt で終わる必要があり、内容は PEM 形式である必要があります。その後、sudo update-ca-certificates を実行してください。このディレクトリはローカル管理者のために予約されているため、パッケージのアップグレードによって変更されることはありません。/usr/share/ca-certificates は ca-certificates パッケージに属しており、/etc/ssl/certs は両方のディレクトリから生成されます。そのため、これらのディレクトリにファイルを配置すると、上書きされるか無視されます。
update-ca-certificates を実行しても curl が証明書を拒否するのはなぜですか?
以下の原因を順に確認してください。ファイル名が .crt で終わっていない場合、update-ca-certificates はそのファイルをスキップし、何も追加しません。また、ファイルが PEM ではなく DER 形式である可能性があります。このツールは形式を検知しません。DER 形式でもシンボリックリンクを作成してバンドルに追加し、追加済みとしてカウントしますが、ハッシュリンクは作成されません。PEM に変換してファイルを置き換え、再度コマンドを実行してください。証明書の subjectAltName に接続先のホスト名が含まれていない可能性もあります。これは信頼性の問題ではなくホスト名の不一致です。curl は証明書に DNS や IP SAN が全く含まれていない場合にのみ Common Name にフォールバックするため、openssl x509 -noout -ext subjectAltName -in app.crt で確認してください。サーバーが中間証明書を送信しておらず、クライアント側でそれが必要な場合もあります。また、CURL_CA_BUNDLE や --cacert によって curl が別のバンドルを参照している可能性もあります。さらに、長時間実行されているサービスは、起動時に一度だけ信頼ストアを読み込むプログラムが多いため、再起動が必要です。
システムの信頼ストアは Firefox、Chrome、Node、Java にも適用されますか?
いいえ。curl、wget、git、Python の標準 ssl モジュール、および Go プログラムはシステムファイルを読み込むため、update-ca-certificates を実行すればすぐに反映されます。Firefox は独自のストアを保持しています。Linux 版 Chromium はユーザーごとの NSS データベースを使用しており、libnss3-tools パッケージに含まれる certutil で編集します。Node.js は NODE_EXTRA_CA_CERTS でルート証明書を指定する必要があります。Java はキーストアを読み込みますが、update-ca-certificates がそれを更新するのは ca-certificates-java パッケージがインストールされている場合のみです。Python の requests は certifi を使用するため、REQUESTS_CA_BUNDLE が必要です。
Ubuntu の信頼ストアから CA を削除するにはどうすればよいですか?
/usr/local/share/ca-certificates/ からファイルを削除し、sudo update-ca-certificates --fresh を実行してください。--fresh オプションは、ソースディレクトリを指す /etc/ssl/certs 内のシンボリックリンクをクリアして再構築するため、証明書はハッシュシンボリックリンクと ca-certificates.crt バンドルから同時に削除されます。その CA が署名した証明書に対して openssl verify を実行し、終了ステータスを確認してください。このコマンドは他のストアには影響しないため、追加したすべてのストアで同様に削除作業を行ってください。
公開サイトで Let's Encrypt の代わりにプライベート CA を使用できますか?
いいえ。訪問者のブラウザはあなたのルート証明書を信頼していないため、全画面の警告が表示されます。また、管理下にないマシンにルート証明書をインストールさせることはできません。プライベート CA は、自社内のマシンのみが解決する名前や、管理しているクライアントのために使用するものです。不特定多数が訪問するサイトには、パブリック CA から証明書を取得してください。