0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

DockerfileでCA証明書を扱う 基本設定と追加時の注意点

0
Last updated at Posted at 2026-09-18

DockerfileでCA証明書を扱う 基本設定と追加時の注意点のアイキャッチ

はじめに

DockerコンテナからHTTPSでAPIを呼び出すときは、接続先を確認するためのCA証明書も実行環境に必要です。

ただ、Dockerfileに証明書のファイル名を書けば準備が終わるわけではありません。ファイルの用意、イメージへのコピー、信頼ストアへの登録、実行時の確認までを順番に進めます。

この記事では、Debian系のコンテナを例に、 CA証明書の基本設定と、独自のCAを追加する場合の注意点 を整理します。

先に押さえること

  • 一般的な公開CAの証明書は、まずOSのca-certificatesパッケージで管理する。
  • 組織内のCAなどを追加するときは、信頼してよい証明書を用意し、COPYしてから登録する。
  • ファイルの存在、信頼ストアへの登録、アプリの接続成功は、それぞれ確認する。
  • マルチステージビルドでは、実際に動かす最終イメージへ設定を引き継ぐ。

1. CA証明書と信頼ストアとは

CAは「証明書を発行する認証局」

CAは Certificate Authority(認証局) の略です。証明書を申請した相手がそのドメインを使う権限などを確認し、電子証明書を発行します。

たとえばhttps://api.example.comへ接続するとき、通信を暗号化するだけでなく、接続先がそのホスト名に対応する相手かを確認する必要があります。その確認に使うのがサーバー証明書です。

身分証で考えるなら、サーバー証明書が提示される身分証、CAがその発行元に当たります。発行元を信頼できるかも確認する、というイメージです。

ここで CAという組織・仕組み と、 CA証明書というファイル は別です。CA証明書には、発行元の署名を検証するための公開鍵などが入っています。

サーバー証明書・中間CA・ルートCAのつながり

用語 役割
サーバー証明書 接続先のホスト名などを示す証明書
中間CA証明書 サーバー証明書からルートCAへ、発行元のつながりをたどるための証明書
ルートCA証明書 検証の出発点として、あらかじめ信頼する認証局の証明書
信頼ストア 信頼するCA証明書を保管する場所
CAバンドル 複数のCA証明書を1つにまとめたファイル

一般的な構成では、次のようにつながります。

接続する側は、証明書の署名や有効期限、ホスト名などを検証し、信頼しているCAへつながるかを確認します。この証明書のつながりを 証明書チェーン と呼びます。

ルートCA証明書は、通常、OSなどの信頼ストアへあらかじめ登録されています。サーバーから受け取った証明書を、無条件に信頼するわけではありません。

コンテナにも信頼するCAの一覧が必要

大切なのは、 ホストOSとコンテナの信頼ストアは別 という点です。ホストPCに証明書を登録しても、コンテナ内へ自動でコピーされるわけではありません。

また、アプリのライブラリによっては、OS標準とは別の信頼ストアを使います。OS側の設定と、アプリが参照する設定の両方を確認します。

出典:Docker:CA certificates

CAと証明書チェーンの説明:MDN:Certificate authority

2. まずは標準のCAパッケージを用意する

サンプルの前提

  • DockerでLinuxコンテナをビルド・実行できること。
  • ベースイメージはDebian 13のdebian:trixie-slim。
  • ホスト側のコマンド例はBash。追加CAの内容確認にはホスト側のOpenSSLも使用する。
  • コンテナ内の証明書確認にはOpenSSL、HTTPS確認にはcurlを使う。

以下は証明書の仕組みを確認する学習用イメージです。実際のアプリへ組み込む際は、そのアプリのベースイメージ・起動設定・実行ユーザーに合わせてください。

2026年9月18日にDocker Engine 29.5.3、Linux/arm64のコンテナで再確認しました。コンテナ内はDebian 13、ca-certificates 20250419、OpenSSL 3.5.7です。標準CAでのHTTPS接続と、検証専用の一時CAを登録する前後の動作を確認しています。独自CAを使う実際の接続先とアプリの動作は、各環境で確認してください。

Dockerfile

Dockerfile
FROM debian:trixie-slim AS runtime-base

