This is unreleased documentation for Policy Manager 1.24-next.

Monitor mode

When defining a policy, you can choose between two modes, specified in its spec.mode. You deploy a policy in mode: protect by default. The policy then accepts, rejects, or mutates requests.

One can choose to deploy a policy in monitor mode. In monitor mode:

  • The policy accepts all requests, as if the policy wasn’t installed.

  • The policy-server traces the policy normally. If a request gets rejected or a policy proposes a mutation then the trace contains the details.

  • The policy-server metrics get updated normally, with the mode included in the metric baggage. Therefore, it’s easy to filter policies by mode and focus on those deployed using monitor mode.

The mode is an attribute included in the ClusterAdmissionPolicy and AdmissionPolicy resources. There are two values that the mode attribute can assume: monitor and protect. The mode defaults to protect if omitted.

To create a policy in monitor mode you need to include the statement mode: monitor as part of the specification of the resource. For example, in the spec section (marked ➀), of this ClusterAdmissionPolicy:

apiVersion: policies.kubewarden.io/v1alpha2
kind: ClusterAdmissionPolicy
metadata:
  name: psp-capabilities
spec:
  mode: monitor (1)
  policyServer: reserved-instance-for-tenant-a
  module: registry://ghcr.io/kubewarden/policies/psp-capabilities:v0.1.3
  rules:
  - apiGroups: [""]
    apiVersions: ["v1"]
    resources: ["pods"]
    operations:
    - CREATE
    - UPDATE
  mutating: true
  settings:
    allowed_capabilities:
    - CHOWN
    required_drop_capabilities:
    - NET_ADMIN
1 The mode: monitor attribute is in the spec section.

Changing policy mode

For security purposes, a user with UPDATE permissions on policy resources can make the policy more restrictive. This means that you can change the mode of an existing ClusterAdmissionPolicy or AdmissionPolicy from monitor to protect.

However, you can’t change the mode of an existing ClusterAdmissionPolicy or AdmissionPolicy from protect to monitor.

So, to change the mode of a policy from protect to monitor, you need to delete the policy and re-create it in monitor mode. Switching a policy from protect to monitor is the same as deleting the policy so this approach assumes that the user has policy delete permissions.

A note on mutating policies

Mutating policies in monitor mode won’t perform a mutation on the resource. In monitor mode policies log what their action would have been. They also log the mutation patch they would have produced in protect mode.

When a mutating policy is in monitor mode, later policies evaluate an unchanged, and so different resource, than when the mutating policy is in protect mode.