AI Runtime Security
Configure Strata Cloud Manager to Secure VM Workloads and Kubernetes Clusters
Table of Contents
Expand All
|
Collapse All
AI Runtime Security Docs
Configure Strata Cloud Manager to Secure VM Workloads and Kubernetes Clusters
Strata Cloud Manager configurations to secure your VM workloads/vNets and Kubernetes
clusters post downloading the AI Runtime Security instance deployment Terraform template in
Strata Cloud Manager.
This page covers the configurations you need to secure your VM workloads/vNets and
Kubernetes clusters, and route traffic after you apply the deployment Terraform template
in your cloud environment.
Where Can I Use This? | What Do I Need? |
---|---|
|
On this page you will:
- Configure the following in Strata Cloud Manager:
- Interfaces
- Zones
- NAT Policy
- Routers
- Security Policies
- Secure VM workloads
- Secure Kubernetes clusters
- Install a Kubernetes application with Helm
- (Optional) Configure labels in your cloud environment
AI Runtime Security is only supported for public
clusters on GCP, Azure, and AWS cloud platforms.
Prerequisites
- Deploy AI Runtime Security Instance specific to your cloud to Save and Download the Terraform template.
- Unzip and navigate to the `<unzipped-folder>` that has the following
structure:|____architecture |____LICENSE |____README.md |____security_project |____application_project |____helm |____modules
- (Optional) Enable SSL/TLS decryption on AI Runtime Security to decrypt traffic between AI applications and AI models:The decryption helps you to detect and enforce AI security protection.These steps involve creating a decryption policy and exporting the Root CA from Strata Cloud Manager.
- Log in to Strata Cloud Manager.
- Select Manage → Configuration → NGFW and Prisma Access→ Security Services → Decryption.
- Add a new decryption policy rule, or modify an existing one.
- Configure the source and destination zones.
- Under "Action and Advanced Inspection", set the action to decrypt.
- Select the decryption type to SSL Forward Proxy.
- Select a Decryption Profile to perform additional checks on traffic that matches the policy rule.
- Go to Objects → Certificate Management.
- Select Root CA and click Export Certificate.
- Select Go to Objects → Certificate Management and click Save.
- Push the changes to the AI network intercept (AI firewall) and wait for the push to complete.
GCP
AI Runtime Security post deployment configurations in Strata Cloud Manager to protect VM workloads and Kubernetes clusters.Where Can I Use This? What Do I Need? - Secure VMs and Kubernetes in Strata Cloud Manager
- Log in to Strata Cloud Manager.Configure AI Runtime Security: Network intercept interfaces:
- Select Manage → Configuration → NGFW and Prisma Access.Select Device Settings → Interfaces.Set the Configuration Scope to your AI Runtime Security folder.In the Ethernet tab:Configure a Layer 3 Interface for eth1/1 and eth1/2:
- Interfaces: eth1/1 and eth1/2
- Location: Specify location if applicable
- Interface Type: Layer3
- IP Address: Dynamic (DHCP Client)
Select the Loopback tab, to configure the Loopback interface:- In IPv4s, enter the ILB (Internal Load Balancer) private IP address
- Set Security Zone to trust for eth1/2 and untrust for eth1/1
- Ensure VR (Virtual Router) is set to default or the same as eth1/2
Create zones. Select Manage → Configuration → NGFW and Prisma Access → Device Settings → Zones.Configure a Logical Router:- Create a Logical Router and add the Layer 3 interfaces (eth1/1 and eth1/2).
- Configure a Static Route with the ILB static IP addresses for routing. Use the trust interface gateway IP address.
Add a security policy (Manage → Configuration → NGFW and Prisma Access → Security Services → Security Policy → Add Rule).Ensure the policy allows health checks from the GCP Load Balancer (LB) pool to the internal LB IP from Strata Cloud Manager. Check session IDs to ensure the firewall responds correctly on the designated interfaces.Configurations to Secure VM Workloads
- Configure Static Routes for VPC endpoints.
- Log in to Strata Cloud Manager.Select Manage → Configuration → NGFW and Prisma Access → Device Settings → Routing → Logical Routers.For VPC Subnet:
- Edit the IPv4 Static Routes and add the route for the VPC IPv4 range CIDR subnets.
- Set the Next Hop as eth1/2.
- Set the Destination as the trust subnet gateway IP from Strata Cloud Manager.
- Update the static route.
Save the Logical Router.Log in to Strata Cloud Manager.Select Manage → Operations → Push Config and push the policy configurations to the AI network intercept (AI firewall).Configurations to Secure the Kubernetes Clusters
- Add pod and service IP Subnets to AI Runtime Security trust firewall rules:
- Get the IP addresses for pod and service subnets:
- Go to Kubernetes Engine -> Clusters.Select a Cluster and copy the Cluster Pod IPv4 and IPv4 Service range IP addresses.Follow the AI Runtime Security Instance deployment in GCP to save and download the Terraform template.Edit the Terraform template to whitelist the following IP addresses in your VPC network firewall rules:
- Navigate to the `<unzipped-folder>/architecture/security_project` directory.
- Edit the `terraform.tfvars` file to add the copied IP addresses list
to your `source_ranges`.firewall_rules = { allow-trust-ingress = { name = "allow-trust-vpc" source_ranges = ["35.xxx.0.0/16", "130.xxx.0.0/22", "192.xxx.0.0/16", "10.xxx.0.0/14", "10.xx.208.0/20"] # 1st 2 IPs are for health check packets. Add APP VPC/Pod/Service CIDRs priority = "1000" allowed_protocol = "all" allowed_ports = [] } }
- Apply the Terraform:terraform init terraform plan terraform applyAdd static routes on the Logical Router for Kubernetes workloads:
- Log in to Strata Cloud Manager.Select Manage → Configuration → NGFW and Prisma Access → Device Settings → Routing → Logical Routers.Configure Static Routes for the pod and service subnets for the Kubernetes workloads:Pod Subnet:
- Edit the IPv4 Static Routes and add a route with the Pod IPv4 range CIDR.
- Set the Next Hop as eth1/2 (trust interface).
- Set the Destination as the trust subnet gateway IP from Strata Cloud Manager.
Service Subnet:- Edit the IPv4 Static Routes add a route with the IPv4 Service range CIDR.
- Set the Next Hop as eth1/2 (trust interface).
- Set the Destination as the trust subnet gateway IP from Strata Cloud Manager.
Add source NAT Policy for Outbound Traffic:- Log in to Strata Cloud Manager.Select Manage → Configuration → NGFW and Prisma Access → Network Policies → NAT.Create or modify a source NAT Policy:
- Source Zone: Trust
- Destination Zone: Untrust (eth1/1)
- Policy Name: trust2untrust or similar.
Configure NAT settings:Interface Address Section:- Set the Interface to eth1/1. (The translation happens at
eth1/1).If needed, create a complementary rule for the reverse direction (for example, untrust2trust).
Log in to Strata Cloud Manager.Select Manage → Operations → Push Config and push the policy configurations to the AI Runtime Security instance.Note: If you have a Kubernetes cluster running, follow the section to install a Kubernetes application with Helm.Install a Kubernetes Application with Helm
Follow the below steps to install a Kubernetes application on a Kubernetes cluster. - Change the directory to the Helm folder:cd <unzipped-folder>/architecture/helmGKE Autopilot clusters do not support Helm deployments due to restrictions on modifying the kube-system namespace.Install the Helm chart:helm install ai-runtime-security helm --namespace kube-system --values helm/values.yamlVerify the Helm installation:#List all Helm releases helm list -A #Ensure the output shows your installation with details such as: NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION ai-runtime-security kube-system 1 2024-08-13 07:00 PDT deployed ai-runtime-security-0.1.0 11.2.2Check the pod status:kubectl get pods -A #Verify that the pods with names similar to `pan-cni-*****` are present.Check the endpoint slices:kubectl get endpointslice -n kube-system #Confirm that the output shows an ILB IP address: NAME ADDRESSTYPE PORTS ENDPOINTS AGE my-endpointslice IPv4 80/TCP 10.2xx.0.1,10.2xx.0.2 12hCheck the services running in the `kube-system` namespace:kubectl get svc -n kube-system #Ensure that services `pan-cni-sa` and `pan-plugin-user-secret` are listed: NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE pan-cni-sa ClusterIP 10.xx.0.1 <none> 443/TCP 24h pan-plugin-user-secret ClusterIP 10.xx.0.2 <none> 443/TCP 24hAnnotate the application `yaml` or `namespace` so that the traffic from the new pods is redirected to the AI Runtime Security instance (firewall) for inspection.
For example, for all new pods in the "default" namespace:annotations: paloaltonetworks.com/firewall: pan-fwkubectl annotate namespace default paloaltonetworks.com/firewall=pan-fwAzure
AI Runtime Security post deployment configurations in Strata Cloud Manager to protect VM workloads and Kubernetes clusters.Where Can I Use This? What Do I Need? - Secure VMs and Kubernetes in Strata Cloud Manager
Configure Strata Cloud Manager
Interfaces
Configure AI Runtime Security (firewall) Interfaces:- Navigate to Manage → Configuration → NGFW and Prisma Access→ Device Settings → InterfacesSet the Configuration Scope to your AI Runtime Security folder.Select Add Interface.
- In the Ethernet tab, configure a Layer 3 Interface for eth1/1(trust) and eth1/2(untrust):
- Enter Interface Name (Create interfaces for both eth1/1(trust) and eth1/2(untrust) interfaces).
- Select Layer3Interface type.
- In Logical Routers, select `vr-private` for eth1/1 and `vr-public` for eth1/2.
- In Zone, select trust for eth1/1 and untrust for eth1/2.
- Select DHCP Client type under IPV4 address.
- Enable IPV4 for both eth1/1 and eth1/2 interfaces.
- For eth1/2 (untrust) only, enable Automatically create default route pointing to default gateway provided by server.
- Select Advanced Settings > Other Info.
- Select a Management Profile swith HTTPS enabled under Administrative Management Services or create a new one:
- Add.
- Select the Loopback tab to configure the Loopback interface to receive health checks from each load balancer:
- Select the Logical Routers.
- Set the trust Zone for private Logical Router and untrust Zone for the public Logical Router.
- In the IPv4s section, enter the private IP address of the Internal Load Balancer (ILB).This IP address is in the output displayed after successfully deploying the `security_project` Terraform, as described on the Deploy AI Runtime Security: Network Intercept in Azure page.
- Expand Advanced Settings → Management Profile and add your allow-health-checks profile.
- Add or Save.
Zones
- Navigate to Manage → Configuration → NGFW and Prisma Access→ Device Settings → Zones.Select Add Zone.Enter a Name.Select Layer3 Interface type.In Interfaces, add $eth1 interface for trust zone and $eth2 interface for untrust zone.Save.
NAT
Configure the NAT policies for inbound and outbound traffic:- Navigate to Manage → Configuration → NGFW and Prisma Access → Network Policies → NAT.Configure NAT Policy for inbound traffic:
- Enter a Name indicating inbound traffic (for example, inbound-web).Original Packet:
- In Source zones, click add and select untrust zone.
Destination:- select untrust Zone.
- Select any Interface.
- In Addresses, click the add (+) icon and select the public Elastic Load Balancer (ELB) address.
Choose any Service.Translated Packet:- In Translation, select Both.
- In Source Address Translation, select the Dynamic IP and Port translation type.
- In choice, select Interface Address.
- In Interface, select eth1(ethernet1/1).
- In Choice, select IP address.
- Set the Static IP address as the Translation Type.
- Select the destination Translated Address.
Save.Configure NAT Policy for Outbound traffic:- Enter a Name indicating inbound traffic (for example, outbound-internet).Original Packet:
- In Source zones, click add and select trust zone.
- In Addresses, click the add (+) icon and select the app-vnet and the Kubernetes pods CIDR you want to secure.
Destination:- Select untrust destination zone.
- Select any interface.
Choose any Service.Translated Packet:- In Translation, select Source Address Only.
- In Source Address Translation, select the Dynamic IP and Port translation type.
- In choice, select Interface Address.
- In Interface, select eth2(ethernet1/2).
- In Choice, select IP address.
Save.Routers
Configure private and public virtual routers: Azure health probe fails with a single virtual router (VR). Create multiple VRs to ensure probe success.- Navigate to Manage → Configuration → NGFW and Prisma Access→ Device Settings → Routing.Enter a Name indicating private and public routers (for example, vr-private and vr-public).In Interfaces, select eth1(ethernet1/1) for vr-private route and eth2(ethernet1/2) for vr-public route.Refer the section on Interfaces to see how to configure the $eth1 and $eth2 interfaces.In Advanced Settings, select Edit to configure the IPV4 Static Routes for vr-private and vr-public.
- Select Add Static Route and add the following routes:Application routing:
- Enter a Name (for example, app-vnet).
- In Destination, enter the CIDR address of your application.
- In Next Hop:
- For vr-private, select IP Address
and enter the gateway IP address of the private
interface (eth1/1) in the IP Address.The gateway IP address is the first usable IP in the subnet's range (example, 192.168.1.1 for a /24 subnet). To find it, go to Azure Portal > Virtual Networks > [Your Virtual Network] > Subnets > [Private Subnet].
- For vr-public, select Next Router and select the `vr-private` in the Next Router.
- For vr-private, select IP Address
and enter the gateway IP address of the private
interface (eth1/1) in the IP Address.
- In Interface, select eth1(ethernet1/1) subnet for `vr-private` and None for `vr-public`.
Default routing:- Enter a Name.
- In Destination, enter 0.0.0.0/0.
- In Next Hop:
- For vr-private, select Next Router and enter the `vr-public` in the Next Router.
- For vr-public, select IP Address and enter the gateway IP address of the vr-public interface (eth1/2) in the IP Address.
- In Interface, choose None for `vr-private` and eth2(ethernet1/2) for `vr-public`.
- Add or Update.
Azure Load Balancer’s health probe:- Enter a Name.
- In Destination, enter the IP address of the Azure Load Balancer’s health probe (168.63.129.16/32).
- In Next Hop, select IP Address for
vr-private and vr-public.
- In IP Address, enter the gateway IP address of the corresponding interfaces.
- In Interface, select eth1(ethernet1/1) for vr-private and eth2(ethernet1/2) for vr-public.
Add.Save.Static routes summary for `vr-private`:Route Type Name Destination Next Hop Next Hop Value Interface Application routing app-vnet Application CIDR IP Adderss Gateway IP address of vr-private Gateway IP address of vr-private Default Routing default 0.0.0.0/0 Next Router vr-public None Azure LB Health Probe azure-probe 168.63.129.16/32 IP Address Subnet Gateway IP address eth1(ethernet1/1) Static route summary for `vr-public`:Route Type Name Destination Next Hop Next Hop Value Interface Application routing app-vnet Application CIDR Next Router vr-private eth1(ethernet1/1) Default Routing default 0.0.0.0/0 IP Address Gateway IP address of vr-public eth2(ethernet1/2) Azure LB Health Probe azure-probe 168.63.129.16/32 IP Address Subnet Gateway IP address eth2(ethernet1/2) Security Policy
- Add a security policy (Manage → Configuration → NGFW and Prisma Access → Security Services → Security Policy → Add Rule).Ensure the policy allows health checks from the Azure Load Balancer (LB) pool to the internal LB IP from Strata Cloud Manager. Check session IDs to ensure the firewall responds correctly on the designated interfaces.
Configurations to Secure VM Workloads
- Log in to Strata Cloud Manager.Configure routes for vNet endpoints as explained in the Routers section above to ensure there is a route to your application.Navigate to Manage → Operations → Push Config and push the policy configurations to your firewall (AI Runtime Security: Network intercept).Create or update the NAT policy (refer to the NAT section above) to secure the VM workloads. Set the source address of the application you want to secure.
Configurations to Secure the Kubernetes Clusters
- Log in to Strata Cloud Manager.Configure static routes (refer to the routes section above) on the Logical Router for Kubernetes workloads.Follow the below configurations for pod and service subnets static routes for pod for the Kubernetes workloads:
- Pod Subnet and Service subnet for vr-private:
Route Type Name Destination Next Hop Next Hop Value Interface Pod subnet pod_route Pod IPV4 range CIDR IP Address Subnet Gateway IP address eth1(ethernet1/1) Service subnet service_route 172.16.0.0/24 IP Address Subnet Gateway IP address eth1(ethernet1/1) - Pod Subnet and Service subnet for vr-public:
Route Type Name Destination Next Hop Next Hop Value Interface Pod subnet pod_route Pod IPV4 range CIDR Next Router vr-private None Service subnet service_route 172.16.0.0/24 Next Router vr-private None
Refer to the NAT policy in the above section to secure the Kubernetes clusters and set the source address of the Kubernetes pods CIDR you want to secure.Navigate to Manage → Operations → Push Config and push the policy configurations to your firewall (AI Runtime Security: Network intercept).Install a Kubernetes Application with Helm
Follow the below steps to install a Kubernetes application on a Kubernetes cluster. - Change the directory to the Helm folder:cd <unzipped-folder>/architecture/helmInstall the Helm chart:helm install ai-runtime-security helm --namespace kube-system --values helm/values.yamlEnable "Bring your own Azure virtual network" to discover Kubernetes-related vnets:
- In Azure Portal, navigate to Kubernetes services → [Your Cluster]→ Settings→ Networking.
- Under Network configuration, select Azure CNI as the Network plugin, then enable Bring your own Azure virtual network.
Verify the Helm installation:#List all Helm releases helm list -A #Ensure the output shows your installation with details such as: NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION ai-runtime-security kube-system 1 2024-08-13 07:00 PDT deployed ai-runtime-security-0.1.0 11.2.2Check the pod status:kubectl get pods -A #Verify that the pods with names similar to `pan-cni-*****` are present.Check the endpoint slices:kubectl get endpointslice -n kube-system #Confirm that the output shows an ILB IP address: NAME ADDRESSTYPE PORTS ENDPOINTS AGE my-endpointslice IPv4 80/TCP 10.2xx.0.1,10.2xx.0.2 12hCheck the services running in the `kube-system` namespace:kubectl get svc -n kube-system #Ensure that services `pan-cni-sa` and `pan-plugin-user-secret` are listed: NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE pan-cni-sa ClusterIP 10.xx.0.1 <none> 443/TCP 24h pan-plugin-user-secret ClusterIP 10.xx.0.2 <none> 443/TCP 24hAnnotate the application `yaml` or `namespace` so that the traffic from the new pods is redirected to the AI Runtime Security instance (firewall) for inspection.
For example, for all new pods in the "default" namespace:annotations: paloaltonetworks.com/firewall: pan-fwkubectl annotate namespace default paloaltonetworks.com/firewall=pan-fw(Optional) Configure Labels in Your Cloud Environment
The deployment Terraform you generate from Strata Cloud Manager, automatically adds the required labels to organize your AI Runtime Security: network intercept instances. For manual deployments, ensure you have the following labels (key-value pairs) in your Terraform template.- You need the following labels (key-value pairs) under Tags in the Terraform template file under your downloaded path `<azure|aws-deployment-terraform-path>/architecture/security_project/terraform.tfvars`. The value of these keys must be unique.
- For GCP:
- `paloaltonetworks_com-trust`
- `paloaltonetworks_com-occupied`
- For Azure and AWS:
- paloaltonetworks.com-trust
- paloaltonetworks.com-occupied
Ensure, the network interface name in the security_project Terraform is suffixed by `-trust-vpc`. - For GCP:
AWS
AI Runtime Security post deployment configurations in Strata Cloud Managerto protect VM workloads and Kubernetes clusters.Where Can I Use This? What Do I Need? - Secure VMs and Kubernetes in Strata Cloud Manager
- Log in to Strata Cloud Manager.Configure AI Runtime Security: Network intercept:
- Select Manage → Configuration → NGFW and Prisma Access.Select Device Settings → Interfaces.Set the Configuration Scope to your AI Runtime Security folder.In Ethernet tab:Configure a Layer 3 Interface for eth1/1:
- Interfaces: eth1/1
- Location: Specify the location if applicable
- Interface Type: Layer 3
- IP Address: Dynamic (DHCP Client)
Configure zones:- Select