この記事では、Azure CLIを使用してAzure Kubernetes Service (AKS) クラスターをデプロイし、自動的に生成されたセキュリティ ポリシーを使用して機密コンテナー (プレビュー) を構成します。 次に、アプリケーションを機密コンテナーとしてデプロイします。 詳細については、 AKS Confidential コンテナーの概要を参照してください。
一般に、AKS Confidential Containers の使用を開始するには、次の手順を実行します。
- Azure CLIを使用して AKS クラスターをデプロイまたはアップグレードします。
- ポッド YAML マニフェストに注釈を追加して、ポッドを Confidential コンテナーを使用するようにマークします。
- ポッド YAML マニフェストにセキュリティ ポリシーを追加します。
- コンフィデンシャル コンピューティングでアプリケーションをデプロイします。
重要
2025 年 11 月 30 日から、Azure Kubernetes Service (AKS) は、Azure Linux 2.0 のセキュリティ更新プログラムをサポートまたは提供しなくなりました。 Azure Linux 2.0 ノード イメージは、202512.06.0 リリースでフリーズします。
2026 年 10 月 31 日以降、ノード イメージは削除され、ノード プールをスケーリングできなくなります。
ノード プールをサポートされている Kubernetes バージョンにアップグレードするか、osSku AzureLinux3 に移行して、サポートされている Azure Linux バージョンに移行します。 詳細については、 廃止に関する GitHub の問題 と Azure 更新プログラムの提供終了に関するお知らせを参照してください。 お知らせや更新情報を常に把握するには、 AKS のリリース ノートに従ってください。
前提条件
- 最新バージョンの Azure CLI。
az versionを実行してバージョンを見つけ、az upgradeを実行してバージョンをアップグレードします。 インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。 - 最新バージョンの
aks-previewAzure CLI 拡張機能。 -
confcomConfidential Container Azure CLI 拡張機能の最新バージョン。confcomは、セキュリティ ポリシーを生成するために必要です。 - ワークロード ID とフェデレーション ID 資格情報。 Kubernetes アプリケーションは、ワークロード ID 資格情報により、注釈付きサービス アカウントに基づく Microsoft Entra ID を使用して Azure リソースに安全にアクセスできます。 Microsoft Entra ワークロード ID の十分な知識がない方は、Microsoft Entra ワークロード ID の概要と、ワークロード ID を AKS で使用する方法に関する説明を参照してください。
- クラスターの作成に使用している ID には、適切な最小限のアクセス許可が与えられています。 AKS のアクセスと ID の情報については、「Azure Kubernetes Service (AKS) でのアクセスと ID オプション」を参照してください。
- Kubernetes クラスターを管理するには、Kubernetes のコマンドライン クライアントである kubectl を使用します。 Azure Cloud Shell には
kubectlが付属しています。kubectlコマンドを使用して、az aks install-cliをローカルにインストールできます。 - AKS 上の機密コンテナーは、構成証明とセキュアなキー発行のためのサイドカー オープン ソース コンテナーとして機能します。 このサイドカーは、Azure Key Vault などのキー管理サービス (KMS) との統合により、検証完了後にコンテナー グループへのキー発行を担います。 Azure Key Vault Managed HSM (ハードウェア セキュリティ モジュール) は、必須ではありませんが、コンテナー レベルの整合性と構成証明をサポートするためにデプロイすることをお勧めします。 Managed HSM のデプロイについては、「Managed HSM のプロビジョニングとアクティブ化」を参照してください。
aks-preview Azure CLI 拡張機能をインストールする
重要
AKS のプレビュー機能は、セルフサービスのオプトイン単位で利用できます。 プレビューは、"現状有姿" および "利用可能な限度" で提供され、サービス レベル アグリーメントおよび限定保証から除外されるものとします。 AKS プレビューは、ベストエフォート ベースでカスタマー サポートによって部分的にカバーされます。 そのため、これらの機能は、運用環境での使用を意図していません。 詳細については、次のサポート記事を参照してください。
次のコマンドを実行して、
aks-preview拡張機能をインストールします。az extension add --name aks-preview次のコマンドを実行して、最新バージョンの拡張機能に更新します。
az extension update --name aks-preview
confcom Azure CLI 拡張機能をインストールする
次のコマンドを実行して、
confcom拡張機能をインストールします。az extension add --name confcom次のコマンドを実行して、最新バージョンの拡張機能に更新します。
az extension update --name confcom
KataCcIsolationPreview フィーチャーフラグを登録する
次の例に示すように、
az feature registerコマンドを実行してKataCcIsolationPreview機能フラグを登録します。az feature register --namespace "Microsoft.ContainerService" --name "KataCcIsolationPreview"状態が [登録済み] と表示されるまで数分待ちます。
az feature showコマンドを実行して、登録状態を確認します。az feature show --namespace "Microsoft.ContainerService" --name "KataCcIsolationPreview"状態が Registered と表示されたら、Microsoft.ContainerService リソース プロバイダーの登録を更新するために、
az provider registerコマンドを実行します:az provider register --namespace "Microsoft.ContainerService"
機密コンテナーを有効にしてクラスターを作成する
az aks createコマンドを使用して AKS クラスターを作成します。 次のパラメーターを指定します。- --os-sku: AzureLinux。 このプレビュー リリースでは、Azure Linux OS SKU のみがこの機能をサポートします。
- --node-vm-size: AMD SEV-SNP 保護された子 VM の入れ子になった仮想化をサポートする任意のAzure VM サイズが動作します。 たとえば、Standard_DC8as_cc_v5 VM などが該当します。
- --enable-workload-identity: ポッドが Kubernetes ID を使用できるように、Microsoft Entra ワークロード ID を作成できるようにします。
- --enable-oidc-issuer: OpenID Connect (OIDC) 発行者を有効にします。 これにより、Microsoft Entra IDまたはその他のクラウド プロバイダー ID とアクセス管理プラットフォームで、API サーバーの公開署名キーを検出できます。
- --workload-runtime: KataCcIsolation を指定して、ノード プールで機密コンテナー機能を有効にします。
az aks create --resource-group myResourceGroup --name myAKSCluster --os-sku AzureLinux --node-vm-size Standard_DC8as_cc_v5 --workload-runtime KataCcIsolation --node-count 1 --enable-oidc-issuer --enable-workload-identity --generate-ssh-keys数分後、コマンドは完了し、クラスターに関する JSON 形式の情報を返します。
クラスターの準備ができたら、
az aks get-credentialsコマンドを使用してクラスターの資格情報を取得します。az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
既存のクラスターで機密コンテナーを有効にする
既存の AKS クラスターでこの機能を使用するには、次の要件を満たす必要があります。
-
KataCcIsolationPreview機能フラグを登録する手順に従います。 - クラスターに対してワークロード ID を有効にします (まだ有効にしていない場合)。
機密コンテナーが有効になっているノード プールを追加する
次のコマンドを使用して、それをホストするノード プールを作成して機密コンテナー (プレビュー) を有効にします。
az aks nodepool addコマンドを使用して、AKS クラスターにノード プールを追加します。 次のパラメーターを指定します。- --resource-group: AKS クラスターを作成する既存のリソース グループの名前を入力します。
- クラスター名: AKS クラスターの一意の名前 ("myAKSCluster" など) を入力します。
- --name: nodepool2 など、クラスターのノード プールの一意の名前を入力します。
-
--workload-runtime: "KataCcIsolation" を指定し、ノード プールに対して機能を有効にします。
--workload-runtimeパラメーターと共に、これらの他のパラメーターは次の要件を満たします。 それ以外の場合、コマンドは失敗し、対応するパラメーターに関する問題を報告します。 - --os-sku: AzureLinux。 このプレビュー リリースでは、Azure Linux OS SKU のみがこの機能をサポートします。
- --node-vm-size: AMD SEV-SNP 保護された子 VM の入れ子になった仮想化をサポートする任意のAzure VM サイズが動作します。 たとえば、Standard_DC8as_cc_v5 VM などが該当します。
次の例では、"myResourceGroup" の "nodepool2" にある "myAKSCluster" に、2 つのノードを持つユーザー ノード プールを 追加します。
az aks nodepool add --resource-group myResourceGroup --name nodepool2 --cluster-name myAKSCluster --node-count 2 --os-sku AzureLinux --node-vm-size Standard_DC8as_cc_v5 --workload-runtime KataCcIsolation数分後、コマンドが完了し、クラスターに関する情報が JSON 形式で返されます。
az aks updateコマンドを実行して、機密コンテナー ノード プールを追加した後でクラスター構成を調整します。az aks update --name myAKSCluster --resource-group myResourceGroup数分後、コマンドが完了し、クラスターに関する情報が JSON 形式で返されます。
クラスターの準備ができたら、
az aks get-credentialsコマンドを使用してクラスターの資格情報を取得します。az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
ワークロード ID のデプロイと構成
Azure Key Vault およびシークレットに対するアクセスの構成と、機密コンテナーとしてのアプリケーション デプロイを実行するには、ワークロード ID の構成作業が完了している必要があります。
ワークロード ID を構成するには、ワークロード ID をデプロイして構成する方法についての記事で説明されているとおり、以下の手順を実行します。
- OIDC 発行者 URL を取得する
- マネージド ID の作成
- Kubernetes サービス アカウントを作成する
- フェデレーション ID 資格情報を確立する
重要
このチュートリアルを続けるには、ワークロード ID のデプロイと構成に関する記事の「環境変数のエクスポート」セクションから環境変数を設定します。 変数 SERVICE_ACCOUNT_NAMESPACE を kafkaに設定し、ワークロード ID を構成する前にコマンド kubectl create namespace kafka を実行します。
kata-cc と構成証明コンテナーを使用し、信頼されたアプリケーションをデプロイする
次の手順では、Azure Managed Hardware Security Modules (Managed HSM) によって管理される暗号化キーを使用して、Kafka メッセージのエンドツーエンド暗号化を構成します。 このキーは、Kafka コンシューマーが、ポッドに Azure Attestation のシークレット プロビジョニング コンテナーが挿入された Confidential Container 内で実行されている場合にのみ使用可能になります。
この構成は、次の 3 つのコンポーネントに基づいています。
- Kafka クラスター: クラスター上の Kafka 名前空間にデプロイされた単純な Kafka クラスター。
- Kafka プロデューサー: 標準的な Kubernetes Pod として実行され、公開鍵を使用して暗号化されたユーザー設定のメッセージを Kafka トピックに送信する Kafka プロデューサー。
- Kafka コンシューマー: kata-cc ランタイムで実行され、セキュリティで保護されたキーリリース コンテナーから秘密キーを取得して Kafka メッセージを復号化し、メッセージを Web UI にレンダリングする Kafka コンシューマー ポッド。
このプレビュー リリースでは、テストおよび評価目的のために、Azure Key Vault Premium レベルの新規作成リソースまたは既存リソースを使用してハードウェア セキュリティ モジュール (HSM) へのキー格納をサポートすることをお勧めします。 運用環境用キー コンテナーの使用はお勧めしません。 まだ Azure Key Vault を使用していない場合は、「Azure CLI を使用してキー コンテナーを作成する」を参照してください。
前に作成したマネージド ID と自分のアカウントに、キー コンテナーへのアクセス権を付与します。 両方の ID にKey Vault Crypto Officer と Key Vault Crypto User の Azure RBAC ロールを割り当てます。
注
マネージド ID は、
USER_ASSIGNED_IDENTITY_NAME変数に代入した値です。ロールの割り当てを追加するには、
Microsoft.Authorization/roleAssignments/write、Microsoft.Authorization/roleAssignments/delete、または Owner などの と のアクセス許可が必要です。HSM で保護されたキーをサポートするには、Key Vault Premium SKU を使う必要があります。
次のコマンドを実行して、スコープを設定します。
AKV_SCOPE=$(az keyvault show --name <AZURE_AKV_RESOURCE_NAME> --query id --output tsv)次のコマンドを実行して、Key Vault Crypto Officer ロールを割り当てます。
az role assignment create --role "Key Vault Crypto Officer" --assignee "${USER_ASSIGNED_IDENTITY_NAME}" --scope $AKV_SCOPE次のコマンドを実行して、Key Vault Crypto User ロールを割り当てます。
az role assignment create --role "Key Vault Crypto User" --assignee "${USER_ASSIGNED_IDENTITY_NAME}" --scope $AKV_SCOPE次のコマンドを実行して、Kafka クラスターを Kafka 名前空間にインストールします。
kubectl create -f 'https://strimzi.io/install/latest?namespace=kafka' -n kafka次のコマンドを実行して、
kafkaクラスター CR ファイルを適用します。kubectl apply -f https://strimzi.io/examples/latest/kafka/kafka-persistent-single.yaml -n kafkaGitHub のこのワークロード用の Bash スクリプトを使用して、RSA 暗号化/解読キーを準備します。 このファイルを
setup-key.shとして保存します。次のコマンドを実行して、
MAA_ENDPOINT環境変数を Attest URI の FQDN に設定します。export MAA_ENDPOINT="$(az attestation show --name "myattestationprovider" --resource-group "MyResourceGroup" --query 'attestUri' -o tsv | cut -c 9-)"Attest URI の FQDN が正しい形式であることを確認します (MAA_ENDPOINT にはプレフィックス "https://" を含めないでください)。
echo $MAA_ENDPOINT注
Microsoft Azure Attestation の設定については、「クイックスタート: Azure CLI を使用して Azure Attestation を設定する」をご覧ください。
次の YAML マニフェストをコピーし、
consumer.yamlとして保存します。apiVersion: v1 kind: Pod metadata: name: kafka-golang-consumer namespace: kafka labels: azure.workload.identity/use: "true" app.kubernetes.io/name: kafka-golang-consumer spec: serviceAccountName: workload-identity-sa runtimeClassName: kata-cc-isolation containers: - image: "mcr.microsoft.com/aci/skr:2.7" imagePullPolicy: Always name: skr env: - name: SkrSideCarArgs value: ewogICAgImNlcnRjYWNoZSI6IHsKCQkiZW5kcG9pbnRfdHlwZSI6ICJMb2NhbFRISU0iLAoJCSJlbmRwb2ludCI6ICIxNjkuMjU0LjE2OS4yNTQvbWV0YWRhdGEvVEhJTS9hbWQvY2VydGlmaWNhdGlvbiIKCX0gIAp9 command: - /bin/skr volumeMounts: - mountPath: /opt/confidential-containers/share/kata-containers/reference-info-base64 name: endor-loc - image: "mcr.microsoft.com/acc/samples/kafka/consumer:1.0" imagePullPolicy: Always name: kafka-golang-consumer env: - name: SkrClientKID value: kafka-encryption-demo - name: SkrClientMAAEndpoint value: sharedeus2.eus2.test.attest.azure.net - name: SkrClientAKVEndpoint value: "myKeyVault.vault.azure.net" - name: TOPIC value: kafka-demo-topic command: - /consume ports: - containerPort: 3333 name: kafka-consumer resources: limits: memory: 1Gi cpu: 200m volumes: - name: endor-loc hostPath: path: /opt/confidential-containers/share/kata-containers/reference-info-base64 --- apiVersion: v1 kind: Service metadata: name: consumer namespace: kafka spec: type: LoadBalancer selector: app.kubernetes.io/name: kafka-golang-consumer ports: - protocol: TCP port: 80 targetPort: kafka-consumer注
ポッド環境変数
SkrClientAKVEndpointの値を、お使いの Azure Key Vault の URL と一致するように更新します (プロトコルの値https://は除きます)。 現在値のプレースホルダー値はmyKeyVault.vault.azure.netです。 ポッド環境変数SkrClientMAAEndpointの値をMAA_ENDPOINTの値で更新します。MAA_ENDPOINTの値は、コマンドecho $MAA_ENDPOINTまたはコマンドaz attestation show --name "myattestationprovider" --resource-group "MyResourceGroup" --query 'attestUri' -o tsv | cut -c 9-を実行して確認できます。次のコマンドを実行して、Kafka コンシューマー YAML マニフェストのセキュリティ ポリシーを生成し、
WORKLOAD_MEASUREMENT変数に格納されているセキュリティ ポリシーのハッシュを取得します。export WORKLOAD_MEASUREMENT=$(az confcom katapolicygen -y consumer.yaml --print-policy | base64 -d | sha256sum | cut -d' ' -f1)RSA 非対称キーの組 (公開キーと秘密キー) を生成するために、次のコマンドで
setup-key.shスクリプトを実行します。<Azure Key Vault URL>の箇所は、<your-unique-keyvault-name>.vault.azure.netの値に置き換えます。export MANAGED_IDENTITY=${USER_ASSIGNED_CLIENT_ID} bash setup-key.sh "kafka-encryption-demo" <Azure Key Vault URL>注
bash スクリプト
setup-key.shには、環境変数のMANAGED_IDENTITYが必要です。公開キーは、bash スクリプトの実行後に
kafka-encryption-demo-pub.pemとして保存されます。
重要
エラー
ForbiddenByRbacが表示された場合は、最大 24 時間待ちます。 マネージド ID のバックエンド サービスは、リソース URI ごとに最大 24 時間キャッシュされます。 詳細については、「Azure RBAC のトラブルシューティング」を参照してください。キーをキー コンテナーに正常にアップロードできたことを確認するには、次のコマンドを実行します。
az account set --subscription <Subscription ID> az keyvault key list --vault-name <KeyVault Name> -o table次の YAML マニフェストをコピーし、
producer.yamlとして保存します。apiVersion: v1 kind: Pod metadata: name: kafka-producer namespace: kafka spec: containers: - image: "mcr.microsoft.com/acc/samples/kafka/producer:1.0" name: kafka-producer command: - /produce env: - name: TOPIC value: kafka-demo-topic - name: MSG value: "Azure Confidential Computing" - name: PUBKEY value: |- -----BEGIN PUBLIC KEY----- MIIBojAN***AE= -----END PUBLIC KEY----- resources: limits: memory: 1Gi cpu: 200m注
文字列
-----BEGIN PUBLIC KEY-----で始まって文字列-----END PUBLIC KEY-----で終わる値を、前のステップで作成したkafka-encryption-demo-pub.pemの内容で更新します。前に保存しておいたファイルを使用し、
consumerとproducerの YAML マニフェストをデプロイします。kubectl apply -f consumer.yamlkubectl apply -f producer.yaml次のコマンドを使用して、Web サービスの IP アドレスを取得します。
kubectl get svc consumer -n kafkaコンシューマー サービスの外部 IP アドレスをコピーしてブラウザに貼り付け、復号化されたメッセージを確認します。
コマンドの出力は、次の例のようになります。
Welcome to Confidential containers on AKS! Encrypted Kafka Message: Msg 1: Azure Confidential Computingさらに、
skr containerとkata-cc runtime classの指定を削除することにより、コンシューマーを通常の Kubernetes ポッドとして実行してみることをお勧めします。コンシューマーの実行に kata-cc ランタイム クラスを使用しなくなると、以後、このポリシーは必要ありません。ポリシー全体を削除し、ワークロードを再デプロイした後、ブラウザーでメッセージを再度確認してください。 秘密暗号化キーを取得できず、メッセージは base64 でエンコードされた暗号化テキストとして表示されます。 これは、コンシューマーの実行環境が機密環境ではなくなり、
skr containerがないため、キーを取得できずメッセージを復号化できなくなったことを示しています。
リソースをクリーンアップする
この機能の評価が完了したら、不要なリソースをクリーンアップして、Azure料金を回避します。 評価またはテストの一環として新しいクラスターをデプロイした場合は、 az aks delete コマンドを使用してクラスターを削除できます。
az aks delete --resource-group myResourceGroup --name myAKSCluster
既存のクラスターで Confidential コンテナー (プレビュー) を有効にした場合は、 kubectl delete pod コマンドを使用してポッドを削除できます。
kubectl delete pod <pod-name>
次のステップ
ハードウェアの分離と Azure プラットフォームのメンテナンス イベントの制御を使用するための、AKS クラスターを持つノード用の Azure 専用ホストの詳細について確認します。