NginxでのmTLS設定ガイド:クライアント証明書で内部APIの漏洩・不正アクセスを完全防御

Security tutorial - IT technology blog
Security tutorial - IT technology blog

深夜2時の緊急コールと、内部API漏洩の苦い教訓

深夜2時、けたたましく鳴り響く電話。オンコールチームからの緊急アラートでした。Grafanaのダッシュボードを開くと、リクエスト数のグラフが絶壁のように垂直急上昇していました。PaymentサービスとLedger(元帳)サービス間の残高照合用エンドポイントである /api/v1/internal/sync-data に対し、毎分45,000件以上ものリクエストが殺到していたのです。アクセス元のIPアドレスはすべて、東欧の見知らぬパブリックIP帯からでした。

原因を調査したところ、約15分前にジュニアエンジニアが誤って .env.local ファイルを公開GitHubリポジトリにコミットし、内部認証用の X-Internal-Token ヘッダーが外部に流出していたことが判明しました。

この障害を通じて、チーム全員が痛切な教訓を得ました。「HTTPSとBearer Tokenだけでは不十分だ」ということです。トークンさえ手に入れば、Nginxは通常通りリクエストを受理してしまいます。標準的な一方向TLSは、サーバーの正当性を証明して通信経路を暗号化するだけにすぎません。リクエストがアプリケーションサーバーに到達する前、すなわちネットワーク層のTLSハンドシェイクの段階で不正なアクセスを弾くには、mTLS(Mutual TLS:相互TLS)の導入が不可欠です。

従来の片方向TLSとmTLSの違いとは?

標準的なTLSモデルでは、クライアント側だけがサーバーを検証します。クライアントはサーバー証明書が正当か、ドメインが一致しているかを確認しますが、サーバー側はトランスポート層においてクライアントの素性を一切把握できません。そのため、認証処理の全負担がJWTやAPI Key、Cookieといったアプリケーション層に押し付けられます。

一方、mTLS(Mutual TLS)では通信のルールが根本から変わります。

  • サーバーが証明書を提示し、クライアントがサーバーの身元を検証します。
  • クライアント側も自身のクライアント証明書(Client Certificate)の提示が必須となります。
  • Nginxが直接検証を行い、クライアント証明書が社内のRoot CAによって署名されたものかを確認します。証明書がない場合や不正な証明書の場合は、即座に接続を切断し、400 Bad Request (No required SSL certificate was sent) を返します。

最大のメリットは、不要なリクエストや攻撃トラフィックをネットワーク境界で遮断できる点です。背後にあるNode.js、Go、Pythonなどのバックエンドサービスは、JSONのパースやトークン検証のためのデータベース問い合わせにCPUリソースを1ミリ秒たりとも消費しません。

実践手順:証明書の作成とNginxの設定

ステップ1:プライベート認証局(Root CA)の構築

まず、クラスタ内のすべてのマイクロサービスが信頼する独自のプライベート認証局(Internal CA)を作成します。管理サーバー上で専用の作業ディレクトリを用意しましょう。

mkdir -p /etc/nginx/certs && cd /etc/nginx/certs

# 1. CA用の秘密鍵を生成(AES-256暗号化で保護)
openssl genrsa -aes256 -out ca.key 4096

# 2. 自己署名ルート証明書(Root CA)を生成(有効期限5年 = 1825日)
openssl req -new -x509 -days 1825 -key ca.key -sha256 -out ca.crt \
  -subj "/C=VN/ST=Hanoi/L=Hanoi/O=FintechCore/OU=Infra/CN=Internal-Root-CA"

生成した ca.key は厳重に管理し、パブリックサーバー等へ絶対にコピーしないでください。Nginxに配置するのは署名照合用の ca.crt のみです。

ステップ2:Nginx用サーバー証明書の発行

クライアントからNginxが正当なサーバーであると認識されるため、Nginx専用の鍵ペアと証明書を作成します。

