Azure 防火牆 for Containers 讓您透過 Kubernetes 自訂資源管理 Azure 防火牆 對 Azure Kubernetes Service (AKS) 工作負載的保護。 Azure 防火牆 Controller 會將這些資源轉換成 Azure 防火牆 的設定與政策。
在本文中,您將建立 AKS 叢集或使用現有叢集,安裝控制器、建立防火牆,並為所選 pod 的外出流量設定防護。
Tip
若要使用 Azure Resource Manager (ARM) 範本建立新的 AKS 叢集與 Azure 防火牆,請使用 ARM 範本快速入門。
Important
Azure 防火牆 for Containers 目前處於公開預覽階段。 請參閱Microsoft Azure 預覽的補充使用條款,以了解適用於 Azure 測試版、預覽版或其他尚未正式發布的功能的法律條款。
了解配置模型
控制器使用三個自訂資源定義(CRD):
| Resource | Purpose |
|---|---|
AzureFirewall |
建立並管理 Azure 防火牆 部署。 |
SecurityPolicy |
定義進階防火牆設定、網路規則、應用程式規則,或這些設定的組合。 |
SecurityPolicyAttachment |
參考安全原則、識別防火牆,並列出 AKS 工作負載子網路。 控制器會將所參照的政策合併成子 Azure 防火牆 政策。 |
A SecurityPolicy 在 a SecurityPolicyAttachment 引用之前不適用於交通。 應用程式流量也必須穿越防火牆。
控制器支援對規則集合使用 pod 與命名空間選擇器。 進階設定包括入侵偵測與防禦(IDPS)、DNS、威脅情報以及來源網路位址轉換(SNAT)。 功能可用性也取決於防火牆 SKU 及其配置。
Prerequisites
- Azure 訂閱及在支援預覽區域中存取 Azure 防火牆 for Containers。
- 在您自己的虛擬網路中使用 Azure CNI 的 AKS 叢集,或擁有建立該叢集的權限。 不支援 Azure CNI Overlay。 本導覽使用同一資源群組中的叢集與虛擬網路。
- 在安裝控制器並準備防火牆期間,叢集的外發連線路徑。 在變更路由之前,請規劃叢集的 輸出類型 及 所需的對外連線。
- Pod 流量必須以 pod IP 作為來源抵達防火牆,而非偽裝成節點 IP。 在第一次政策附加時,控制器會建立
kube-system/azure-ip-masq-agent-config關閉 pod SNAT 的設定。 如果您已經有自訂的ip-masq-agent設定,請確保它不會對這些輸出流量進行偽裝。 - 如果您使用現有的防火牆或自行提供基底原則,請允許 AKS 所需的輸出流量,以及對
*.afc.azure.com的 443 連接埠 HTTPS 流量。 由控制器建立的基礎原則已包含這些規則。 - 在此操作中取得管理叢集、安裝 CRD 及建立 Azure 網路資源的權限。
- 建立由使用者指派的受管理身份並指派其所需角色的權限。 建立角色指派需要在指派範圍內指定一個適當的角色,例如基於角色的 存取控制 管理員。
- Azure CLI、kubectl 和 Helm。
- Bash 環境,例如 Bash 模式下的 Azure Cloud Shell。
Important
不支援 Azure CNI Overlay。 叢集必須使用 Azure CNI,搭配來自虛擬網路的 pod IP(networkPlugin 為 azure,且未設定 networkPluginMode)。
Warning
變更 AKS 子網路的路由表或叢集出站類型可能會中斷叢集與應用程式的連線。 先使用隔離的評估環境。 在變更出口前,先記錄現有設定並準備回滾計畫。
預覽版支援以下區域的 Azure 公有雲。 請使用已為您的預覽訂閱啟用的區域。
| Region | Azure CLI value |
|---|---|
| 美國中部 EUAP | centraluseuap |
| 美國東部 2 EUAP | eastus2euap |
| 美國中西部 | westcentralus |
| 東亞 | eastasia |
| 英國南部 | uksouth |
| Central US | centralus |
進行環境設定
替換兩個佔位符值。 其他名稱只是範例;視需要變更它們,對於現有叢集,請使用您現有的資源名稱。 保留控制器版本如圖所示。 本文中所有指令皆使用 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,其模式必須是 null,而非 overlay。 擷取叢集的區域:
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
如果路由表已與子網路關聯,請保留其所需的路由。 在未評估對其他工作負載的影響之前,不要用範例表格取代共用路由表。
設定工作負載身分識別
對於現有叢集,啟用 OpenID Connect (OIDC) 發行者及工作負載識別碼。 new-cluster 指令已經啟用這些功能。 請等待更新完成後再取得發行者的 URL。
az aks update \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--enable-oidc-issuer \
--enable-workload-identity
為控制器建立專屬的使用者指派管理身份:
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)
控制器使用此身份來管理防火牆及防火牆政策。 如果這些資源屬於不同的資源群組,請同時授予該身份所需的網路貢獻者存取權,該權限也適用於該資源群組的範圍。 在診斷授權失敗之前,請預留時間讓身份與角色指派變更順利完成。
建立聯合憑證:
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 chart 時所使用的命名空間相符。 圖表會建立服務 azurefirewall-controller-sa 帳戶。
安裝 Azure 防火牆 Controller
將 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"
在繼續前,請確認控制器 Pod 正在運作且其容器已準備就緒。
對於現有的 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"
準備防火牆資源
防火牆資源使用防火牆子網路、管理子網路、一個資料平面公用 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。 自訂資源需要 Azure 資源 ID,而非公開 IP 位址值。
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
您可以選擇新增 spec.firewallPolicyReference,並填入現有防火牆原則的資源 ID。 如果沒有提供參照,控制器會建立受控原則。
創建過程可能需要 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的 pod,並允許對測試中使用的 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 來選取 pod、命名空間或兩者,以及值為 Allow 或 Deny 的 action。
| Collection | 設定選項 |
|---|---|
networkRuleCollections |
TCP、UDP、ICMP 或 ANY;連接埠;IP 位址;IP 群組;服務標籤;以及 FQDN。 |
applicationRuleCollections |
HTTP、HTTPS 或 MSSQL;連接埠;FQDN;FQDN 標籤;URL;以及網頁分類。 |
例如,下列 spec 片段會啟用 DNS Proxy,並新增會選取開發人員 Pod 且允許 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。 Pod 也必須透過防火牆解析 FQDN,這樣 Pod 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 防火牆 Premium 憑證。
將 AKS 流量導向防火牆
Important
在附加政策前先設定路由。 附加會關閉 pod 的 SNAT,讓防火牆能看到 pod 的來源 IP。 若沒有防火牆路由,Pod 一旦附加元件生效,就可能失去對外連線。
當控制器建立基礎政策時,它已經允許連往 AzureKubernetesService 服務標籤的 TCP 埠 443、連往 AzureKubernetesService FQDN 標籤的 HTTPS 連接埠 443,以及連往 *.afc.azure.com 的 HTTPS 連接埠 443。
如果您使用現有防火牆或提供 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,請依照 「以外寄類型自訂叢集出口」中支援的遷移程序。 完成出口設定並確認叢集連線狀況後再繼續。
附上保單
完成路由設定後,建立 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
對於現有防火牆,請將 firewallRef 名稱與命名空間替換為 id:
firewallRef:
id: <firewall-resource-id>
| Field | Description |
|---|---|
securityPolicyRefs |
要合併的政策,依名稱與命名空間標示。 |
firewallRef |
Required. 要麼是受管理防火牆的 Kubernetes 名稱與命名空間,要麼是現有防火牆的 Azure 資源 ID。 |
aksWorkloadSubnets |
Required. 受防火牆保護的 AKS 子網路的 Azure 資源 ID。 |
等待依附項目的 Deployment 條件原因變為 Ready,而不只是等待其狀態變為 true。 也要檢查參考解析與驗收條件。
政策更新、優先順序與刪除
IDPS、威脅情報、DNS 與 SNAT 都是全政策範圍內的設定。 如果多個策略設定了相同的設定,第一個策略 securityPolicyRefs 會勝出。
如果 Azure 拒絕某個政策版本,控制器會保留其最後已知良好的版本;若沒有良好版本,則會省略該政策。 它不會因為底層錯誤消失了,就重新嘗試被拒絕的版本。 先修正問題並更改保單 spec ,再重新套用。
在刪除政策資源之前,先從 securityPolicyRefs 移除該政策。 否則,刪除可能會卡住。 若要重新建立遭拒的原則,請先將其中斷連結、刪除,然後重新建立並重新連結。
測試應用程式流量
建立一個具有該原則所選取標籤的測試 pod:
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
當 pod 啟動完成後,開啟一個 shell:
kubectl exec --namespace default -it developer-pod -- /bin/bash
在 pod shell 中測試允許的目的地:
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 "$?"
在預期的隔離政策設定中,前兩個請求被允許,而 Bing 請求則被拒絕。 對於被拒絕的 HTTPS 請求,防火牆會重置 TLS 連線,並 curl 回傳退出碼 35。 將結果與 Azure 防火牆 日誌及已部署的政策進行關聯。 單靠逾時或 TLS 錯誤並不能證明是哪條防火牆規則處理了這個請求。
規則與標籤變更在附件的 Ready 條件具有原因 Deployment 之後,可能需要幾分鐘才能送達防火牆。 如果結果與預期不符,請等待系統收斂後再重試,再進行故障排除。
完成後請退出 pod shell:
exit
驗證新 pod 是否符合政策
在現有政策收斂後,建立另一個具有相同標籤的 pod:
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
新標記的 pod 在未部署 Azure Resource Manager 的情況下,幾秒內即可獲得允許。 此快速路徑 pod 更新與政策或標籤變更的收斂時間是分開的。
設定進階原則設定
SecurityPolicy 也可以定義以下設定。 附加項目必須先參考一個獨立的原則,才能生效。 分別評估每一項能力,而非將所有範例套用於測試環境。
| Setting | 選項 |
|---|---|
| 入侵偵測與防禦系統 (IDPS) |
Disabled、AlertOnly 或 AlertAndDeny;簽章覆寫;以及私有範圍。 |
| 威脅情報 |
Disabled, AlertOnly或 AlertAndDeny;允許的CIDR與FQDN。 |
| DNS |
dnsProxy 設為 Enabled 或 Disabled,並可選 customNameServers。 在沒有自訂伺服器的情況下,配置會使用 Azure DNS。 |
| SNAT |
Always、Never 或 Exclude。 僅在使用exclusions時指定Exclude。 |
入侵偵測與防禦系統 (IDPS)
以下 spec 片段顯示 IDPS 設定。 A 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
排解設定與部署問題
先從控制器 Pod、影像和日誌開始:
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 發行者、聯邦主體、命名空間及工作負載識別設定。 |
| 授權失敗或 HTTP 403 | 驗證控制器身分的角色指派及其作用範圍。 |
| 資源驗證錯誤 | 檢查資源的狀態條件。 檢查公開 IP 與子網路值是否為有效的 Azure 資源 ID。 |
| Azure 部署失敗 | 檢查報告的錯誤及 Azure 活動記錄。 確認參照的資源存在,並位於所需的位置。 |
| 未預期的流量結果 | 驗證路由、附加部署、選擇器及其他適用的防火牆規則。 |
| FQDN 網路規則被拒絕 | 在原則中啟用 dns.dnsProxy: Enabled。 |
| FQDN 網路規則不匹配 | 確保 pods 透過防火牆解析目的地,使用虛擬網路 DNS 或 CoreDNS 轉發。 |
FirewallPolicyChildPolicyIntrusionDetectionBypassTrafficSettingConfigurationError |
從控制器管理政策中移除 bypassList 。 |
政策依然不變 Programmed=False |
在重新套用之前,請修正遭拒的設定,並變更原則的 spec。 被拒絕的版本不會被自動重試。 或者,拆除、刪除後再重新建立。 |
刪除 SecurityPolicy 時會掛起 |
刪除前請先從附加的 securityPolicyRefs 中移除它。 |
| Pod 在附加後會失去網路連線 | 確認 AKS 子網路 0.0.0.0/0 通往防火牆的路由以及所需的 AKS 與 *.afc.azure.com 出口規則。 |
| 已加上標籤的 Pod 意外遭到拒絕 | 給時間收斂並重試。 檢查預覽區域、非 Overlay Azure CNI,以及 kube-system/azure-ip-masq-agent-config。 確認防火牆能偵測到的是 pod 的 IP,而非節點的 IP。 |
對於工作負載識別,請檢查服務帳戶與控制器 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 服務帳戶註解及 Pod 的 azure.workload.identity/use 標籤。 身分識別用戶端 ID 透過 AZURE_CLIENT_ID 提供。 工作負載識別設定同時提供租戶、聯邦令牌檔案及授權主機。
預覽限制
- 每個 AKS 叢集僅支援一個
SecurityPolicyAttachmentAzure 防火牆。 每個防火牆只支援一個叢集。 - 預覽版僅檢查 pod 輸出流量,且僅支援 IPv4。
- 不支援 Azure CNI Overlay。
- 主機網路 Pods 會使用節點 IP,無法單獨選取。
- 受管式防火牆及防火牆政策部署預設使用 Premium SKU。
- 您可以使用現有的標準 SKU 防火牆及標籤式規則的政策,但僅限 Premium 的 IDPS、TLS 檢查及 URL 過濾功能無法使用。
- 基礎原則不得已繼承自另一個基礎原則。
- 您可以透過 Azure 入口網站變更父原則。 控制器不會撤銷這些父政策的變更。
- 不要透過 Azure 入口網站變更由控制器管理的子原則。 Kubernetes 才是其權威資料來源。
- 現有防火牆必須使用防火牆政策。 此整合不支援經典規則。
- CRD 會使用
v1alpha1,並可能在正式推出前有所變更。 - 預覽版僅支援 Azure 公有雲,且僅限於列出的預覽區域。
清理資源
在刪除它管理的資源時,讓控制器持續運作。 如果您先卸載控制器,資源協調與刪除可能無法完成。
退出測試 pod shell 並刪除測試 pod。
kubectl delete pod developer-pod developer-pod-2 --namespace default刪除附件並等待刪除完成。 然後等大約 90 秒,讓 pod SNAT 恢復。
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 資源、路由表、身分或角色指派。 在確認沒有其他工作負載使用該資源後,僅移除您專為此評估所建立的資源。 特別是,請保留既有的網路資源,並還原其原始設定。