内部サービスのためのTLS証明書を正しく設定する
TLS certificates for internal services done right (tuxnet.dev)
要約
この記事では、内部サービス向けのTLS証明書を正しく管理する方法について解説しています。自己署名証明書や、.internalドメインの使用に伴う課題を避け、パブリックドメインとSplit-Horizon DNS、Let's Encrypt、Nginx、NetBirdを組み合わせることで、セキュアで管理しやすいTLS設定を実現するアプローチを紹介しています。
全文翻訳
内部サービスのためのTLS証明書を正しく設定する
更新 2026-07-12: 続編の記事「内部サービスのためのTLS証明書をよりシンプルに」もぜひご覧ください。
タイトルは少しクリックベイト的かもしれませんが、私が「この方法が正しい」と考える理由を説明します。まず、簡単な例から始めましょう。ここでは、多数のHTTPサービスをホストするサーバーがあるとします。これらのサービスの一部は外部向け、他は内部向けです。内部サービスにアクセスするには、VPNに接続している必要があります。
簡単のため、2つの選択肢を考えます。
- ICANNによってプライベート利用に制限されているトップレベルドメイン(例:
.internal)を使用する。 - 所有している公開ドメイン(例:
tuxnet.dev)を使用する。
例として、内部アプリケーションにGrafanaを使用します。これは内部IPアドレス10.0.1.10でアクセス可能であり、VPNにはDNSリゾルバ機能があると仮定します。
.internal では何が問題なのか?
grafana.tuxnet.internal のような、内部IPアドレス10.0.1.10に解決されるタイプ"A"のDNSレコードを単純に作成できます。しかし、これをプレーンテキストのHTTPサービスにしたくない場合、自己署名証明書を作成する必要があります。
良い点は、これを行う方法を示すチュートリアルが豊富にあることです(例: こちら)。悪い点は、すべてのHTTPクライアントがこの自己署名証明書を信頼するように設定する必要があることです。あるいは、単にユーザーにTLS証明書のエラーを無視するように指示することもできます(¯_(ツ)_/¯)。
「正しい方法」で実行するには?
ここで「Split-Horizon DNS」という設定が登場します。公開DNSリゾルバに対しては、grafana.tuxnet.devドメインは公開IPアドレスに解決され、VPNに接続されたクライアントに対しては、このドメインは内部IPアドレスに解決されます。
公開IPアドレスに解決されるという良い点は、Let's EncryptやZeroSSLのような公開CAを使用できることです。悪い点は、VPNから発信されていないトラフィックを拒否するWAFがまだ必要になることです。
両方のソリューションの長所と短所を考慮すると、各マシンに自己署名証明書をインストールする(またはユーザーにTLSエラーを抑制するように指示する)よりも、1箇所(サーバー上)にWAFを設定する方がはるかに簡単だと考えます。
「言うだけなら簡単、コードを見せろ」
理論は終わり、実践に移りましょう。必要なものは以下の通りです。
- DNSリゾルバ機能を持つVPN — ここでは NetBird を選択します。
- 証明書発行のためのACMEクライアント — ここでは acme.sh を選択します。
- Grafanaの前にWAF機能を持つリバースプロキシ — ここでは nginx を選択します。
私の他のブログ記事を読んだことがある方なら、私がNetBird(Tailscaleはごめんなさい)のファンであることに気づいているかもしれません。Custom Zones機能のおかげで、NetBirdは「Split-Horizon DNS」に必要な作業の大部分を私たちに代わって行ってくれます。User groupsまたはPeer groupsを使用することで、サーバーがgrafana.tuxnet.devに対して公開DNSリゾルバを使用するように、Custom Zonesを選択的に適用できます。
なぜサーバーをそのカスタムゾーンから除外するのか?これは、http-01チャレンジを使用したい場合を除いて、必須ではありません。他の方法も可能ですが、このブログ記事ではhttp-01を選択します。さて、これで証明書を取得しましょう。
acme.sh --issue -d grafana.tuxnet.dev --server letsencrypt --standalone
acme.shは非常に柔軟で、多くのモードがあります。スタンドアロンモード(--standaloneフラグで有効)のクールな点は、nginxがポート80でリッスンする必要がないことです。このポートは、acme.shが証明書を取得する際にのみ「アクティブ」になります。さて、これでnginxを稼働させることができます。これが私たちの設定です。
upstream grafana {
server localhost:3000;
}
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
listen our-server.netbird.cloud:443 ssl;
server_name grafana.tuxnet.dev;
http2 on;
ssl_certificate /etc/ssl/certs/grafana.tuxnet.dev.crt;
ssl_certificate_key /etc/ssl/private/grafana.tuxnet.dev.key;
access_log /var/log/nginx/grafana.tuxnet.dev.access.log main;
error_log /var/log/nginx/grafana.tuxnet.dev.error.log warn;
location / {
proxy_pass http://grafana;
proxy_set_header Host $host;
}
# Proxy Grafana Live WebSocket connections.
location /api/live/ {
proxy_pass http://grafana;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
}
}
この設定で説明する価値のある重要な設定が1つあります — listen our-server.netbird.cloud:443 ssl;です。これは、サーバーのVPNネットワークインターフェイスにバインドしています。our-server.netbird.cloudの代わりに、これはVPNのIPアドレスである可能性があります。実際には、これによりgrafana.tuxnet.devへの公開インターネットからのトラフィックが拒否されます — これが私たちのWebアクセスファイアウォールです。
セキュリティはレイヤー(玉ねぎやお化けのように)で構成されます。最初のレイヤーはSplit-Horizon DNSですが、何らかの理由でそれが失敗したり巧妙に回避されたりした場合、2番目のレイヤーであるWAFが防御線となります。
最後に、証明書の自動更新です。acme.shには標準で--cronフラグがあります。これで、呼び出す毎日のcronジョブが必要になります。
acme.sh --cron
acme.shは自動的にどの証明書を更新するかを選択します。私たちがする必要があるのは、cronジョブが新しい証明書をnginxの設定で定義された場所にコピーすることを確認することだけです。nginxも新しい証明書を使用するためにリロードする必要があります。私たちのcronジョブは以下のようになります。
main() {
refresh_certs
sync_api_tuxnet_dev_certs
sync_internal_tuxnet_dev_certs
reload_nginx
}
refresh_certs() {
setcap CAP_NET_BIND_SERVICE=+ep /usr/bin/socat1
sudo -u acmesh /home/acmesh/acme.sh/acme.sh --cron
setcap -r /usr/bin/socat1
}
sync_api_tuxnet_dev_certs() {
local green=$(get_checksum "$API_SRC_KEY")
local blue=$(get_checksum "$API_DST_KEY")
local key_allowed_group=www-data
if [[ "$green" != "$blue" ]]; then
sync_certs "$API_SRC_KEY" "$API_DST_KEY" "$API_SRC_CERT" "$API_DST_CERT" "$key_allowed_group"
fi
}
sync_internal_tuxnet_dev_certs() {
local green=$(get_checksum "$INTERNAL_SRC_KEY")
local blue=$(get_checksum "$INTERNAL_DST_KEY")
local key_allowed_group=www-data
if [[ "$green" != "$blue" ]]; then
sync_certs "$INTERNAL_SRC_KEY" "$INTERNAL_DST_KEY" "$INTERNAL_SRC_CERT" "$INTERNAL_DST_CERT" "$key_allowed_group"
fi
}
reload_nginx() {
nginx -t
systemctl reload nginx
}
get_checksum() {
sha256sum "$1" | cut -d' ' -f1
}
sync_certs() {
local src_key="$1"
local dst_key="$2"
local src_cert="$3"
local dst_cert="$4"
local key_allowed_group="$5"
cp -v "$src_key" "$dst_key"
logger "synced $dst_key"
cp -v "$src_cert" "$dst_cert"
logger "synced $dst_cert"
chown root:${key_allowed_group} "$dst_key"
chown root:ssl-cert "$dst_cert"
chmod 640 "$dst_key" "$dst_cert"
}
main "$@"
setcap CAP_NET_BIND_SERVICE=+ep /usr/bin/socat1に関する小さなコメントです。スタンドアロンモードのacme.shは、ポート80でリッスンするためにsocatを使用します。一方で、必要がない限りacme.shをrootで実行したくありません。他方で、ポート80は「特権ポート」の1つであり、デフォルトでは、特権ポートは非rootプロセスにバインドできません。ここでCAP_NET_BIND_SERVICE=+epが役立ちます。このトピックについてさらに興味がある場合は、この記事を確認できます。
[画像: TLSがうまく機能するときのあの感覚]
これで、サービスが内部か外部か、翌日か来年かに関わらず、うまく機能するTLSが実現しました。
ボーナス — SANとCNAME
さらに内部サービスがある場合はどうでしょうか?個別のサブドメインの下に配置したい場合はどうでしょうか?それぞれに個別の証明書を生成する必要があるでしょうか?答えは「いいえ」で、そのための2つの解決策があります。
- ワイルドカード証明書 — セキュリティ上の影響のため、私はそれに賛成しません。
- TLS SAN(Subject Alternative Name) — CN(Common Name)に加えて、言及されたSANを定義します。詳細については、https://www.ssl.com/faqs/common-name/ を参照してください。
実際には、internal.tuxnet.devの"A"レコードを作成し、次にgrafana.tuxnet.devやanalytics.tuxnet.devのようなCNAMEレコードを作成して、internal.tuxnet.devに解決させることができます。その後、以下のような1つの証明書を生成します。
acme.sh --issue -d internal.tuxnet.dev -d grafana.tuxnet.dev -d analytics.tuxnet.dev --server letsencrypt --standalone
その詳細は以下のようになります。
echo | openssl s_client -connect internal.tuxnet.dev:443 2>/dev/null | openssl x509 -noout -subject -ext subjectAltName
subject=CN=internal.tuxnet.dev
X509v3 Subject Alternative Name:
DNS:analytics.tuxnet.dev, DNS:grafana.tuxnet.dev, DNS:internal.tuxnet.dev
これで、nginxの設定で異なるserver定義に対して同じ証明書を再利用するだけです。
まとめ
Split-Horizon DNS、WAF、ACMEプロトコルのおかげで、HTTPクライアントにTLSの問題を引き起こすことなく、内部サービス向けのTLS証明書を安全に設定する方法を学びました。すべて無料です!