Use external IPs or networks in policy rules
Use Calico network policy to limit traffic to/from external non-Calico workloads or networks.
Modern applications often integrate with third-party APIs and SaaS services that live outside Kubernetes clusters. To securely enable access to those integrations, network security teams must be able to limit IP ranges for egress and ingress traffic to workloads. This includes using IP lists or ranges to blacklist bad actors or embargoed countries.
Using Calico network policy, you can define IP addresses/CIDRs directly in policy to limit traffic to external networks. Or using Calico network sets, you can easily scale out by using the same set of IPs in multiple policies.
This how-to guide uses the following Calico features:
- GlobalNetworkSet or NetworkSet to specify IPs/CIDRs to use in policy
- GlobalNetworkPolicy or NetworkPolicy to limit traffic to external networks using IP addresses or network sets
IP addresses and CIDRs can be specified directly in both Kubernetes and Calico network policy rules. Calico network policy supports IPV4 and IPV6 CIDRs.
A network set resource is an arbitrary set of IP subnetworks/CIDRs that can be matched by standard label selectors in Kubernetes or Calico network policy. This is useful to reference a set of IP addresses using a selector from a namespaced network policy resource. It is typically used when you want to scale/reuse the same set of IP addresses in policy.
A global network set resource is similar, but can be selected only by Calico global network policies.
- Limit traffic to or from external networks, IPs in network policy
- Limit traffic to or from external networks, global network set
Limit traffic to or from external networks, IPs in network policy
In the following example, a Calico NetworkPolicy allows egress traffic from pods with the label color: red, if it goes to an IP address in the 192.0.2.0/24 CIDR block.
apiVersion: projectcalico.org/v3 kind: NetworkPolicy metadata: name: allow-egress-external namespace: production spec: selector: color == 'red' types: - Egress egress: - action: Allow destination: nets: - 192.0.2.0/24
Limit traffic to or from external networks, global network set
In this example, we use a Calico GlobalNetworkSet and reference it in a GlobalNetworkPolicy.
In the following example, a Calico GlobalNetworkSet blacklists the CIDR ranges 192.0.2.55/32 and 203.0.113.0/24:
apiVersion: projectcalico.org/v3 kind: GlobalNetworkSet metadata: name: ip-protect labels: IP-blacklist: true spec: nets: - 192.0.2.55/32 - 203.0.113.0/24
Next, we create two Calico GlobalNetworkPolicy objects. The first is a high “order” policy that allows traffic as a default for things that don’t match our second policy, which is low “order” and uses the GlobalNetworkSet label as a selector to deny ingress traffic (IP-blacklist in the previous step). In the label selector, we also include the term !has(projectcalico.org/namespace), which prevents this policy from matching pods or NetworkSets that also have this label. To more quickly enforce the denial of forwarded traffic to the host at the packet level, use the doNotTrack and applyOnForward options.
apiVersion: projectcalico.org/v3 kind: GlobalNetworkPolicy metadata: name: forward-default-allow spec: selector: apply-IP-protect == 'true' order: 1000 doNotTrack: true applyOnForward: true types: - Ingress ingress: - action: Allow --- apiVersion: projectcalico.org/v3 kind: GlobalNetworkPolicy metadata: name: ip-protect spec: selector: apply-IP-protect == 'true' order: 0 doNotTrack: true applyOnForward: true types: - Ingress ingress: - action: Deny source: selector: IP-blacklist == 'true' && !has(projectcalico.org/namespace)
Above and beyond
- To understand how to use global network sets to mitigate common threats, see Defend against DoS attacks
- Global network sets
- Global network policy
- Advanced egress access controls with Calico Enterprise