TLS を使用して Azure Machine Learning による Web サービスをセキュリティで保護する

  • [アーティクル]

適用対象:Python SDK azureml v1

この記事では、Azure Machine Learning でデプロイされた Web サービスをセキュリティで保護する方法について説明します。

HTTPS を使用して、Web サービスへのアクセスを制限し、クライアントが送信するデータをセキュリティで保護します。 HTTPS は、クライアントと Web サービスの間の通信を暗号化することで双方の間の通信をセキュリティで保護する場合に役立ちます。 暗号化はトランスポート層セキュリティ (TLS) を使用します。 TLS は、現在も、TLS の前身である Secure Sockets Layer (SSL) と呼ばれることがあります。

ヒント

Azure Machine Learning SDK では、セキュリティで保護された通信に関連するプロパティに "SSL" の用語を使用します。 つまり、Web サービスでは TLS を使用しません。 SSL は、より一般的に認識されている用語に過ぎません。

具体的には、Azure Machine Learning によってデプロイされた Web サービスにより、AKS と ACI では TLS バージョン 1.2 がサポートされます。 ACI デプロイでは、以前のバージョンの TLS を使用している場合は、最新の TLS バージョンを取得するために再デプロイすることをお勧めします。

Azure Machine Learning の TLS バージョン 1.3 - AKS 推論はサポートされていません。

TLS と SSL の両方とも、"デジタル証明書" に依存しています。デジタル証明書は、暗号化の実行と ID の検証に役立ちます。 デジタル証明書のしくみの詳細については、ウィキペディアの「public key infrastructure (公開キー基盤)」のトピックを参照してください。

警告

Web サービスで HTTPS を使用しない場合は、そのサービスとの間で送受信されるデータがインターネット上の他のユーザーに表示される場合があります。

HTTPS により、接続先のサーバーの信頼性をクライアントから確認することもできます。 この機能は、中間者攻撃からクライアントを保護します。

これは、Web サービスをセキュリティで保護する一般的なプロセスです。

  1. ドメイン名を取得します。

  2. デジタル証明書を取得します。

  3. TLS が有効になっている Web サービスをデプロイするか更新します。

  4. その Web サービスを指すように DNS を更新します。

重要

Azure Kubernetes Service (AKS) にデプロイする場合は、独自の証明書を購入するか、Microsoft によって提供される証明書を使用することができます。 Microsoft 提供の証明書を使用する場合は、ドメイン名または TLS/SSL 証明書を取得する必要はありません。 詳細については、この記事の「TLS を有効にしてデプロイする」セクションを参照してください。

複数のデプロイ ターゲットにわたってセキュリティで保護する場合は、わずかな違いがあります。

重要

この記事の Azure CLI コマンドの一部では、Azure Machine Learning 用に azure-cli-ml、つまり v1 の拡張機能を使用しています。 v1 拡張機能のサポートは、2025 年 9 月 30 日に終了します。 その日付まで、v1 拡張機能をインストールして使用できます。

2025 年 9 月 30 日より前に、ml (v2) 拡張機能に移行することをお勧めします。 v2 拡張機能の詳細については、Azure ML CLI 拡張機能と Python SDK v2 に関するページを参照してください。

ドメイン名を取得する

ドメイン名をまだ所有していない場合は、ドメイン名レジストラー から購入します。 プロセスと価格は、レジストラーによって異なります。 レジストラーは、ドメイン名を管理するためのツールを提供します。 これらのツールを使用して、完全修飾ドメイン名 (FQDN) (www.contoso.com など) を、Web サービスをホストする IP アドレスにマップします。

TLS/SSL 証明書を取得する

TLS/SSL 証明書 (デジタル証明書) を取得する方法はたくさんあります。 最も一般的な方法は、証明機関 (CA) から購入することです。 証明書の取得場所に関係なく、次のファイルが必要です。

  • 証明書。 証明書は、完全な証明書チェーンを含み、"PEM でエンコード" されている必要があります。
  • キー。 キーも、PEM でエンコードされている必要があります。

証明書を要求するときは、Web サービスで使用する予定のアドレスの FQDN を指定する必要があります (www.contoso.com など)。 Web サービスの ID を検証するときに、証明書に記載されているアドレスとクライアントによって使用されるアドレスが比較されます。 これらのアドレスが一致しない場合、クライアントにはエラー メッセージが返されます。

ヒント

証明機関が、証明書とキーを PEM でエンコードされたファイルとして提供できない場合は、 OpenSSL などのユーティリティを使用して、フォーマットを変更できます。

警告

自己署名証明書は開発時にのみ使用します。 運用環境では使用しないでください。 自己署名証明書により、お使いのクライアント アプリケーションで問題が発生する可能性があります。 詳しくは、お使いのクライアント アプリケーションで使用されているネットワーク ライブラリに関するドキュメントをご覧ください。

TLS を有効にしてデプロイする