USER root

RUN apt-get update \
    && apt-get install -y --no-install-recommends \
        ca-certificates curl openssl \
    && update-ca-certificates \
    && rm -rf /var/lib/apt/lists/*

FROM runtime-base AS final

CMD ["/bin/sh"]

ここで実行している処理を分けると、次のようになります。

処理 何をするか
apt-get update パッケージ一覧を更新する
apt-get install ... ca-certificates 設定されたリポジトリからCAパッケージを導入・必要に応じ更新する
update-ca-certificates 有効なCA証明書から、信頼ストアとCAバンドルを生成・更新する
rm -rf /var/lib/apt/lists/* 不要になったパッケージ一覧を削除し、イメージの容量を抑える

curlとopensslはこの記事の確認用です。アプリの実行に必要かどうかは、用途に合わせて判断してください。

apt-get updateだけでは、CA証明書そのものは更新されません。また、update-ca-certificatesはインターネットから新しいCAを探してダウンロードするコマンドではありません。

取得できるCAパッケージは、OSとリポジトリに依存します。サポート中のベースイメージを使い、定期的に再ビルドする運用も合わせて考えます。

出典:Dockerfileの推奨事項:apt-get、Debian:update-ca-certificates

ビルドして確認する

Dockerfileを保存したディレクトリで実行します。初回はイメージとパッケージのダウンロードが発生します。

ホスト側ターミナル
docker build --pull -t ca-store-base:local .

docker run --rm ca-store-base:local \
  sh -c 'cat /etc/os-release; dpkg-query -W ca-certificates; openssl version'

docker run --rm ca-store-base:local \
  curl --head --fail --silent --show-error https://example.com

最後のコマンドで、証明書検証を有効にしたHTTPS通信を確認できます。例示サイトへの通信と、自分のアプリの接続先への通信は別なので、導入先でも確認してください。

--rmにより、確認用コンテナは終了後に削除されます。イメージは残ります。

3. 独自のCAを追加する場合

組織内のプライベートCAなど、標準ストアに含まれないCAを信頼する必要がある場合は、証明書を明示的に追加します。

一般的な公開CAへの接続で、毎回ルートCAを手動追加する必要があるわけではありません。まず標準パッケージと、接続先の証明書チェーンを確認します。

3-1. 証明書ファイルを用意する

管理者や認証局の正式な配布元から、信頼してよいCA証明書を取得します。この記事ではファイル名をexample-root-ca.crtとします。

Debianのupdate-ca-certificatesで追加する場合は、次の条件を満たします。

  • PEM形式である。
  • ファイルの拡張子が.crtである。
  • 1ファイルに1つの証明書を入れる。

拡張子とデータ形式は別です。DER形式のファイルを.crtへ名前変更しても、PEM形式には変換されません。

PEM形式は、テキストで開くと-----BEGIN CERTIFICATE-----と-----END CERTIFICATE-----で囲まれています。追加するのはCAの公開証明書であり、秘密鍵をイメージへ入れる必要はありません。

ホスト側ターミナル
openssl x509 \
  -in certs/example-root-ca.crt \
  -noout -subject -issuer -dates -fingerprint -sha256

SHA-256フィンガープリントは、証明書を照合するための識別値です。表示された名称だけで判断せず、正式な配布元が示す値などと照合してください。

サーバーへの接続時に受け取った証明書を、そのままルートCAとして登録しないようにします。受け取ったものはサーバー証明書や中間CA証明書かもしれません。

出典:Debian:ローカルCAの追加条件、OpenSSL:x509

3-2. COPY元は「ビルドコンテキスト」に置く

ビルドコンテキストは、Dockerへ渡すファイルの範囲です。

ホスト側ターミナル
docker build -f Dockerfile.custom-ca -t ca-store-custom:local .

このコマンドでは、末尾の.、つまり現在のディレクトリがビルドコンテキストです。COPY certs/example-root-ca.crt ...のコピー元は、この範囲から探されます。

Dockerfileの保存場所ではなく、 ビルドコマンドで渡したコンテキストの位置が基準 になります。別ディレクトリから-fでDockerfileを指定するときは、特に確認してください。

証明書を配置したサンプルで、必要なファイルを表示すると次の構成です。treeはフォルダー構成を表示するコマンドです。

ホスト側ターミナル
tree -a --noreport -I '.git|.gitignore|README.md|LICENSE|.gitkeep' .
treeの実行結果
.
├── .dockerignore
├── Dockerfile
├── Dockerfile.custom-ca
└── certs
    └── example-root-ca.crt

Dockerfileは標準CA用、Dockerfile.custom-caは独自CA追加用です。certs/example-root-ca.crtは利用環境に合わせて用意するCA証明書です。

サンプルの.dockerignoreは次の内容です。CAの公開証明書はコピー対象に残し、拡張子が.keyのファイルを除外します。

.dockerignore
.git
.gitignore
README.md
LICENSE
**/*.key