# 1. サーバー用の秘密鍵を生成
openssl genrsa -out server.key 2048

# 2. 証明書署名要求(CSR)を作成
openssl req -new -key server.key -out server.csr \
  -subj "/C=VN/ST=Hanoi/L=Hanoi/O=FintechCore/OU=Backend/CN=api-internal.local"

# 3. Root CAでサーバー証明書に署名(有効期限365日)
openssl x509 -req -days 365 -in server.csr -CA ca.crt -CAkey ca.key \
  -CAcreateserial -out server.crt -sha256

ステップ3:APIを呼び出すマイクロサービス向けクライアント証明書の発行

バックエンドAPIと通信する必要があるマイクロサービス(例:payment-worker-01)向けの証明書を作成します。

# 1. クライアント用の秘密鍵を生成
openssl genrsa -out client.key 2048

# 2. クライアント用CSRを作成
openssl req -new -key client.key -out client.csr \
  -subj "/C=VN/ST=Hanoi/L=Hanoi/O=FintechCore/OU=PaymentWorker/CN=payment-worker-01"

# 3. 社内CAでクライアント証明書に署名
openssl x509 -req -days 365 -in client.csr -CA ca.crt -CAkey ca.key \
  -CAcreateserial -out client.crt -sha256

# (オプション)管理者によるChromeやPostmanでのインポートが必要な場合はPKCS#12(.p12)形式に変換
openssl pkcs12 -export -out client.p12 -inkey client.key -in client.crt -certfile ca.crt

ステップ4:NginxのバーチャルホストでmTLSを有効化

/etc/nginx/conf.d/internal-api.conf を開き、mTLS設定ディレクティブを追加します。

server {
    listen 443 ssl http2;
    server_name api-internal.local;

    # Nginxサーバー自体の証明書設定
    ssl_certificate /etc/nginx/certs/server.crt;
    ssl_certificate_key /etc/nginx/certs/server.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    # 双方向認証(mTLS)の有効化
    ssl_client_certificate /etc/nginx/certs/ca.crt;
    ssl_verify_client on; # クライアントに正当な証明書の提示を義務付け
    ssl_verify_depth 2;   # 検証を許可するCA証明書チェーンの深さ

    location / {
        # クライアントの証明書情報をヘッダー経由でバックエンドに転送
        proxy_set_header X-Client-DN $ssl_client_s_dn;
        proxy_set_header X-Client-Verify $ssl_client_verify;
        
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

構文チェックを実行後、Nginxの設定をリロードします。

nginx -t && systemctl reload nginx

ステップ5:cURLによる動作検証

まず、攻撃者が漏洩したトークンのみを保持し、クライアント証明書を持たずにリクエストを送ったケースをシミュレートします。

curl -k -I https://api-internal.local/api/v1/internal/sync-data

Nginxは即座にリクエストを拒絶します。

HTTP/1.1 400 Bad Request
Server: nginx
<html>
<head><title>400 No required SSL certificate was sent</title></head>
...

リクエストはバックエンドに一切届きません。流出したトークン単体では完全に無力化されていることが確認できます。

次に、正規のクライアント証明書と秘密鍵を添えてリクエストを送信します。

curl --cacert /etc/nginx/certs/ca.crt \
     --cert /etc/nginx/certs/client.crt \
     --key /etc/nginx/certs/client.key \
     https://api-internal.local/api/v1/internal/sync-data

正常に接続されました。Nginxがクライアント署名の正当性を検証し、背後のサービスへ安全にリクエストをプロキシします。

まとめ

mTLSを導入することで、サービス間通信のインフラをZero Trust(ゼロトラスト)アーキテクチャに準拠した強固な要塞へと進化させることができます。万が一認証トークンやAPIエンドポイントのURLが漏洩したとしても、正規のクライアント証明書と秘密鍵を持たない攻撃者は、Nginxの門前で確実にシャットアウトされます。

Share: