Azure Firewall for Containers (preview) の展開

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 パブリック クラウドでのみサポートされます。

リソースをクリーンアップする

管理しているリソースを削除する間、コントローラーを起動させ続けてください。 先にコントローラーをアンインストールすると、リソースの調整や削除が完了しないことがあります。

  1. テストポッドのシェルを終了し、テストポッドを削除してください。

    kubectl delete pod developer-pod developer-pod-2 --namespace default
    
  2. 添付ファイルを削除し、削除が完了するのを待ちます。 その後、ポッドSNATが復旧するまで約90秒待ちます。

    kubectl delete securitypolicyattachment example-attachment --namespace default
    kubectl wait --for=delete securitypolicyattachment/example-attachment \
      --namespace default --timeout=30m
    sleep 90
    
  3. サブネットの以前のルーティングと、ロールバックプランに従ってクラスタに必要なアウトバウンド構成を復元します。 もともとサブネットにルートテーブルがない場合は、ルートテーブルの関連付けを削除してください。 そうでない場合は、元のテーブルを復元してください。

    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を変更した場合は、元の設定も復元してください。 クラスターの接続を確認します。 これから削除しようとしているファイアウォールへのルートを残さないでください。

  4. 関連付けを削除した後に評価ポリシーを削除します。

    kubectl delete securitypolicy example-securitypolicy-rules --namespace default
    
  5. この手順で管理ファイアウォールを作成している場合は、コントローラーが稼働している間にそのカスタムリソースを削除してください:

    kubectl delete azurefirewall example-firewall --namespace default
    kubectl wait --for=delete azurefirewall/example-firewall \
      --namespace default --timeout=40m
    

    削除には20〜30分かかることがあります。 関連する Azure 展開が削除されたことを確認してください。 リソースIDで指定した既存のファイアウォールを削除しないでください。

  6. マネージドリソースの削除が完了したら、コントローラーをアンインストールしてください。

    helm uninstall azfw-controller --namespace "$HELM_NAMESPACE"
    
  7. コントローラー名前空間は、この手順専用に作成し、必要なリソースが含まれていない場合のみ削除してください。

前述のコマンドは、AKS クラスター、仮想ネットワーク、サブネット、パブリック IP リソース、ルートテーブル、ID または役割割り当てを削除しません。 他のワークロードが使用していないことを確認した後、この評価専用に作成したリソースのみを削除してください。 特に、既存のネットワークリソースを維持し、元の構成を復元します。