Azure Firewall for Containersでは、Kubernetesのカスタムリソースを通じてAzure Kubernetes Service (AKS)ワークロードのAzure Firewall保護を管理できます。 Azure Firewall ControllerはこれらのリソースをAzure Firewallの設定およびポリシーに変換します。
この記事では、AKS クラスターを作成するか既存のクラスタを使用し、コントローラをインストールし、ファイアウォールを作成し、選択したポッドの送信トラフィックの保護を構成します。
Tip
Azure Resource Manager (ARM) テンプレートを使用して新しい AKS クラスターと Azure Firewall を作成するには、ARM テンプレート クイックスタートを使用してください。
Important
Azure Firewall for Containers は現在パブリックプレビューです。 ベータ版、プレビュー版、または他の方法で一般公開されていない Azure の機能に適用される法的条件については、Microsoft Azure プレビューの追加利用規約を参照してください。
構成モデルを理解する
コントローラーは3つのカスタムリソース定義(CRD)を使用します:
| Resource | Purpose |
|---|---|
AzureFirewall |
Azure Firewall のデプロイを作成および管理します。 |
SecurityPolicy |
詳細ファイアウォール設定、ネットワークルール、アプリケーションルール、またはこれらの設定の組み合わせを定義します。 |
SecurityPolicyAttachment |
セキュリティポリシーを参照し、ファイアウォールを特定し、AKS ワークロードのサブネットを一覧表示します。 コントローラーは参照されたポリシーを子の Azure Firewall ポリシーにまとめます。 |
SecurityPolicyはSecurityPolicyAttachmentが参照するまでトラフィックには適用されません。 アプリケーショントラフィックもファイアウォールを通過する必要があります。
コントローラーはルールコレクション用のポッドおよび名前空間セレクターをサポートしています。 高度な設定には、侵入検知・防止(IDPS)、DNS、脅威インテリジェンス、およびソースネットワークアドレス変換(SNAT)が含まれます。 機能の利用可能性はファイアウォールSKUとその構成にも依存します。
Prerequisites
- サポートされているプレビューリージョンにおける Azure サブスクリプションと Azure Firewall for Containers へのアクセス。
- 自分の仮想ネットワークで Azure CNI を使用する AKS クラスター、またはそれを作成する権限。 Azure CNI Overlay はサポートされていません。 この手順では、同じリソースグループ内のクラスタと仮想ネットワークを使用します。
- コントローラをインストールしてファイアウォールを準備する間のクラスタの送信接続パス ルーティングを変更する前に、クラスタの アウトバウンドタイプ と 必要なアウトバウンド接続を計画してください。
- ポッドのトラフィックは、ノードIPにマスカレードされるのではなく、送信元としてポッドIPのままファイアウォールに到達する必要があります。 最初のポリシー添付で、コントローラーはポッドSNATをオフにする
kube-system/azure-ip-masq-agent-configを作成します。 すでにカスタムip-masq-agent設定がある場合は、このエグレストラフィックがマスカレードされないようにしてください。 - 既存のファイアウォールを使用しているか、独自の基本ポリシーを提供する場合は、必要なAKSのアウトバウンドトラフィックとポート443のHTTPSを
*.afc.azure.comに許可してください。 コントローラーが作成した基本ポリシーにはすでにこれらのルールが提供されています。 - このウォークスルーでは、クラスタの管理、CRD のインストール、および Azure ネットワークリソースの作成を行う権限が必要です。
- ユーザー割り当てマネージド ID を作成し、その必要な役割を割り当てる権限。 ロール割り当てを作成するには、割り当て範囲に適切な役割(Role Based Access Control Administrator)が必要です。
- Azure CLI、kubectl、および Helm。
- Bash 環境(例えば Azure Cloud Shell の Bash モード)。
Important
Azure CNI Overlay はサポートされていません。 クラスターは、仮想ネットワークのポッド IP を使用する Azure CNI を使用しなければなりません (networkPlugin は azure で、networkPluginMode は設定されていません)。
Warning
AKSサブネットのルートテーブルやクラスタ送信タイプを変更すると、クラスタおよびアプリケーションの接続が中断される可能性があります。 まずは隔離された評価環境を使用してください。 出口を変更する前に既存の構成を記録し、ロールバック計画を準備してください。
プレビューは以下の地域で Azure パブリッククラウドをサポートしています。 プレビューサブスクリプションで有効になっているリージョンを使用してください。
| Region | Azure CLI 値 |
|---|---|
| 米国中部 EUAP | centraluseuap |
| 米国東部 2 EUAP | eastus2euap |
| 米国中西部 | westcentralus |
| 東アジア | eastasia |
| 英国南部 | uksouth |
| 米国中部 | centralus |
環境を設定する
2つのプレースホルダー値を置き換えます。 その他の名前は例です。必要に応じて変更し、既存のクラスタの場合は既存のリソース名を使用してください。 表示されているコントローラーのバージョンをそのままにしてください。 この記事のすべてのコマンドには Bash を使用してください。
# Required: replace these placeholders.
SUBSCRIPTION_ID='<subscription-id>'
LOCATION='<preview-region>'
# Example names: change as needed. For an existing cluster, use your existing resource names.
RESOURCE_GROUP='afc-rg'
VNET_NAME='afc-vnet'
VNET_CIDR='10.224.0.0/12'
AKS_SUBNET_NAME='aks-subnet'
AKS_SUBNET_CIDR='10.224.0.0/16'
AKS_NAME='aks-cluster'
VM_SIZE='Standard_DS3_v2' # must be available in your region
IDENTITY_RESOURCE_NAME='azure-firewall-identity'
HELM_NAMESPACE='firewall-namespace'
# Fixed value: the supported Azure Firewall Controller version for this preview. Use it as shown.
CONTROLLER_VERSION='20261109.1'
az login
az account set --subscription "$SUBSCRIPTION_ID"
例はコントローラーチャートのバージョン 20261109.1を使用しています。 選択した地域で利用可能な仮想マシンサイズを選択してください。
リソースプロバイダーを登録する:
az provider register --namespace Microsoft.ContainerService --wait
az provider register --namespace Microsoft.Network --wait
AKSクラスターの準備
既存のクラスターを使う方法または新規クラスターを作成する方法を選択します。
既存のクラスターを使用する
ネットワーク構成を確認してください:
az aks show \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--query 'networkProfile.{plugin:networkPlugin, mode:networkPluginMode}' -o json
ネットワークプラグインはazureでなければならず、そのモードはoverlayでなければならず、nullではありません。 クラスタのリージョンを取得する:
LOCATION=$(az aks show \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--query location -o tsv)
新しいクラスターを作成する
新しい評価環境では、リソースグループ、仮想ネットワーク、および AKS サブネットを作成します。
az group create --name "$RESOURCE_GROUP" --location "$LOCATION"
az network vnet create \
--resource-group "$RESOURCE_GROUP" \
--name "$VNET_NAME" \
--location "$LOCATION" \
--address-prefixes "$VNET_CIDR"
az network vnet subnet create \
--resource-group "$RESOURCE_GROUP" \
--vnet-name "$VNET_NAME" \
--name "$AKS_SUBNET_NAME" \
--address-prefixes "$AKS_SUBNET_CIDR" \
--default-outbound-access false
AKS_SUBNET_ID=$(az network vnet subnet show \
--resource-group "$RESOURCE_GROUP" \
--vnet-name "$VNET_NAME" \
--name "$AKS_SUBNET_NAME" \
--query id -o tsv)
az aks create \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--location "$LOCATION" \
--node-vm-size "$VM_SIZE" \
--vnet-subnet-id "$AKS_SUBNET_ID" \
--network-plugin azure \
--enable-oidc-issuer \
--enable-workload-identity \
--generate-ssh-keys
このパスは、ファイアウォールルートを作成する前にクラスタブートストラップ接続を利用可能に保ちます。 そのルートが存在する前には、userDefinedRouting は選択されません。
ネットワーク構成を記録する
どちらのパスについても、AKS サブネット ID を取得し、ルートテーブル、アウトバウンドタイプ、および DNS サーバーを変更する前に記録してください:
AKS_SUBNET_ID=$(az network vnet subnet show \
--resource-group "$RESOURCE_GROUP" \
--vnet-name "$VNET_NAME" \
--name "$AKS_SUBNET_NAME" \
--query id -o tsv)
ORIGINAL_ROUTE_TABLE_ID=$(az network vnet subnet show \
--resource-group "$RESOURCE_GROUP" \
--vnet-name "$VNET_NAME" \
--name "$AKS_SUBNET_NAME" \
--query routeTable.id -o tsv)
echo "$ORIGINAL_ROUTE_TABLE_ID"
az aks show \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--query networkProfile.outboundType -o tsv
az network vnet show \
--resource-group "$RESOURCE_GROUP" \
--name "$VNET_NAME" \
--query dhcpOptions.dnsServers -o json
ルートテーブルがすでにサブネットに関連付けられている場合は、必要なルートを保持してください。 他のワークロードへの影響を評価せずに、共有ルートテーブルをサンプルテーブルに置き換えないでください。
ワークロード ID を構成する
既存のクラスタでは、OpenID Connect(OIDC)issuer およびワークロード ID を有効にします。 new-clusterコマンドはすでにそれらを有効にしています。 発行元のURLを取得する前に、更新が完了するまで待ちましょう。
az aks update \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--enable-oidc-issuer \
--enable-workload-identity
コントローラー用の専用ユーザー割り当てマネージド ID を作成します:
az identity create \
--resource-group "$RESOURCE_GROUP" \
--name "$IDENTITY_RESOURCE_NAME"
IDENTITY_PRINCIPAL_ID=$(az identity show \
--resource-group "$RESOURCE_GROUP" \
--name "$IDENTITY_RESOURCE_NAME" \
--query principalId -o tsv)
IDENTITY_CLIENT_ID=$(az identity show \
--resource-group "$RESOURCE_GROUP" \
--name "$IDENTITY_RESOURCE_NAME" \
--query clientId -o tsv)
RESOURCE_GROUP_ID=$(az group show \
--name "$RESOURCE_GROUP" \
--query id -o tsv)
ROLE_ASSIGNMENT_ID=$(az role assignment create \
--assignee-object-id "$IDENTITY_PRINCIPAL_ID" \
--assignee-principal-type ServicePrincipal \
--role 'Network Contributor' \
--scope "$RESOURCE_GROUP_ID" \
--query id -o tsv)
コントローラーはこのIDを使ってファイアウォールおよびファイアウォールポリシーを管理します。 これらのリソースが別のリソースグループに属している場合は、そのリソースグループのスコープで必要なネットワークコントリビューターアクセス権もそのIDに付与してください。 認証失敗を診断する前に、アイデンティティおよびロール割り当ての変更が伝播する時間を確保してください。
フェデレーテッド認証情報を作成する:
AKS_OIDC_ISSUER=$(az aks show \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--query oidcIssuerProfile.issuerUrl -o tsv)
az identity federated-credential create \
--resource-group "$RESOURCE_GROUP" \
--identity-name "$IDENTITY_RESOURCE_NAME" \
--name "$IDENTITY_RESOURCE_NAME" \
--issuer "$AKS_OIDC_ISSUER" \
--subject "system:serviceaccount:${HELM_NAMESPACE}:azurefirewall-controller-sa" \
--audience api://AzureADTokenExchange
フェデレーテッドサブジェクト内の名前空間は、Helm チャートをインストールする際に使用する名前空間と一致しなければなりません。 チャートは azurefirewall-controller-sa サービスアカウントを作成します。
Azure Firewall コントローラーをインストールする
kubectlをクラスタに接続し、コントローラーをインストールしてください:
az aks get-credentials \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME"
helm install azfw-controller \
oci://mcr.microsoft.com/firewall/charts/azurefirewall-controller \
--namespace "$HELM_NAMESPACE" \
--version "$CONTROLLER_VERSION" \
--set "azfwController.podIdentity.clientID=$IDENTITY_CLIENT_ID" \
--create-namespace
kubectl get pods --namespace "$HELM_NAMESPACE"
先に進む前に、コントローラーポッドが稼働し、コンテナが準備完了であることを確認してください。
既存の Helm リリースの場合は、helm upgrade ではなく helm install を使用してください:
helm upgrade azfw-controller \
oci://mcr.microsoft.com/firewall/charts/azurefirewall-controller \
--namespace "$HELM_NAMESPACE" \
--version "$CONTROLLER_VERSION" \
--set "azfwController.podIdentity.clientID=$IDENTITY_CLIENT_ID"
ファイアウォールリソースを準備する
ファイアウォールリソースはファイアウォールサブネット、管理サブネット、1つのデータプレーンパブリックIPリソース、および管理パブリックIPリソースを使用します。 既に存在する適切なリソースの作成はスキップしてください。
サブネット名はそれぞれ AzureFirewallSubnet と AzureFirewallManagementSubnet でなければなりません。 既存の仮想ネットワーク内で、AKSサブネットやその他のサブネットと重複しないアドレス範囲を選択してください。 次の範囲の例では、それらを含む仮想ネットワークのアドレス空間が必要です:
FW_SUBNET_NAME='AzureFirewallSubnet'
MGMT_SUBNET_NAME='AzureFirewallManagementSubnet'
FW_SUBNET_CIDR='10.225.0.0/26'
MGMT_SUBNET_CIDR='10.225.1.0/26'
FW_IP='fw-ip'
FW_MGMT_IP='fw-mgmt-ip'
az network vnet subnet create \
--resource-group "$RESOURCE_GROUP" \
--vnet-name "$VNET_NAME" \
--name "$FW_SUBNET_NAME" \
--address-prefixes "$FW_SUBNET_CIDR" \
--default-outbound-access false
az network vnet subnet create \
--resource-group "$RESOURCE_GROUP" \
--vnet-name "$VNET_NAME" \
--name "$MGMT_SUBNET_NAME" \
--address-prefixes "$MGMT_SUBNET_CIDR" \
--default-outbound-access false
az network public-ip create \
--resource-group "$RESOURCE_GROUP" --name "$FW_IP" \
--location "$LOCATION" --sku Standard \
--allocation-method Static --version IPv4
az network public-ip create \
--resource-group "$RESOURCE_GROUP" --name "$FW_MGMT_IP" \
--location "$LOCATION" --sku Standard \
--allocation-method Static --version IPv4
リソースIDを取得します。 カスタムリソースには公開IPアドレス値ではなくAzureリソースIDが必要です。
FW_SUBNET_ID=$(az network vnet subnet show \
--resource-group "$RESOURCE_GROUP" --vnet-name "$VNET_NAME" \
--name "$FW_SUBNET_NAME" --query id -o tsv)
MGMT_SUBNET_ID=$(az network vnet subnet show \
--resource-group "$RESOURCE_GROUP" --vnet-name "$VNET_NAME" \
--name "$MGMT_SUBNET_NAME" --query id -o tsv)
FW_IP_ID=$(az network public-ip show \
--resource-group "$RESOURCE_GROUP" --name "$FW_IP" --query id -o tsv)
FW_MGMT_IP_ID=$(az network public-ip show \
--resource-group "$RESOURCE_GROUP" --name "$FW_MGMT_IP" --query id -o tsv)
ファイアウォールを作成する
firewall.yamlを作成します。 引用符のない heredoc は resource-ID 変数を展開します。
cat > firewall.yaml <<EOF
apiVersion: firewall.networking.azure.io/v1alpha1
kind: AzureFirewall
metadata:
name: example-firewall
namespace: default
spec:
data:
subnetId: ${FW_SUBNET_ID}
ipAddresses:
- ${FW_IP_ID}
management:
subnetId: ${MGMT_SUBNET_ID}
ipAddress: ${FW_MGMT_IP_ID}
EOF
kubectl apply -f firewall.yaml
kubectl wait --for=jsonpath='{.status.conditions[?(@.type=="Deployment")].reason}'=Ready \
azurefirewall/example-firewall --namespace default --timeout=30m
kubectl get azurefirewall example-firewall --namespace default -o yaml
既存のファイアウォールポリシーのリソースIDを使って spec.firewallPolicyReference を追加することもできます。 参照がない場合、コントローラーはマネージドポリシーを作成します。
作成には10〜15分かかることもあります。
Deployment状態の理由がReadyになるのを待ちましょう。 条件の状態のみを待つと、Azure 展開がまだ進行中であっても処理が返ることがあります。 続行する前に、他の返された条件を確認し、報告されたエラーを解決してください。
展開済みファイアウォールのプライベート IP アドレスを、そのステータスから読み取る:
FW_PRIVATE_IP=$(kubectl get azurefirewall example-firewall --namespace default \
-o jsonpath='{.status.firewallResourceInfo.privateIPAddress}')
echo "$FW_PRIVATE_IP"
既存のファイアウォールを使用するには、AzureFirewallリソースの作成を飛ばし、この記事後半で説明する添付ファイル内のAzureリソースIDを使用してください。 既存のファイアウォールはクラシックルールではなくファイアウォールポリシーを使用する必要があります。
ルーティングを構成する前に、そのパスに対して FW_PRIVATE_IP を既存のファイアウォールのプライベート IP アドレスに設定してください:
FW_PRIVATE_IP='<existing-firewall-private-ip>'
セキュリティ ポリシーを構成する
以下のポリシーは、role: developer というラベルのポッドを選択し、テストで使用された Microsoft および Google サブドメインへの HTTPS リクエストを許可します。 このポリシーは AKS インフラストラクチャルールに代わるものではありません。
security-policy.yamlを作成します。
apiVersion: firewall.networking.azure.io/v1alpha1
kind: SecurityPolicy
metadata:
name: example-securitypolicy-rules
namespace: default
spec:
applicationRuleCollections:
- name: test-application-rules
refs:
- podSelector:
matchLabels:
role: developer
action: Allow
egress:
- name: allow-test-destinations
toPortProtocol:
- protocolType: HTTPS
port: 443
to:
- fqdn:
- "*.microsoft.com"
- "*.google.com"
ポリシーを適用:
kubectl apply -f security-policy.yaml
ネットワークおよびアプリケーションルールのオプション
各コレクションはrefsを使ってポッド、名前空間、またはその両方を選択し、AllowまたはDenyのactionを選びます。
| Collection | 構成オプション |
|---|---|
networkRuleCollections |
TCP、UDP、ICMP、または ANY;ポート;IPアドレス;IPグループ;サービスタグ;およびFQDN。 |
applicationRuleCollections |
HTTP、HTTPS、またはMSSQL;ポート;FQDN;FQDN タグ;URL;およびウェブカテゴリ。 |
例えば、以下の spec フラグメントはDNSプロキシを有効にし、開発者用ポッドを選択しTCPポート443トラフィックを google.comするネットワークルールコレクションを追加します。 このオプションの例を、期待されるテスト結果を再評価せずにアプリケーション専用テストポリシーに追加しないでください。
dns:
dnsProxy: Enabled
networkRuleCollections:
- name: example-network-rules
refs:
- podSelector:
matchLabels:
role: developer
action: Allow
egress:
- name: allow-google
toPortProtocol:
- protocolType: TCP
port: 443
to:
- fqdn:
- google.com
ネットワークルール内のFQDN宛先には dns.dnsProxy: Enabledが必要です。 ポッドはファイアウォールを通じてFQDNを解決しなければならず、ポッドのDNSとファイアウォールのDNSが異なるIPアドレスに解決しないようにします。
このオプションのネットワークルール例では、まずポリシーをアタッチし、「 ポリシーのアタッチ」に説明されている通り、準備が整うまで待ちます。 その後、Pod DNS がファイアウォールを使用するように設定してください。 一つの方法は、仮想ネットワークのDNSサーバーをファイアウォールのプライベートIPに設定することです:
az network vnet update \
--resource-group "$RESOURCE_GROUP" \
--name "$VNET_NAME" \
--dns-servers "$FW_PRIVATE_IP"
仮想ネットワークのDNSを変更すると、そのネットワーク内の他のワークロードにも影響が出ます。 まず元のDNS設定を記録し、メンテナンス手順でAKSノードを再起動して変更を認識させます。 または、CoreDNS がファイアウォールに転送するように設定します。 HTTP および HTTPS アプリケーションルールは、この DNS 解決パスを必要としません。
アプリケーションルールは tlsInspection: Enabledを使用できます。 TLS 検査には、適切なファイアウォール SKU、証明書の構成、およびクライアントの信頼も必要です。
Azure Firewall Premium 証明書を参照してください。
AKSトラフィックをファイアウォール経由でルーティングする
Important
ポリシーを関連付ける前にルーティングを設定します。 アタッチメントはポッドのSNATをオフにし、ファイアウォールがポッドの送信元IPを認識できるようにします。 ファイアウォール ルートがない場合、アタッチメントが有効になるとすぐに、ポッドはアウトバウンド接続を失う可能性があります。
コントローラーが基本ポリシーを作成すると、すでに TCP ポート 443 を AzureKubernetesService サービスタグに、HTTPS ポート 443 を AzureKubernetesService FQDN タグに、HTTPS ポート 443 を *.afc.azure.com に許可しています。
既存のファイアウォールを使用する場合、または firewallPolicyReference を指定する場合は、ルーティングを変更する前に、ベースポリシーで、必要な AKS ネットワーク規則と FQDN 規則に相当する規則 と、*.afc.azure.com への HTTPS ポート 443 を構成してください。 コントローラーは提供された基本ポリシーを変更しません。 クラスタサービス、DNS、およびイメージプルの接続性を維持します。 コントローラー管理のチャイルドポリシーを直接編集しないでください。
既存のルートテーブルがない専用の評価サブネットの場合、次のテーブルを作成します。 ファイアウォールの状態から取得した FW_PRIVATE_IP 、または既存のファイアウォールのプライベート IP を使用してください。
FW_ROUTE_TABLE_NAME='fw-rt'
FW_ROUTE_NAME='to-firewall'
az network route-table create \
--resource-group "$RESOURCE_GROUP" \
--location "$LOCATION" \
--name "$FW_ROUTE_TABLE_NAME"
az network route-table route create \
--resource-group "$RESOURCE_GROUP" \
--route-table-name "$FW_ROUTE_TABLE_NAME" \
--name "$FW_ROUTE_NAME" \
--address-prefix 0.0.0.0/0 \
--next-hop-type VirtualAppliance \
--next-hop-ip-address "$FW_PRIVATE_IP"
az network vnet subnet update \
--resource-group "$RESOURCE_GROUP" \
--vnet-name "$VNET_NAME" \
--name "$AKS_SUBNET_NAME" \
--route-table "$FW_ROUTE_TABLE_NAME"
kubectl get nodes
すでにルートテーブルが存在する場合は、そのテーブルを置き換えるのではなく、ファイアウォールのデフォルトルートを追加します。 そのほかの必要なルートは保持してください。
ルートテーブルを関連付けても AKS outboundType は変わりません。 設計上 userDefinedRouting への移行が必要な場合は、送信タイプでクラスタ egress をカスタマイズ のサポートされている移行手順に従ってください。 続行する前に、エグレス構成を完了し、クラスタの接続性を確認してください。
保険証券を添付してください
ルーティングが完了したら、attachment.yamlポリシーとマネージド ファイアウォールを作成します。 この例では、この手順で作成したポリシーおよび管理ファイアウォールを参照しています。
cat > attachment.yaml <<EOF
apiVersion: firewall.networking.azure.io/v1alpha1
kind: SecurityPolicyAttachment
metadata:
name: example-attachment
namespace: default
spec:
securityPolicyRefs:
- name: example-securitypolicy-rules
namespace: default
firewallRef:
name: example-firewall
namespace: default
aksWorkloadSubnets:
- ${AKS_SUBNET_ID}
EOF
kubectl apply -f attachment.yaml
kubectl wait --for=jsonpath='{.status.conditions[?(@.type=="Deployment")].reason}'=Ready \
securitypolicyattachment/example-attachment --namespace default --timeout=30m
kubectl get securitypolicyattachment example-attachment --namespace default -o yaml
既存のファイアウォールの場合、名前と名前空間を id のものに置き換えてください。
firewallRef:
id: <firewall-resource-id>
| フィールド | Description |
|---|---|
securityPolicyRefs |
結合するポリシー(名前と名前空間で識別)。 |
firewallRef |
Required. 管理対象ファイアウォールの Kubernetes 名と名前空間、または既存のファイアウォールの Azure リソース ID のいずれかです。 |
aksWorkloadSubnets |
Required. ファイアウォールで保護されている AKS サブネットの Azure リソース ID。 |
そのアタッチメントの Deployment 条件理由が Ready になるのを待ち、その状態が true になるのを待つだけではありません。 参照解決や受入条件も確認してください。
ポリシーの更新、優先順位、および削除
IDPS、脅威インテリジェンス、DNS、SNATはポリシー全体の設定です。 複数のポリシーが同じ設定を設定している場合、securityPolicyRefs では最初のポリシーが優先されます。
Azure がポリシーバージョンを拒否した場合、コントローラーは最後に確認されている正常なバージョンを保持するか、良いバージョンがなければそのポリシーを省略します。 根底にあるエラーが消えたからといって、拒否されたバージョンを再試行することはありません。 問題を修正し、ポリシーの spec を変更してから再適用してください。
ポリシーリソースを削除する前に、 securityPolicyRefs からポリシーを削除してください。 そうでなければ、削除がハングすることがあります。 拒否されたポリシーを再作成するには、まずデタッチし、削除してから再作成して再アタッチします。
アプリケーション トラフィックをテストする
ポリシーによって選択されるラベルでテストポッドを作成します:
kubectl apply -f - <<'EOF'
apiVersion: v1
kind: Pod
metadata:
name: developer-pod
namespace: default
labels:
role: developer
spec:
containers:
- name: developer
image: mcr.microsoft.com/azure-cli:latest
command: ["sleep", "infinity"]
EOF
kubectl wait --for=condition=Ready pod/developer-pod \
--namespace default --timeout=5m
ポッドが稼働した後、シェルを開きます:
kubectl exec --namespace default -it developer-pod -- /bin/bash
ポッドシェルから許可された宛先をテストします:
curl --connect-timeout 10 --max-time 30 https://www.google.com
curl --connect-timeout 10 --max-time 30 https://www.microsoft.com
次に、例のポリシーで許可されていない目的地をテストします:
curl --connect-timeout 10 --max-time 30 https://www.bing.com
echo "$?"
意図された隔離ポリシー構成では、最初の2つのリクエストは許可され、Bingリクエストは拒否されます。 拒否された HTTPS リクエストの場合、ファイアウォールは TLS 接続をリセットし、curl は出口コード 35 を返します。 結果を Azure Firewall ログおよび展開したポリシーと関連付けます。 タイムアウトやTLSエラーだけでは、どのファイアウォールルールがリクエストを処理したかを証明できません。
添付ファイルの Deployment 状態の理由が Ready になった後、ルールやラベルの変更がファイアウォールに到達するまでに数分かかることがあります。 結果が期待通りでない場合は、収束の時間を確保し、トラブルシューティング前に再試行してください。
終了したらポッドのシェルを終了してください:
exit
新しいポッドがポリシーに一致しているか確認する
既存のポリシーが収束した後、同じラベルを持つ別のポッドを作成します。
kubectl run developer-pod-2 --namespace default --labels=role=developer \
--image=mcr.microsoft.com/azure-cli:latest --command -- sleep infinity
kubectl wait --for=condition=Ready pod/developer-pod-2 \
--namespace default --timeout=5m
kubectl exec developer-pod-2 --namespace default -- \
curl -sS -o /dev/null -w '%{http_code}\n' --max-time 30 https://www.microsoft.com
新しいラベル付きポッドは、Azure Resource Manager のデプロイメントなしで数秒で許可されます。 このファストパスポッドの更新は、ポリシーやラベル変更のための収束時間とは別です。
詳細ポリシー設定を構成する
SecurityPolicyは以下の設定を定義することもできます。 別のポリシーは、添付ファイルによって参照されて初めて有効になります。 すべての例をテスト環境に適用するのではなく、各機能を個別に評価してください。
| Setting | オプション |
|---|---|
| 侵入検知および防止システム (IDPS) |
Disabled、AlertOnly、または AlertAndDeny、署名のオーバーライド、およびプライベート範囲。 |
| 脅威情報 |
Disabled、AlertOnly、または AlertAndDeny; 許可されるCIDRおよびFQDN。 |
| DNS |
dnsProxyをEnabledまたはDisabledに設定し、必要に応じてcustomNameServersを指定します。 カスタムサーバーを使わない場合、構成は Azure DNS を使用します。 |
| SNAT |
Always、Never または Exclude
Excludeはexclusionsと一緒にのみ指定します。 |
侵入検知および防止システム (IDPS)
以下の spec 断片はIDPSの設定を示しています。
ruleIDは引用符付きの文字列ではなく、数字でなければなりません。 例の署名 ID 2000015 を、上書きしたい署名の数値 ID に置き換えます。
idps:
mode: AlertAndDeny
ruleOverrides:
- ruleID: 2000015
mode: AlertOnly
privateIPRanges:
cidrs:
- 10.0.0.0/8
- 192.168.0.0/16
コントローラ管理の子ポリシーで bypassList を構成しないでください。 Azure はその設定を拒否します。 特定のIDPSバイパスが必要な場合は、自社で所有する適切なベースポリシーを設定してください。
脅威情報
以下の spec 断片は、脅威インテリジェンスを使用しながら特定の CIDR と FQDN を許可する方法を示しています:
threatIntelligence:
mode: AlertAndDeny
allow-list:
cidrs:
- 203.0.113.0/24
- 198.51.100.0/24
fqdns:
- example.com
- example.org
DNS
以下の spec フラグメントは DNS プロキシを有効にします。 DNS設計で必要な場合は、独自のリゾルバアドレスで customNameServers を構成してください。
dns:
dnsProxy: Enabled
customNameServers:
- <dns-server-ip-1>
- <dns-server-ip-2>
SNAT
以下の spec 断片は、一覧に挙げられたプライベートレンジをSNATから除外しています:
snat:
action: Exclude
exclusions:
autoLearnPrivateRanges: Enabled
privateRanges:
- 10.0.0.0/8
- 192.168.0.0/16
構成および展開のトラブルシューティング
まずコントローラーポッド、イメージ、ログから始めてください:
kubectl get pods --namespace "$HELM_NAMESPACE"
kubectl get pods --namespace "$HELM_NAMESPACE" \
-l app=azurefirewall-controller \
-o jsonpath='{.items[0].spec.containers[0].image}'
kubectl logs --namespace "$HELM_NAMESPACE" \
-l app=azurefirewall-controller
コントローライメージはパス mcr.microsoft.com/firewall/images/azurefirewall-controller を選択したバージョンタグとともに使用します。
リソースとその状況を確認:
kubectl get azurefirewall -A -o yaml
kubectl get securitypolicy -A -o yaml
kubectl get securitypolicyattachment -A -o yaml
| 現象 | チェック |
|---|---|
| 認証失敗またはHTTP 401 | OIDC 発行者、フェデレーテッド サブジェクト、名前空間、およびワークロード ID の設定を確認してください。 |
| 認可エラーまたは HTTP 403 | コントローラ識別子の役割割り当てとそのスコープを確認します。 |
| リソース検証エラー | リソースの状態条件を確認してください。 パブリック IP およびサブネットの値が有効な Azure リソース ID であることを確認してください。 |
| Azure の展開失敗 | 報告されたエラーと Azure アクティビティログを確認してください。 参照されているリソースが存在し、必要な場所にあることを確認します。 |
| 予期しないトラフィックの結果 | ルーティング、アタッチメントのデプロイ、セレクター、その他の該当するファイアウォールルールを確認します。 |
| FQDNネットワークルールが拒否されました | ポリシー内で dns.dnsProxy: Enabled を有効にする。 |
| FQDNネットワークルールが一致しません | 仮想ネットワークDNSまたはCoreDNSフォワーディングを使用して、ポッドがファイアウォール経由で宛先を解決することを確認してください。 |
FirewallPolicyChildPolicyIntrusionDetectionBypassTrafficSettingConfigurationError |
コントローラ管理ポリシーから bypassList を削除します。 |
ポリシーはProgrammed=Falseのままです |
拒否された構成を修正し、ポリシーの spec を変更してから再適用してください。 拒否されたバージョンは自動的に再試行されるわけではありません。 あるいは、切り離して削除して再作成する方法もあります。 |
SecurityPolicyの削除がハングします |
添付ファイルの securityPolicyRefs からそれを削除してから削除してください。 |
| ポッドはアタッチ後にインターネット接続が切れます | AKSサブネットのファイアウォールへの 0.0.0.0/0 ルートと、必要なAKSおよび *.afc.azure.com 退出ルールを確認してください。 |
| ラベル付きのポッドが予期せず拒否される | 収束するまで待ってから再試行してください。 プレビュー リージョン、非オーバーレイ Azure CNI、kube-system/azure-ip-masq-agent-config を確認してください。 ファイアウォールがノードのIPではなくポッドのIPを認識していることを確認してください。 |
ワークロード ID については、サービス アカウントおよびコントローラー pod の環境を確認してください:
kubectl get serviceaccount azurefirewall-controller-sa \
--namespace "$HELM_NAMESPACE" -o yaml
kubectl get pods --namespace "$HELM_NAMESPACE" \
-l app=azurefirewall-controller \
-o jsonpath='{.items[0].spec.containers[0].env}'
az role assignment list \
--assignee "$IDENTITY_CLIENT_ID" \
--scope "$RESOURCE_GROUP_ID"
azure.workload.identity/client-idサービスアカウントの注釈とポッドのazure.workload.identity/useラベルを確認してください。 ID クライアント ID は AZURE_CLIENT_ID を通じて提供されます。 ワークロード識別設定には、テナント、フェデレーテッド トークン ファイル、および authority host も提供されます。
プレビューの制限事項
- 各AKSクラスターは1つの
SecurityPolicyAttachmentと1つのAzure Firewallのみをサポートします。 各ファイアウォールは1つのクラスタのみをサポートします。 - プレビューはポッドの送信のみを検査し、IPv4のみをサポートします。
- Azure CNI Overlay はサポートされていません。
- ホストネットワークのポッドはノードIPを使用し、個別に選択することはできません。
- マネージドファイアウォールおよびファイアウォールポリシーの展開では、デフォルトでプレミアムSKUが使用されます。
- 既存の標準SKUファイアウォールとラベルベースのルールポリシーを利用できますが、プレミアム専用のIDPS、TLS検査、URLフィルタリングは利用できません。
- ベースポリシーは、すでに別のベースポリシーから継承してはなりません。
- 親ポリシーは Azure ポータルを通じて変更できます。 コントローラーは親ポリシーの変更を元に戻しません。
- Azure ポータルを通じてコントローラー管理の子ポリシーを変更しないでください。 Kubernetesこそがその正とする情報源です。
- 既存のファイアウォールはファイアウォールポリシーを使用する必要があります。 この統合にはクラシックルールはサポートされていません。
- CRDは
v1alpha1を使い、一般提供前に変更されることがあります。 - このプレビューは、一覧に記載されているプレビュー リージョンの Azure パブリック クラウドでのみサポートされます。
リソースをクリーンアップする
管理しているリソースを削除する間、コントローラーを起動させ続けてください。 先にコントローラーをアンインストールすると、リソースの調整や削除が完了しないことがあります。
テストポッドのシェルを終了し、テストポッドを削除してください。
kubectl delete pod developer-pod developer-pod-2 --namespace default添付ファイルを削除し、削除が完了するのを待ちます。 その後、ポッドSNATが復旧するまで約90秒待ちます。
kubectl delete securitypolicyattachment example-attachment --namespace default kubectl wait --for=delete securitypolicyattachment/example-attachment \ --namespace default --timeout=30m sleep 90サブネットの以前のルーティングと、ロールバックプランに従ってクラスタに必要なアウトバウンド構成を復元します。 もともとサブネットにルートテーブルがない場合は、ルートテーブルの関連付けを削除してください。 そうでない場合は、元のテーブルを復元してください。
if [ -n "$ORIGINAL_ROUTE_TABLE_ID" ]; then az network vnet subnet update \ --resource-group "$RESOURCE_GROUP" --vnet-name "$VNET_NAME" \ --name "$AKS_SUBNET_NAME" --route-table "$ORIGINAL_ROUTE_TABLE_ID" else az network vnet subnet update \ --resource-group "$RESOURCE_GROUP" --vnet-name "$VNET_NAME" \ --name "$AKS_SUBNET_NAME" --remove routeTable fiオプションのネットワークルールの例で仮想ネットワークDNSまたはCoreDNSを変更した場合は、元の設定も復元してください。 クラスターの接続を確認します。 これから削除しようとしているファイアウォールへのルートを残さないでください。
関連付けを削除した後に評価ポリシーを削除します。
kubectl delete securitypolicy example-securitypolicy-rules --namespace defaultこの手順で管理ファイアウォールを作成している場合は、コントローラーが稼働している間にそのカスタムリソースを削除してください:
kubectl delete azurefirewall example-firewall --namespace default kubectl wait --for=delete azurefirewall/example-firewall \ --namespace default --timeout=40m削除には20〜30分かかることがあります。 関連する Azure 展開が削除されたことを確認してください。 リソースIDで指定した既存のファイアウォールを削除しないでください。
マネージドリソースの削除が完了したら、コントローラーをアンインストールしてください。
helm uninstall azfw-controller --namespace "$HELM_NAMESPACE"コントローラー名前空間は、この手順専用に作成し、必要なリソースが含まれていない場合のみ削除してください。
前述のコマンドは、AKS クラスター、仮想ネットワーク、サブネット、パブリック IP リソース、ルートテーブル、ID または役割割り当てを削除しません。 他のワークロードが使用していないことを確認した後、この評価専用に作成したリソースのみを削除してください。 特に、既存のネットワークリソースを維持し、元の構成を復元します。