AKS デプロイの場合、Azure Machine Learning ワークスペースで AKS クラスターを作成または接続するときに TLS 終端を有効にすることができます。 AKS モデルのデプロイ時に、デプロイ構成オブジェクトを使用して TLS 終端を無効にすることができます。そうしないと、AKS クラスターの作成時または接続時に、すべての AKS モデルのデプロイの TLS 終端が既定で有効になります。

ACI のデプロイの場合、デプロイ構成オブジェクトを使用して、モデルのデプロイ時に TLS 終端を有効にすることができます。

Azure Kubernetes Service にデプロイする

Note

このセクションの情報は、デザイナー用のセキュリティで保護された Web サービスをデプロイするときにも適用されます。 Python SDK に慣れていない場合は、Azure Machine Learning SDK for Python に関するページを参照してください。

Azure Machine Learning ワークスペースで AKS クラスターを作成またはアタッチするときに、AksCompute.provisioning_configuration() および AksCompute.attach_configuration() の構成オブジェクトを使用して TLS 終端を有効にすることができます。 どちらのメソッドからも、enable_ssl メソッドを持つ構成オブジェクトが返されます。この enable_ssl メソッドを使用して TLS を有効にすることができます。

Microsoft 証明書または CA から購入したカスタム証明書を使用して、TLS を有効にすることができます。

  • Microsoft 提供の証明書を使用する場合、leaf_domain_label パラメーターを使用する必要があります。 このパラメーターは、サービスの DNS 名を生成します。 たとえば、"contoso" という値にするとは、"contoso<six-random-characters>.<azureregion>.cloudapp.azure.com" というドメイン名が作成されます。この <azureregion> はサービスが含まれるリージョンです。 必要に応じて、overwrite_existing_domain パラメーターを使用して既存の leaf_domain_label を上書きできます。 次の例では、Microsoft 証明書を使用して TLS を有効にする構成の作成方法を示します。

    from azureml.core.compute import AksCompute

# Config used to create a new AKS cluster and enable TLS
provisioning_config = AksCompute.provisioning_configuration()

# Leaf domain label generates a name using the formula
#  "<leaf-domain-label>######.<azure-region>.cloudapp.azure.com"
#  where "######" is a random series of characters
provisioning_config.enable_ssl(leaf_domain_label = "contoso")


# Config used to attach an existing AKS cluster to your workspace and enable TLS
attach_config = AksCompute.attach_configuration(resource_group = resource_group,
                                      cluster_name = cluster_name)

# Leaf domain label generates a name using the formula
#  "<leaf-domain-label>######.<azure-region>.cloudapp.azure.com"
#  where "######" is a random series of characters
attach_config.enable_ssl(leaf_domain_label = "contoso")

    重要

    Microsoft 提供の証明書を使用する場合、独自の証明書またはドメイン名を購入する必要はありません。

  • 購入したカスタム証明書を使用する場合、ssl_cert_pem_file、ssl_key_pem_file、および ssl_cname のパラメーターを使用します。 パス フレーズ保護を使った PEM ファイルはサポートされていません。 次の例では、 .pem ファイルを使用して、購入した TLS/SSL 証明書を使用する構成を作成する方法を示します。

    from azureml.core.compute import AksCompute

# Config used to create a new AKS cluster and enable TLS
provisioning_config = AksCompute.provisioning_configuration()
provisioning_config.enable_ssl(ssl_cert_pem_file="cert.pem",
                                    ssl_key_pem_file="key.pem", ssl_cname="www.contoso.com")

# Config used to attach an existing AKS cluster to your workspace and enable SSL
attach_config = AksCompute.attach_configuration(resource_group = resource_group,
                                     cluster_name = cluster_name)
attach_config.enable_ssl(ssl_cert_pem_file="cert.pem",
                                    ssl_key_pem_file="key.pem", ssl_cname="www.contoso.com")

enable_ssl の詳細については、AksProvisioningConfiguration.enable_ssl() および AksAttachConfiguration.enable_ssl() に関する記事を参照してください。

Azure Container Instances にデプロイする

Azure Container Instances にデプロイするとき、次のコード スニペットに示すように、TLS 関連のパラメーターの値を入力します。

from azureml.core.webservice import AciWebservice

aci_config = AciWebservice.deploy_configuration(
    ssl_enabled=True, ssl_cert_pem_file="cert.pem", ssl_key_pem_file="key.pem", ssl_cname="www.contoso.com")

詳細については、AciWebservice.deploy_configuration() に関する記事を参照してください。

DNS を更新する

カスタム証明書を使用した AKS デプロイまたは ACI デプロイのいずれの場合も、スコアリング エンドポイントの IP アドレスを指すように DNS レコードを更新する必要があります。

重要

AKS デプロイに Microsoft 提供の証明書を使用する場合、クラスターの DNS 値を手動で更新する必要はありません。 この値は、自動的に設定される必要があります。

