> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/https.md).

# HTTPS で Inference を提供

独自の TLS 証明書、カスタム証明書パス、暗号化キー、相互 TLS を使って、self-hosted の Roboflow Inference サーバーを HTTPS で提供します。

独自の TLS 証明書と秘密鍵を指定すると、Inference サーバーは HTTPS を直接提供できます。これは、コンテナの前に TLS 終端リバースプロキシを配置できないセルフホスト環境で役立ちます。

HTTPS は環境変数だけで設定できます。

## 環境変数

<table data-search="false"><thead><tr><th>変数</th><th>説明</th><th>デフォルト</th></tr></thead><tbody><tr><td>ENABLE_HTTPS</td><td>マスタースイッチ。HTTPS を有効にするには、True、1、または yes に設定します。</td><td>False</td></tr><tr><td>SSL_CERTFILE</td><td>PEM 形式の証明書を格納する、コンテナ内のパス。</td><td>/etc/inference/certs/server.crt</td></tr><tr><td>SSL_KEYFILE</td><td>PEM 形式の秘密鍵を格納する、コンテナ内のパス。</td><td>/etc/inference/certs/server.key</td></tr><tr><td>SSL_KEYFILE_PASSWORD</td><td>暗号化された秘密鍵のパスフレーズ。</td><td>未設定</td></tr><tr><td>SSL_CA_CERTS</td><td>クライアント証明書（mTLS）の検証に使用する CA バンドル。</td><td>未設定</td></tr></tbody></table>

証明書と鍵のパスのデフォルト値は `/etc/inference/certs/...`なので、最も簡単なデプロイでは、証明書と鍵をこれらのパスにマウントして、 `ENABLE_HTTPS=true`.

もし `ENABLE_HTTPS` が設定されているにもかかわらず証明書または鍵が見つからない場合、サーバーは読み取りを試みたパスを一覧表示するエラーを出して起動を拒否します。

## 自己署名証明書を使ったクイックスタート

以下の例では、CPUイメージを `https://localhost:9001` で自己署名証明書を使って実行します。本番環境では、証明書の生成手順を独自の認証局が発行した証明書に置き換えてください。

```bash
# 1. localhost で有効な自己署名証明書と鍵のペアを生成する
mkdir -p /tmp/inference-certs
openssl req -x509 -newkey rsa:2048 -nodes \
  -keyout /tmp/inference-certs/server.key \
  -out /tmp/inference-certs/server.crt \
  -days 365 \
  -subj "/CN=localhost" \
  -addext "subjectAltName=DNS:localhost,IP:127.0.0.1"

# 2. HTTPS を有効にして推論サーバーを実行する
docker run --rm -p 127.0.0.1:9001:9001 \
  -e ENABLE_HTTPS=true \
  -v /tmp/inference-certs:/etc/inference/certs:ro \
  roboflow/roboflow-inference-server-cpu:latest

# 3. 別のシェルから検証する
curl --cacert /tmp/inference-certs/server.crt https://localhost:9001/info
```

`--cacert` このリクエストでは生成された証明書を信頼しつつ、証明書とホスト名の検証は引き続き行います。

## カスタム証明書パス

証明書がデフォルト以外の場所にある場合は、パスを明示的に設定します。

```bash
docker run --rm -p 127.0.0.1:9001:9001 \
  -e ENABLE_HTTPS=true \
  -e SSL_CERTFILE=/run/secrets/tls/fullchain.pem \
  -e SSL_KEYFILE=/run/secrets/tls/privkey.pem \
  -v /etc/letsencrypt/live/inference.example.com:/run/secrets/tls:ro \
  roboflow/roboflow-inference-server-cpu:latest
```

## 暗号化された秘密鍵

Python版およびシェル版のUvicornランチャーでは、秘密鍵が暗号化されている場合、パスフレーズを次の変数で指定します。 `SSL_KEYFILE_PASSWORD` 並行して提供されるGunicornランチャーはこのオプションをサポートしておらず、ランタイムのセキュリティ強化ビルド（現在準備中）では起動時に拒否されます。暗号化された鍵を使用する場合はUvicornを使ってください。パスフレーズをイメージに埋め込まず、シークレットストアに保管してください。

## 相互TLS

次に説明する、現在準備中のランタイムのセキュリティ強化ビルドでは [セキュリティ設定の移行](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/security-migration.md#tls-client-certificates)で、次のように設定します。 `ENABLE_HTTPS=True` および `SSL_CA_CERTS` クライアント CA バンドルをマウントし、クライアント証明書を必須にします。その後、Python 版とシェル版の Uvicorn ランチャー、および並列実行用の Gunicorn ランチャーは、その CA が署名した有効な証明書を持たないクライアントを拒否します。

以前のランチャーでは、クライアント証明書を必須にしなくても CA バンドルを読み込めました。強制適用の修正が含まれていないビルドでは、この設定だけをアクセス制御として当てにしないでください。

### クライアント証明書を使って接続する

クライアントの証明書と秘密鍵の両方を指定し、サーバーをその CA に対して検証します。

```bash
curl --cacert server-ca.pem \
  --cert client.crt --key client.key \
  https://localhost:9001/healthz
```

mTLS が有効な場合、API キー認証が免除されているエンドポイントであっても、アプリケーション、ヘルスプローブ、メトリクススクレーパーにはクライアント証明書が必要です。この境界に依存する前に、クライアント証明書なしのリクエストが失敗することを確認してください。

HTTPS では `SSL_CA_CERTS` を指定しない場合、サーバーのみの TLS が維持されます。ネットワークアクセスと Workspace 認証については、 [サーバーのセキュリティ](https://docs.roboflow.com/deployment/ja/self-hosted/inference-server/configuration/security.md) を確認してください。