この指定だけで、すべての秘密鍵を除外できるわけではありません。たとえば.pemや拡張子のない名前でも秘密鍵は保存できます。 今回の手順に秘密鍵は不要なので、最初からビルドコンテキストの外で管理してください。 .pemは証明書にも使われるため、拡張子だけで内容を判断しないことも大切です。

.dockerignoreで除外されたファイルは、コンテキスト内にあっても通常のCOPYで使えません。たとえば*.crtやcerts/という指定がないか確認します。

.gitignoreはGitで管理するファイルの設定で、.dockerignoreとは別です。サンプルでは、利用者が用意するCA証明書をGitへ含めず、Dockerのビルド入力には含める構成にしています。

出典:Docker:Build context

3-3. コピーした後に登録する

次をDockerfile.custom-caとして保存します。

Dockerfile.custom-ca
FROM debian:trixie-slim AS runtime-base

USER root

RUN apt-get update \
    && apt-get install -y --no-install-recommends \
        ca-certificates curl openssl \
    && rm -rf /var/lib/apt/lists/*

COPY certs/example-root-ca.crt /usr/local/share/ca-certificates/example-root-ca.crt

RUN update-ca-certificates

FROM runtime-base AS final

CMD ["/bin/sh"]

順番は パッケージ導入 → 証明書のコピー → 信頼ストアへの登録 です。

COPYはファイルのコピーだけを行います。証明書のダウンロードや、信頼ストアへの登録まで行うわけではありません。

実際のDockerfileが途中でUSER appなどへ切り替わる構成なら、CA登録をrootで行った後、アプリ用の実行ユーザーへ戻してください。

ホスト側ターミナル
docker build --pull \
  -f Dockerfile.custom-ca \
  -t ca-store-custom:local .

出典:Docker:イメージへのCA証明書追加

4. マルチステージでは、最後のFROMを確認する

Dockerfileでは、FROMごとに別のビルドステージを開始できます。アプリをビルドするステージと、アプリを実行するステージを分ける場合もあります。

今回の例では、CAを設定したruntime-baseを最終ステージが継承しています。

最終ステージの抜粋
FROM runtime-base AS final

このため、CAパッケージと登録済みのストアが最終イメージに残ります。

一方、最終ステージを新しいFROM debian:trixie-slimなどから始めると、前のステージで追加したものは自動では引き継がれません。COPY --from=build /app /appでアプリだけをコピーしても、OSのCAストアまでコピーされるわけではありません。

どこで証明書を追加したかに加え、最後にどのステージを実行するか を確認します。

出典:Docker:Multi-stage builds

5. 確認は「ファイル・ストア・接続」の順に行う

ファイルを確認する

ホスト側ターミナル
docker run --rm ca-store-custom:local \
  openssl x509 \
  -in /usr/local/share/ca-certificates/example-root-ca.crt \
  -noout -subject -issuer -fingerprint -sha256

これは、最終イメージにある証明書ファイルを読み取れるかの確認です。CA名が表示されても、登録や接続の確認はまだ残っています。

CAバンドルで検証できるか確認する

ホスト側ターミナル
docker run --rm ca-store-custom:local \
  openssl verify \
  -CAfile /etc/ssl/certs/ca-certificates.crt \
  -no-CApath -no-CAstore \
  /usr/local/share/ca-certificates/example-root-ca.crt

-no-CApath -no-CAstoreは、既定のCAディレクトリ・ストアを参照せず、指定したCAバンドルで確認するための指定です。ここではOpenSSL 3.5で確認しています。

...: OKが確認の目安です。これは指定した証明書の検証結果であり、接続先のサーバー証明書やアプリの動作まで保証するものではありません。

出典:OpenSSL:verify、Trusted Certificate Options

接続先のTLSとアプリを確認する

API_HOSTには実際の接続先ホスト名を設定します。ここでのapi.example.comは置き換え用で、動作するAPIの例ではありません。

ホスト側ターミナル
API_HOST='api.example.com'

docker run --rm ca-store-custom:local \
  openssl s_client \
  -connect "${API_HOST}:443" \
  -servername "$API_HOST" \
  -verify_hostname "$API_HOST" \
  -verify_return_error </dev/null

-servernameでSNIのホスト名を送り、-verify_hostnameで証明書のホスト名を検証します。-verify_return_errorは、証明書の検証エラーがあれば処理を止めるための指定です。

OpenSSLによる接続を確認したら、実際のアプリでも同じ接続先を確認します。アプリが独自のCAバンドルやプロキシを使う場合、確認条件が異なるためです。s_clientはHTTPS_PROXYを自動では利用しません。

証明書エラーを避けるためにcurl -kなどで検証を無効にしても、原因の解決にはなりません。CAの不足だけでなく、有効期限・ホスト名・サーバーが返す中間CA証明書も確認してください。

出典:OpenSSL:s_client

6. 再ビルドと運用で気を付けること

RUNはイメージのビルド時に実行される

DockerfileのRUN apt-get ...は、コンテナの起動時に毎回実行される処理ではありません。CAを更新して運用へ反映するには、イメージを再ビルドし、新しいイメージからコンテナを作り直します。

起動中のコンテナへ手動で追加した証明書は、元のイメージには保存されません。継続利用する設定は、Dockerfileとビルド入力へ反映します。

--pullと--no-cacheは役割が違う

オプション 役割
--pull ベースイメージの新しい版を取得するよう試みる
--no-cache ビルド手順のキャッシュを再利用せず実行する

パッケージ取得もやり直して確認する場合の例です。

ホスト側ターミナル
docker build --pull --no-cache \
  -f Dockerfile.custom-ca \
  -t ca-store-custom:local .

これらを指定しても、OSのリポジトリに存在しないCAパッケージを取得できるわけではありません。毎回すべてのビルドで指定する必要もなく、更新方針に合わせて使います。

本番では、配布したイメージと実行中のイメージが一致するかも確認します。タグ名だけでなく、イメージ内容を識別するdigestを記録しておくと比較しやすくなります。

出典:Docker:Rebuild your images often

確認用イメージを片付ける

確認を終えて不要になった場合だけ、この記事で作成したローカルイメージを削除します。追加CAの例を試していなければ、2つ目のコマンドは不要です。

ホスト側ターミナル
docker image rm ca-store-base:local
docker image rm ca-store-custom:local

まとめ

DockerfileでCA証明書を扱うときは、次の順に確認すると整理しやすくなります。

  1. 標準のCAパッケージを用意する。
  2. 独自CAが必要なら、信頼できる証明書をビルドコンテキストへ配置する。
  3. COPYした後でupdate-ca-certificatesを実行する。
  4. 最終イメージへ設定が引き継がれているか確認する。
  5. ファイル、信頼ストア、TLS接続、アプリの順に確認する。

Dockerfileに行を追加することと、実行環境で証明書が使われることは別の確認です。 この区別を押さえておくと、実装時の確認漏れを減らせます。

仕様確認日:2026年9月18日。確認手順の順序と表は、Docker・Debian・OpenSSLの仕様をもとに筆者が整理しています。

おわりに

まずは小さな確認用イメージを作り、CA証明書がどこへ入り、どのコマンドで登録されるかを確かめてみてください。

Wealthy Designでは、Webシステム開発やクラウド活用に取り組んでいます。開発・インフラの支援内容に関心のある方は、公式サイトもご覧ください。

AWS・Web開発・AI活用のご相談や、採用・カジュアル面談については、Wealthy Design公式LINEでもお問い合わせいただけます。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?