Sebarkan Azure Firewall untuk Kontainer (pratinjau)

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-config untuk mematikan pod SNAT. Jika Anda sudah memiliki konfigurasi kustom ip-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 SecurityPolicyAttachment dan 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 v1alpha1 dan 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.

  1. Keluar dari shell test pod dan hapus test pod.

    kubectl delete pod developer-pod developer-pod-2 --namespace default
    
  2. Hapus 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 90
    
  3. Pulihkan 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
    fi
    

    Jika 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.

  4. Hapus kebijakan evaluasi setelah menghapus lampirannya.

    kubectl delete securitypolicy example-securitypolicy-rules --namespace default
    
  5. Jika 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=40m
    

    Penghapusan bisa memakan waktu 20-30 menit. Verifikasi penghapusan deployment Azure yang terkait. Jangan hapus firewall yang sudah ada yang Anda berikan berdasarkan resource ID.

  6. Setelah penghapusan sumber daya terkelola selesai, uninstal pengendali tersebut.

    helm uninstall azfw-controller --namespace "$HELM_NAMESPACE"
    
  7. 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.