Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Azure Firewall for Containers memungkinkan Anda mengelola perlindungan Azure Firewall untuk beban kerja Azure Kubernetes Service (AKS) melalui sumber daya khusus Kubernetes. Azure Firewall Controller menerjemahkan sumber daya ini ke dalam konfigurasi dan kebijakan Azure Firewall.
Dalam artikel ini, Anda membuat klaster AKS atau menggunakan klaster yang sudah ada, menginstal pengendali, membuat firewall, dan mengonfigurasi perlindungan untuk lalu lintas keluar pod yang dipilih.
Tip
Untuk membuat klaster AKS baru dan Azure Firewall dengan template Azure Resource Manager (ARM), gunakan template quickstart.
Important
Azure Firewall for Containers saat ini dalam pratinjau publik. Lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure untuk mengetahui ketentuan hukum yang berlaku untuk fitur Azure yang dalam tahap beta, pratinjau, atau belum dirilis ke ketersediaan umum.
Memahami model konfigurasi
Pengendali menggunakan tiga definisi sumber daya kustom (CRD):
| Resource | Purpose |
|---|---|
AzureFirewall |
Membuat dan mengelola penerapan Azure Firewall. |
SecurityPolicy |
Mendefinisikan pengaturan firewall lanjutan, aturan jaringan, aturan aplikasi, atau kombinasi dari pengaturan tersebut. |
SecurityPolicyAttachment |
Mereferensikan kebijakan keamanan, mengidentifikasi firewall, dan mencantumkan subnet beban kerja AKS. Pengendali menggabungkan kebijakan yang direferensikan menjadi kebijakan Azure Firewall anak. |
A SecurityPolicy tidak berlaku untuk lalu lintas hingga SecurityPolicyAttachment merujuknya. Lalu lintas aplikasi juga harus melewati firewall.
Kontroler mendukung pemilih pod dan namespace untuk koleksi aturan. Pengaturan lanjutan meliputi deteksi dan pencegahan intrusi (IDPS), DNS, intelijen ancaman, dan source network address translation (SNAT). Ketersediaan fitur juga bergantung pada SKU firewall dan konfigurasinya.
Prerequisites
- Langganan Azure dan akses ke Azure Firewall for Containers di wilayah pratinjau yang didukung.
- Klaster AKS yang menggunakan Azure CNI di jaringan virtual Anda sendiri, atau izin untuk membuatnya. Azure CNI Overlay tidak didukung. Panduan ini menggunakan klaster dan jaringan virtual dalam grup sumber daya yang sama.
- Jalur konektivitas keluar untuk klaster saat Anda menginstal controller dan menyiapkan firewall. Sebelum mengubah routing, rencanakan jenis outbound klaster dan konektivitas outbound yang diperlukan.
- Lalu lintas pod harus mencapai firewall dengan IP pod sebagai sumbernya, bukan disamarkan ke IP node. Pada penerapan kebijakan pertama, kontroler membuat
kube-system/azure-ip-masq-agent-configuntuk mematikan pod SNAT. Jika Anda sudah memiliki konfigurasi kustomip-masq-agent, pastikan tidak menyamarkan lalu lintas egress ini. - Jika Anda menggunakan firewall yang sudah ada atau menyediakan kebijakan dasar sendiri, izinkan lalu lintas keluar AKS yang diperlukan dan HTTPS pada port 443 ke
*.afc.azure.com. Kebijakan basis yang dibuat oleh pengendali sudah menyediakan aturan-aturan ini. - Izin untuk mengelola cluster, menginstal CRD, dan membuat sumber daya jaringan Azure dalam panduan ini.
- Izin untuk membuat identitas terkelola yang ditetapkan pengguna dan menetapkan peran yang diperlukan. Membuat penugasan peran memerlukan peran yang sesuai, seperti Role Based Access Control Administrator, pada lingkup penugasan.
- Azure CLI, kubectl, dan Helm.
- Lingkungan Bash, seperti Azure Cloud Shell dalam mode Bash.
Important
Azure CNI Overlay tidak didukung. Klaster harus menggunakan Azure CNI dengan IP pod dari jaringan virtual (networkPluginsudah azurenetworkPluginMode dan belum diatur).
Warning
Mengubah tabel rute subnet AKS atau tipe keluar klaster AKS dapat mengganggu konektivitas klaster dan aplikasi. Gunakan lingkungan evaluasi yang terisolasi terlebih dahulu. Catat konfigurasi yang ada dan siapkan rencana rollback sebelum mengubah egress.
Pratinjau mendukung Azure public cloud di wilayah berikut. Gunakan wilayah yang diaktifkan untuk langganan pratinjau Anda.
| Region | Nilai Azure CLI |
|---|---|
| US Tengah EUAP | centraluseuap |
| US Timur 2 EUAP | eastus2euap |
| Barat Sentral AS | westcentralus |
| Asia Timur | eastasia |
| UK Selatan | uksouth |
| US Tengah | centralus |
Menyiapkan lingkungan pengembangan
Ganti dua nilai placeholder tersebut. Nama-nama lain adalah contoh; ubah sesuai kebutuhan, dan untuk klaster yang sudah ada, gunakan nama sumber daya yang sudah ada. Pertahankan versi kontroler seperti yang ditampilkan. Gunakan Bash untuk semua perintah dalam artikel ini.
# 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"
Contoh menggunakan versi bagan controller 20261109.1. Pilih ukuran mesin virtual yang tersedia di wilayah yang Anda pilih.
Daftarkan penyedia sumber daya:
az provider register --namespace Microsoft.ContainerService --wait
az provider register --namespace Microsoft.Network --wait
Siapkan klaster AKS
Pilih jalur klaster yang ada atau klaster baru.
Menggunakan kluster yang ada
Periksa konfigurasi jaringannya:
az aks show \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--query 'networkProfile.{plugin:networkPlugin, mode:networkPluginMode}' -o json
Plugin jaringan harus azure, dan modenya harus null, bukan overlay. Ambil region klaster:
LOCATION=$(az aks show \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--query location -o tsv)
Membuat kluster baru
Untuk lingkungan evaluasi baru, buat grup sumber daya, jaringan virtual, dan subnet 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
Jalur ini menjaga konektivitas bootstrap cluster tetap tersedia sebelum Anda membuat rute firewall. Sistem tidak memilih userDefinedRouting sebelum rute itu ada.
Catat konfigurasi jaringan
Untuk jalur mana pun, ambil ID subnet AKS dan catat tabel rute, tipe keluar, dan server DNS sebelum mengubahnya:
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
Jika tabel rute sudah terkait dengan subnet, pertahankan rute yang diperlukan. Jangan ganti tabel rute bersama dengan tabel contoh tanpa menilai dampaknya pada beban kerja lain.
Mengonfigurasi identitas beban kerja
Untuk klaster yang sudah ada, aktifkan penerbit OpenID Connect (OIDC) dan identitas beban kerja. Perintah new-cluster sudah mengaktifkannya. Tunggu hingga pembaruan selesai sebelum mengambil URL penerbit.
az aks update \
--resource-group "$RESOURCE_GROUP" \
--name "$AKS_NAME" \
--enable-oidc-issuer \
--enable-workload-identity
Buat identitas terkelola khusus yang ditetapkan pengguna untuk pengendali:
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)
Pengendali menggunakan identitas ini untuk mengelola firewall dan Kebijakan Firewall. Jika sumber daya ini berada di grup sumber daya yang berbeda, berikan akses Network Contributor yang diperlukan kepada identitas tersebut pada lingkup grup sumber daya tersebut juga. Berikan waktu untuk perubahan identitas dan penugasan peran menyebar sebelum mendiagnosis kegagalan otorisasi.
Buat kredensial federasi:
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
Namespace dalam subjek federasi harus sesuai dengan namespace yang Anda gunakan saat menginstal chart Helm. Chart membuat akun layanan azurefirewall-controller-sa.
Instal Azure Firewall Controller
Hubungkan kubectl ke cluster dan instal controller:
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"
Periksa bahwa pod kontroler berjalan dan wadahnya siap sebelum melanjutkan.
Untuk rilis Helm yang sudah ada, gunakan helm upgrade sebagai pengganti 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"
Siapkan sumber daya firewall
Sumber daya firewall menggunakan subnet firewall, subnet manajemen, satu sumber daya IP publik data-plane, dan sumber daya IP publik manajemen. Lewati pembuatan untuk sumber daya yang sudah ada, jika sesuai.
Nama subnet harus AzureFirewallSubnet dan AzureFirewallManagementSubnet. Pilih rentang alamat dalam jaringan virtual yang sudah ada yang tidak tumpang tindih dengan subnet AKS atau subnet lainnya. Rentang contoh berikut memerlukan ruang alamat jaringan virtual yang berisi rangka tersebut:
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
Ambil ID sumber daya. Sumber daya kustom memerlukan ID sumber daya Azure, bukan nilai alamat IP publik.
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)
Buat firewall
Buat firewall.yaml. Heredoc tanpa tanda kutip melakukan ekspansi pada variabel 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
Anda dapat menambahkan spec.firewallPolicyReference dengan ID sumber daya dari Kebijakan Firewall yang sudah ada. Tanpa referensi, controller membuat kebijakan terkelola.
Proses pembuatan bisa memakan waktu 10-15 menit. Tunggu hingga Ready kondisi menjadi Deployment. Menunggu hanya status kondisi dapat selesai saat penerapan Azure masih berlangsung. Periksa kondisi lain yang dikembalikan dan perbaiki kesalahan yang dilaporkan sebelum melanjutkan.
Baca alamat IP privat firewall yang diterapkan berdasarkan statusnya:
FW_PRIVATE_IP=$(kubectl get azurefirewall example-firewall --namespace default \
-o jsonpath='{.status.firewallResourceInfo.privateIPAddress}')
echo "$FW_PRIVATE_IP"
Untuk menggunakan firewall yang sudah ada, lewati pembuatan sumber daya AzureFirewall dan gunakan ID sumber daya Azure-nya dalam pelampiran yang dijelaskan nanti dalam artikel ini. Firewall yang ada harus menggunakan Kebijakan Firewall, bukan aturan klasik.
Untuk jalur tersebut, atur FW_PRIVATE_IP ke alamat IP privat firewall yang ada sebelum Anda mengonfigurasi routing:
FW_PRIVATE_IP='<existing-firewall-private-ip>'
Mengonfigurasi kebijakan keamanan
Kebijakan berikut memilih pod dengan label role: developer dan mengizinkan permintaan HTTPS ke subdomain Microsoft dan Google yang digunakan dalam pengujian. Kebijakan ini tidak menggantikan aturan infrastruktur AKS.
Buat 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"
Terapkan kebijakan:
kubectl apply -f security-policy.yaml
Opsi aturan jaringan dan aplikasi
Setiap koleksi menggunakan refs untuk memilih pod, namespace, atau keduanya, dan sebuah action dari Allow atau Deny.
| Collection | Opsi konfigurasi |
|---|---|
networkRuleCollections |
TCP, UDP, ICMP, atau ANY; port; alamat IP; grup IP; tag layanan; dan FQDN. |
applicationRuleCollections |
HTTP, HTTPS, atau MSSQL; port; FQDN; tag FQDN; URL; dan kategori web. |
Sebagai contoh, fragmen berikut spec mengaktifkan proxy DNS dan menambahkan koleksi aturan jaringan yang memilih pod pengembang dan mengizinkan lalu lintas port TCP 443 ke google.com. Jangan tambahkan contoh opsional ini ke kebijakan pengujian hanya aplikasi tanpa menilai ulang hasil pengujian yang diharapkan.
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
Tujuan FQDN dalam aturan jaringan membutuhkan dns.dnsProxy: Enabled. Pod juga harus menyelesaikan FQDN melalui firewall agar DNS pod dan DNS firewall tidak menyelesaikan alamat IP yang berbeda.
Untuk contoh aturan jaringan opsional ini, pertama-tama lampirkan kebijakan dan tunggu hingga siap seperti yang dijelaskan di Lampirkan kebijakan. Kemudian konfigurasikan pod DNS untuk menggunakan firewall. Salah satu opsi adalah mengatur server DNS jaringan virtual ke IP privat firewall:
az network vnet update \
--resource-group "$RESOURCE_GROUP" \
--name "$VNET_NAME" \
--dns-servers "$FW_PRIVATE_IP"
Mengubah DNS jaringan virtual memengaruhi beban kerja lain dalam jaringan tersebut. Catat konfigurasi DNS asli terlebih dahulu, lalu restart node AKS melalui prosedur pemeliharaan Anda agar mereka menangkap perubahan. Sebagai alternatif, konfigurasikan CoreDNS untuk meneruskan ke firewall. Aturan aplikasi HTTP dan HTTPS tidak memerlukan jalur resolusi DNS ini.
Aturan aplikasi dapat menggunakan tlsInspection: Enabled. Inspeksi TLS juga memerlukan SKU firewall yang sesuai, konfigurasi sertifikat, dan kepercayaan klien. Lihat sertifikat Azure Firewall Premium.
Rute lalu lintas AKS melalui firewall
Important
Konfigurasikan routing sebelum melampirkan kebijakan. Attachment mematikan pod SNAT sehingga firewall melihat IP sumber pod. Tanpa rute firewall, pod dapat kehilangan konektivitas keluar segera setelah lampiran mulai berlaku.
Ketika controller membuat kebijakan dasar, ia sudah mengizinkan port TCP 443 ke AzureKubernetesService service tag, port HTTPS 443 ke AzureKubernetesService tag FQDN, dan port HTTPS 443 ke *.afc.azure.com.
Jika Anda menggunakan firewall yang sudah ada atau menyediakan firewallPolicyReference, konfigurasikan aturan jaringan dan FQDN AKS yang diperlukan dan setara serta port HTTPS 443 ke *.afc.azure.com dalam kebijakan dasar Anda sebelum mengubah routing. Pengendali tidak memodifikasi kebijakan dasar yang disediakan. Pertahankan konektivitas untuk layanan klaster, DNS, dan penarikan image. Jangan mengedit kebijakan anak yang dikelola controller secara langsung.
Untuk subnet evaluasi khusus tanpa tabel rute yang ada, buat tabel berikut. Gunakan FW_PRIVATE_IP yang diambil dari status firewall, atau IP privat firewall yang sudah ada.
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
Jika tabel rute sudah ada, tambahkan rute default firewall ke tabel tersebut daripada menggantinya. Jaga rute lain yang diperlukan.
Mengaitkan tabel rute tidak mengubah AKS outboundType. Jika desain Anda memerlukan migrasi ke userDefinedRouting, ikuti prosedur migrasi yang didukung di Customize cluster egress with outbound types. Selesaikan konfigurasi egress dan verifikasi konektivitas klaster sebelum melanjutkan.
Lampirkan kebijakan
Setelah routing terpasang, buat attachment.yaml. Contoh ini merujuk pada kebijakan dan firewall terkelola yang dibuat dalam panduan ini.
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
Untuk firewall yang sudah ada, ganti firewallRef nama dan namespace dengan id:
firewallRef:
id: <firewall-resource-id>
| Field | Description |
|---|---|
securityPolicyRefs |
Kebijakan yang akan digabungkan, diidentifikasi berdasarkan nama dan namespace. |
firewallRef |
Required. Nama dan namespace Kubernetes pada firewall yang dikelola, atau ID sumber daya Azure firewall yang sudah ada. |
aksWorkloadSubnets |
Required. ID sumber daya Azure dari subnet AKS yang dilindungi oleh firewall. |
Tunggu hingga alasan kondisi lampiran Deployment menjadi Ready, bukan hanya statusnya menjadi true. Periksa juga kondisi resolusi referensi dan penerimaan.
Pembaruan kebijakan, urutan prioritas, dan penghapusan
IDPS, intelijen ancaman, DNS, dan SNAT adalah pengaturan kebijakan secara menyeluruh. Jika beberapa kebijakan mengatur pengaturan yang sama, kebijakan pertama dalam urutan securityPolicyRefs yang berlaku.
Jika Azure menolak versi kebijakan, pengendali mempertahankan versi terakhir yang diketahui baik, atau menghilangkan kebijakan tersebut jika tidak memiliki versi yang baik. Sistem tidak akan mencoba ulang versi yang ditolak hanya karena kesalahan dasarnya hilang. Perbaiki masalahnya dan ubah spec kebijakan sebelum menerapkannya kembali.
Hapus kebijakan dari securityPolicyRefs sebelum menghapus sumber daya kebijakan. Jika tidak, penghapusan bisa menggantung. Untuk membuat ulang kebijakan yang gagal, lepaskan terlebih dahulu, hapus, lalu buat kembali dan lampirkan kembali.
Uji traffic aplikasi
Buat pod uji dengan label yang dipilih oleh kebijakan:
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
Setelah pod berjalan, buka shell:
kubectl exec --namespace default -it developer-pod -- /bin/bash
Dari shell pod, uji tujuan yang diizinkan:
curl --connect-timeout 10 --max-time 30 https://www.google.com
curl --connect-timeout 10 --max-time 30 https://www.microsoft.com
Kemudian uji tujuan yang tidak diizinkan oleh kebijakan contoh:
curl --connect-timeout 10 --max-time 30 https://www.bing.com
echo "$?"
Dalam konfigurasi kebijakan terisolasi yang dimaksudkan, dua permintaan pertama diizinkan dan permintaan Bing ditolak. Untuk permintaan HTTPS yang ditolak, firewall akan mengatur ulang koneksi TLS dan curl mengembalikan kode exit 35. Korelasikan hasil dengan log Azure Firewall dan kebijakan yang diterapkan. Kesalahan timeout atau TLS saja tidak membuktikan aturan firewall mana yang menangani permintaan tersebut.
Perubahan aturan dan label dapat memakan waktu beberapa menit untuk mencapai firewall setelah kondisi lampiran Deployment memiliki alasan Ready. Jika hasilnya tidak sesuai harapan, beri waktu untuk konvergensi dan coba lagi sebelum melakukan troubleshooting.
Keluar dari shell pod setelah selesai:
exit
Verifikasi pod baru sesuai dengan kebijakan
Setelah kebijakan yang ada konvergen, buat pod lain dengan label yang sama:
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 baru yang diberi label diizinkan dalam hitungan detik tanpa penerapan Azure Resource Manager. Pembaruan pod jalur cepat ini terpisah dari waktu konvergensi untuk perubahan kebijakan atau label.
Konfigurasikan pengaturan kebijakan lanjutan
A SecurityPolicy juga dapat mendefinisikan pengaturan berikut. Kebijakan terpisah harus dirujuk oleh pelampiran sebelum mulai berlaku. Evaluasi setiap kemampuan secara terpisah daripada menerapkan setiap contoh ke lingkungan pengujian.
| Setting | Opsi |
|---|---|
| Sistem Deteksi dan Pencegahan Intrusi (IDPS) |
Disabled, AlertOnly, atau AlertAndDeny; override signature; dan rentang privat. |
| Inteligensi ancaman |
Disabled, AlertOnly, atau AlertAndDeny; CIDR dan FQDN yang diizinkan. |
| DNS |
dnsProxy diatur ke Enabled atau Disabled, dengan opsional customNameServers. Tanpa server kustom, konfigurasi menggunakan Azure DNS. |
| SNAT |
Always, Never, atau Exclude. Tentukan exclusions hanya dengan Exclude. |
Sistem Deteksi dan Pencegahan Intrusi (IDPS)
Fragmen berikut spec menunjukkan konfigurasi IDPS.
ruleID harus berupa angka, bukan string yang dikutip. Ganti contoh ID tanda tangan 2000015 dengan ID numerik tanda tangan yang ingin Anda timpa.
idps:
mode: AlertAndDeny
ruleOverrides:
- ruleID: 2000015
mode: AlertOnly
privateIPRanges:
cidrs:
- 10.0.0.0/8
- 192.168.0.0/16
Jangan konfigurasikan bypassList pada kebijakan anak yang dikelola controller. Azure menolak pengaturan tersebut. Jika Anda membutuhkan bypass IDPS tertentu, konfigurasikan kebijakan dasar yang sesuai untuk bypass tersebut yang Anda miliki.
Inteligensi ancaman
Fragmen berikut spec menunjukkan cara mengizinkan CIDR dan FQDN tertentu sambil menggunakan intelijen ancaman:
threatIntelligence:
mode: AlertAndDeny
allow-list:
cidrs:
- 203.0.113.0/24
- 198.51.100.0/24
fqdns:
- example.com
- example.org
DNS
Fragmen berikut spec mengaktifkan proxy DNS. Konfigurasikan customNameServers dengan alamat resolver Anda sendiri saat desain DNS Anda memerlukannya.
dns:
dnsProxy: Enabled
customNameServers:
- <dns-server-ip-1>
- <dns-server-ip-2>
SNAT
Fragmen berikut spec mengecualikan rentang privat yang terdaftar dari SNAT:
snat:
action: Exclude
exclusions:
autoLearnPrivateRanges: Enabled
privateRanges:
- 10.0.0.0/8
- 192.168.0.0/16
Pemecahan masalah konfigurasi dan deployment
Mulailah dengan pod kontroler, image, dan log:
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
Image pengendali menggunakan jalur mcr.microsoft.com/firewall/images/azurefirewall-controller dengan tag versi yang dipilih.
Periksa sumber daya dan statusnya:
kubectl get azurefirewall -A -o yaml
kubectl get securitypolicy -A -o yaml
kubectl get securitypolicyattachment -A -o yaml
| Gejala | Pemeriksaan |
|---|---|
| Kegagalan autentikasi atau HTTP 401 | Verifikasi penerbit OIDC, subjek federasi, namespace, dan konfigurasi identitas beban kerja. |
| Kegagalan otorisasi atau HTTP 403 | Verifikasi penugasan peran identitas pengendali dan cakupannya. |
| Kesalahan validasi sumber daya | Periksa kondisi status sumber daya. Periksa bahwa nilai IP publik dan subnet adalah ID sumber daya Azure yang valid. |
| Kegagalan penerapan Azure | Periksa kesalahan yang dilaporkan dan Log Aktivitas Azure. Verifikasi bahwa sumber daya yang direferensikan ada dan berada di lokasi yang diperlukan. |
| Hasil traffic yang tidak terduga | Verifikasi routing, deployment attachment, selector, dan aturan firewall lain yang berlaku. |
| Aturan jaringan FQDN ditolak | Aktifkan dns.dnsProxy: Enabled dalam kebijakan. |
| Aturan jaringan FQDN tidak cocok | Pastikan pod menyelesaikan resolusi tujuan melalui firewall, menggunakan DNS jaringan virtual atau penerusan CoreDNS. |
FirewallPolicyChildPolicyIntrusionDetectionBypassTrafficSettingConfigurationError |
Hapus bypassList dari kebijakan yang dikelola oleh pengendali. |
Kebijakan tetap Programmed=False |
Koreksi konfigurasi yang ditolak dan ubah atribut kebijakanspec sebelum menerapkannya kembali. Versi yang ditolak tidak otomatis dicoba ulang. Alternatifnya, lepaskan, hapus, dan buat ulang objek tersebut. |
SecurityPolicy macet saat dihapus |
Hapus itu dari securityPolicyRefs lampiran sebelum menghapusnya. |
| Pod kehilangan koneksi internet setelah attachment | Verifikasi rute subnet 0.0.0.0/0 AKS ke firewall serta aturan AKS dan *.afc.azure.com egress yang diperlukan. |
| Pod yang diberi label secara tak terduga ditolak | Berikan waktu untuk konvergensi dan coba ulang. Periksa wilayah pratinjau, CNI Azure non-Overlay, dan kube-system/azure-ip-masq-agent-config. Verifikasi bahwa firewall melihat IP pod daripada IP node. |
Untuk identitas beban kerja, periksa service account dan lingkungan pod pengendali:
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"
Periksa anotasi service-account azure.workload.identity/client-id dan label azure.workload.identity/use pada pod. ID klien identitas disediakan melalui AZURE_CLIENT_ID. Konfigurasi identitas beban kerja juga menyediakan tenant, file token federasi, dan host otoritas.
Pratinjau batasan
- Setiap klaster AKS hanya mendukung satu
SecurityPolicyAttachmentdan satu Azure Firewall. Setiap firewall hanya mendukung satu klaster. - Pratinjau hanya memeriksa egress pod dan hanya mendukung IPv4.
- Azure CNI Overlay tidak didukung.
- Pod jaringan host menggunakan IP node dan tidak dapat dipilih secara individual.
- Firewall terkelola dan penerapan Kebijakan Firewall secara default menggunakan Premium SKU.
- Anda dapat menggunakan firewall dan kebijakan Standard SKU yang sudah ada untuk aturan berbasis label, tetapi IDPS khusus Premium, inspeksi TLS, dan penyaringan URL tidak tersedia.
- Kebijakan dasar tidak boleh sudah mewarisi dari kebijakan dasar lain.
- Anda dapat mengubah kebijakan induk melalui portal Azure. Pengendali tidak membatalkan perubahan kebijakan induk tersebut.
- Jangan ubah kebijakan anak yang dikelola oleh controller melalui portal Azure. Kubernetes adalah sumber kebenarannya.
- Firewall yang sudah ada harus menggunakan Kebijakan Firewall. Aturan klasik tidak didukung untuk integrasi ini.
- CRD menggunakan
v1alpha1dan dapat berubah sebelum ketersediaan umum. - Pratinjau ini hanya mendukung cloud publik Azure, di wilayah pratinjau yang tercantum.
Membersihkan sumber daya
Biarkan controller tetap berjalan saat Anda menghapus sumber daya yang dikelolanya. Jika Anda menghapus controller terlebih dahulu, rekonsiliasi dan penghapusan sumber daya mungkin tidak selesai.
Keluar dari shell test pod dan hapus test pod.
kubectl delete pod developer-pod developer-pod-2 --namespace defaultHapus lampiran dan tunggu hingga penghapusan selesai. Kemudian tunggu sekitar 90 detik sampai pod SNAT dipulihkan.
kubectl delete securitypolicyattachment example-attachment --namespace default kubectl wait --for=delete securitypolicyattachment/example-attachment \ --namespace default --timeout=30m sleep 90Pulihkan routing subnet sebelumnya dan konfigurasi keluar klaster sesuai rencana rollback Anda. Jika subnet awalnya tidak memiliki tabel rute, hapus asosiasi tabel evaluasi. Jika tidak, pulihkan tabel aslinya.
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 fiJika Anda mengubah DNS jaringan virtual atau CoreDNS untuk contoh aturan jaringan opsional, pulihkan juga pengaturan asli. Verifikasi konektivitas klaster. Jangan tinggalkan rute yang mengarah ke firewall yang akan Anda hapus.
Hapus kebijakan evaluasi setelah menghapus lampirannya.
kubectl delete securitypolicy example-securitypolicy-rules --namespace defaultJika Anda membuat firewall terkelola dalam panduan ini, hapus sumber daya kustomnya saat kontroler masih berjalan:
kubectl delete azurefirewall example-firewall --namespace default kubectl wait --for=delete azurefirewall/example-firewall \ --namespace default --timeout=40mPenghapusan bisa memakan waktu 20-30 menit. Verifikasi penghapusan deployment Azure yang terkait. Jangan hapus firewall yang sudah ada yang Anda berikan berdasarkan resource ID.
Setelah penghapusan sumber daya terkelola selesai, uninstal pengendali tersebut.
helm uninstall azfw-controller --namespace "$HELM_NAMESPACE"Hapus namespace kontroler hanya jika Anda membuatnya khusus untuk panduan ini dan tidak mengandung sumber daya yang Anda butuhkan.
Perintah sebelumnya tidak menghapus klaster AKS, jaringan virtual, subnet, sumber daya IP publik, tabel rute, identitas, atau penugasan peran. Hapus hanya sumber daya yang Anda buat khusus untuk evaluasi ini setelah memverifikasi bahwa tidak ada beban kerja lain yang menggunakannya. Secara khusus, pertahankan sumber daya jaringan yang sudah ada dan kembalikan konfigurasi aslinya.