以下の手順に従って、カスタム ドメイン名の DNS レコードを更新することができます。

  1. スコアリング エンドポイントの IP アドレスをスコアリング エンドポイント URI から取得します。通常、これは http://104.214.29.152:80/api/v1/service/<service-name>/score という形式です。 この例の IP アドレスは 104.214.29.152 です。

  2. ドメイン名レジストラー提供のツールを使用して、ドメイン名の DNS レコードを更新します。 このレコードは、FQDN (www.contoso.com など) を IP アドレスにマップします。 レコードは、スコアリング エンドポイントの IP アドレスを指している必要があります。

    ヒント

    Microsoft は、カスタム DNS 名または証明書の DNS を更新する責任を負いません。 お使いのドメイン名レジストラーで更新する必要があります。

  3. DNS レコードの更新後、nslookup custom-domain-name コマンドを使用して DNS の解決を検証できます。 DNS レコードが正しく更新されている場合、カスタム ドメイン名はスコアリング エンドポイントの IP アドレスを指します。

    レジストラーと、ドメイン名に対して構成された "Time to Live" (TTL) に応じて、クライアントがドメイン名を解決できるまで、数分から数時間の遅延が生じることがあります。

Azure Machine Learning を使用した DNS 解決の詳細については、「カスタム DNS サーバーでワークスペースを使用する方法」を参照してください。

TLS/SSL 証明書を更新する

TLS/SSL 証明書には有効期限切れがあるため、更新する必要があります。 通常、これは毎年発生します。 Azure Kubernetes Service にデプロイされているモデルの証明書を更新するには、次のセクションの情報を参照してください。

Microsoft が生成した証明書を更新する

証明書は、(leaf_domain_label を使用してサービスを作成したときに) 元々 Microsoft によって生成されたものである場合、必要に応じて自動的に更新されます。 証明書を手動で更新する場合は、次のいずれかの例を使用して更新します。

重要

  • 既存の証明書がまだ有効な場合は、renew=True (SDK) か --ssl-renew (CLI) を使用して、構成によってこれを強制的に更新します。 この操作が有効になるまでに約 5 時間かかります。
  • サービスが最初にデプロイされたとき、leaf_domain_label が使用されて、<leaf-domain-label>######.<azure-region>.cloudapp.azure.com というパターンで DNS 名が作成されました。 既存の名前 (最初に生成された 6 桁を含む) を維持するには、元の leaf_domain_label 値を使用します。 生成された 6 桁の数字は含めないでください。

SDK の使用

from azureml.core.compute import AksCompute
from azureml.core.compute.aks import AksUpdateConfiguration
from azureml.core.compute.aks import SslConfiguration

# Get the existing cluster
aks_target = AksCompute(ws, clustername)

# Update the existing certificate by referencing the leaf domain label
ssl_configuration = SslConfiguration(leaf_domain_label="myaks", overwrite_existing_domain=True, renew=True)
update_config = AksUpdateConfiguration(ssl_configuration)
aks_target.update(update_config)

CLI の使用

適用対象:Azure CLI ml 拡張機能 v1

az ml computetarget update aks -g "myresourcegroup" -w "myresourceworkspace" -n "myaks" --ssl-leaf-domain-label "myaks" --ssl-overwrite-domain True --ssl-renew

詳細については、次のドキュメントを参照してください。

カスタム証明書を更新する

証明書が元は証明機関によって生成されたものである場合は、次の手順を使用します。

  1. 証明機関によって提供されるドキュメントを使用して、証明書を更新します。 このプロセスによって新しい証明書ファイルが作成されます。

  2. SDK または CLI のいずれかを使用して、新しい証明書でサービスを更新します。

    SDK の使用

    from azureml.core.compute import AksCompute
from azureml.core.compute.aks import AksUpdateConfiguration
from azureml.core.compute.aks import SslConfiguration

# Read the certificate file
def get_content(file_name):
    with open(file_name, 'r') as f:
        return f.read()

# Get the existing cluster
aks_target = AksCompute(ws, clustername)

# Update cluster with custom certificate
ssl_configuration = SslConfiguration(cname="myaks", cert=get_content('cert.pem'), key=get_content('key.pem'))
update_config = AksUpdateConfiguration(ssl_configuration)
aks_target.update(update_config)

    CLI の使用

    適用対象:Azure CLI ml 拡張機能 v1

    az ml computetarget update aks -g "myresourcegroup" -w "myresourceworkspace" -n "myaks" --ssl-cname "myaks"--ssl-cert-file "cert.pem" --ssl-key-file "key.pem"

詳細については、次のドキュメントを参照してください。

TLS を無効にする

Azure Kubernetes Service にデプロイされたモデルに対して TLS を無効にするには、status="Disabled" を指定して SslConfiguration を作成してから、更新を実行します。

from azureml.core.compute import AksCompute
from azureml.core.compute.aks import AksUpdateConfiguration
from azureml.core.compute.aks import SslConfiguration

# Get the existing cluster
aks_target = AksCompute(ws, clustername)

# Disable TLS
ssl_configuration = SslConfiguration(status="Disabled")
update_config = AksUpdateConfiguration(ssl_configuration)
aks_target.update(update_config)

次のステップ

具体的には、次の方法を学習します。