Panther medium experimental python
Kubernetes ClusterRoleBinding to Privileged Role
This detection monitors for ClusterRoleBindings being created that grant privileged cluster roles like cluster-admin or system:masters. Attackers who gain initial cluster access often create ClusterRoleBindings to escalate privileges and gain full control over all cluster resources and namespaces. While some bindings to privileged roles are legitimate for cluster operators, unexpected bindings should be investigated immediately as they may indicate compromise or insider threat.
Detection Logic
from panther_base_helpers import deep_get
from panther_kubernetes_helpers import is_failed_request, is_system_principal, k8s_alert_context
PRIVILEGED_CLUSTER_ROLES = {
"cluster-admin", # Full cluster control
"system:masters", # Superuser group
"admin", # Namespace admin capabilities
"system:kube-controller-manager", # Controller manager privileges
"system:kube-scheduler", # Scheduler privileges
}
def rule(event):
verb = event.udm("verb")
resource = event.udm("resource")
username = event.udm("username")
response_status = event.udm("responseStatus")
# Only check ClusterRoleBinding creation events
if verb != "create" or resource != "clusterrolebindings":
return False
# Skip failed requests
if is_failed_request(response_status):
return False
# Exclude system principals to reduce false positives from legitimate operators
if is_system_principal(username):
return False
# Check if binding references a privileged cluster role
request_object = event.udm("requestObject") or {}
role_name = deep_get(request_object, "roleRef", "name", default="")
if role_name in PRIVILEGED_CLUSTER_ROLES:
return True
return False
def title(event):
username = event.udm("username") or "<UNKNOWN_USER>"
name = event.udm("name") or "<UNKNOWN_BINDING>"
request_object = event.udm("requestObject") or {}
role_ref = request_object.get("roleRef", {})
role_name = role_ref.get("name", "<UNKNOWN_ROLE>")
# Extract subject information
subjects = request_object.get("subjects", [])
subject_names = []
for subject in subjects:
subject_type = subject.get("kind", "")
subject_name = subject.get("name", "")
if subject_type and subject_name:
subject_names.append(f"{subject_type}:{subject_name}")
subjects_str = ", ".join(subject_names) if subject_names else "<UNKNOWN_SUBJECTS>"
return (
f"[{username}] created ClusterRoleBinding [{name}] granting [{role_name}] "
f"to [{subjects_str}]"
)
def dedup(event):
username = event.udm("username") or "<UNKNOWN_USER>"
name = event.udm("name") or "<UNKNOWN_BINDING>"
return f"k8s_clusterrolebinding_{username}_{name}"
def severity(event):
"""Increase severity for cluster-admin and system:masters roles."""
request_object = event.udm("requestObject") or {}
role_ref = request_object.get("roleRef", {})
role_name = role_ref.get("name", "")
# High for cluster-admin and system:masters (full cluster control)
if role_name in {"cluster-admin", "system:masters"}:
return "HIGH"
# Medium for other privileged system roles
return "DEFAULT"
def alert_context(event):
request_object = event.udm("requestObject") or {}
role_ref = request_object.get("roleRef", {})
subjects = request_object.get("subjects", [])
return k8s_alert_context(
event,
extra_fields={
"binding_name": event.udm("name"),
"role_name": role_ref.get("name"),
"role_kind": role_ref.get("kind"),
"subjects": subjects,
},
) Field Validations
Loading…
Comments (0)
Loading comments...