layout	default
title	07.2 Rbac Security
nav_order	2
parent	Module 7: Production Considerations
grand_parent	Modules
mermaid	true

Lesson 7.2: RBAC and Security

Navigation: ← Previous: Packaging and Distribution | Module Overview | Next: High Availability →

Introduction

Operators need permissions to manage resources, but they should follow the principle of least privilege - only requesting the minimum permissions needed. This lesson covers RBAC (Role-Based Access Control) configuration and security best practices for operators.

Theory: RBAC and Security

Security is critical for production operators - they have significant permissions in your cluster.

Why Security Matters

Attack Surface:

Operators run with elevated permissions
Compromised operator = compromised cluster
Security breaches can be catastrophic
Compliance requirements

Principle of Least Privilege:

Grant minimum permissions needed
Reduce attack surface
Limit blast radius
Follow security best practices

Defense in Depth:

Multiple security layers
RBAC for authorization
Network policies for isolation
Security contexts for containers

RBAC Components

Service Account:

Identity for operator pod
Used for authentication
Tied to RBAC permissions

Role/ClusterRole:

Defines permissions
Role: Namespace-scoped
ClusterRole: Cluster-scoped

RoleBinding/ClusterRoleBinding:

Binds role to service account
Grants permissions
RoleBinding: Namespace-scoped
ClusterRoleBinding: Cluster-scoped

Security Best Practices

Image Security:

Use distroless images
Scan for vulnerabilities
Keep images updated
Minimal base images

Container Security:

Run as non-root
Read-only root filesystem
Drop all capabilities
Use security contexts

Network Security:

Network policies
Limit network access
Isolate operator traffic
Encrypt communication

Understanding security helps you build secure, production-ready operators.

RBAC Architecture

Here's how RBAC works for operators:

graph TB
    OPERATOR[Operator Pod]
    
    OPERATOR --> SA[Service Account]
    SA --> ROLE[Role/RoleBinding]
    SA --> CLUSTERROLE[ClusterRole/ClusterRoleBinding]
    
    ROLE --> PERMISSIONS[Permissions]
    CLUSTERROLE --> PERMISSIONS
    
    PERMISSIONS --> API[Kubernetes API]
    
    style OPERATOR fill:#FFB6C1
    style PERMISSIONS fill:#90EE90

RBAC Components

Service Account

apiVersion: v1
kind: ServiceAccount
metadata:
  name: postgres-operator
  namespace: default

Role vs ClusterRole

graph TB
    RBAC[RBAC]
    
    RBAC --> ROLE[Role: Namespaced]
    RBAC --> CLUSTERROLE[ClusterRole: Cluster-wide]
    
    ROLE --> NAMESPACE[Single Namespace]
    CLUSTERROLE --> ALL[All Namespaces]
    
    style ROLE fill:#90EE90
    style CLUSTERROLE fill:#FFB6C1

Role: Permissions within a namespace
ClusterRole: Permissions across all namespaces

Kubebuilder RBAC Markers

Kubebuilder generates RBAC automatically from markers in your controller code. These markers are placed just above your Reconcile function:

// +kubebuilder:rbac:groups=database.example.com,resources=databases,verbs=get;list;watch;create;update;patch;delete
// +kubebuilder:rbac:groups=database.example.com,resources=databases/status,verbs=get;update;patch
// +kubebuilder:rbac:groups=database.example.com,resources=databases/finalizers,verbs=update
// +kubebuilder:rbac:groups=apps,resources=statefulsets,verbs=get;list;watch;create;update;patch;delete
// +kubebuilder:rbac:groups=core,resources=services,verbs=get;list;watch;create;update;patch;delete
// +kubebuilder:rbac:groups=core,resources=secrets,verbs=get;list;watch;create;update;patch;delete

func (r *DatabaseReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error) {
    // ... reconciliation logic
}

Generating RBAC Manifests

After updating markers, regenerate RBAC manifests:

# Generate RBAC from markers
make manifests

# View generated RBAC
cat config/rbac/role.yaml

The generated manifests are in config/rbac/:

role.yaml - ClusterRole with permissions
role_binding.yaml - ClusterRoleBinding
service_account.yaml - ServiceAccount for the operator

RBAC Marker Format

graph LR
    MARKER[RBAC Marker] --> PARTS[Parts]
    
    PARTS --> GROUPS[groups]
    PARTS --> RESOURCES[resources]
    PARTS --> VERBS[verbs]
    PARTS --> NAMESPACE[namespace]
    
    style MARKER fill:#90EE90

Principle of Least Privilege

flowchart TD
    START[Determine Needs] --> MINIMUM[Minimum Permissions]
    MINIMUM --> REVIEW[Review Generated RBAC]
    REVIEW --> REMOVE[Remove Unnecessary]
    REMOVE --> TEST[Test Functionality]
    TEST --> VERIFY[Verify Works]
    VERIFY --> DEPLOY[Deploy]
    
    style MINIMUM fill:#90EE90

Best Practices:

Only request permissions you need
Use specific verbs (not *)
Use specific resources (not *)
Review generated RBAC
Test with minimal permissions

Security Best Practices

Practice 1: Use Distroless Images

FROM gcr.io/distroless/static:nonroot
# No shell, no package manager, minimal attack surface

Practice 2: Run as Non-Root

securityContext:
  runAsNonRoot: true
  runAsUser: 65532
  allowPrivilegeEscalation: false
  capabilities:
    drop:
    - ALL

Practice 3: Read-Only Root Filesystem

securityContext:
  readOnlyRootFilesystem: true
volumeMounts:
- name: tmp
  mountPath: /tmp
volumes:
- name: tmp
  emptyDir: {}

Practice 4: Network Policies

Network Policies are essential for defense in depth - they control network traffic to and from your operator pods, limiting the blast radius if an attacker compromises your operator.

Kubebuilder-Generated Network Policies

Good news! Kubebuilder automatically generates network policies in config/network-policy/:

config/network-policy/
├── allow-metrics-traffic.yaml   # Controls metrics endpoint access
├── allow-webhook-traffic.yaml   # Controls webhook server access
└── kustomization.yaml

These are disabled by default. To enable them, uncomment in config/default/kustomization.yaml:

# [NETWORK POLICY] Protect the /metrics endpoint and Webhook Server
- ../network-policy  # Uncomment this line

How Kubebuilder's Network Policies Work

graph TB
    subgraph "Operator Namespace"
        OPERATOR[Controller Manager Pod]
    end
    
    subgraph "Labeled Namespaces"
        PROM[Prometheus<br/>metrics: enabled]
        APP[App Namespace<br/>webhook: enabled]
    end
    
    subgraph "Unlabeled Namespaces"
        OTHER[Other Pods<br/>❌ Blocked]
    end
    
    PROM -->|Port 8443| OPERATOR
    APP -->|Port 443| OPERATOR
    OTHER -.->|Blocked| OPERATOR
    
    style OPERATOR fill:#FFB6C1
    style PROM fill:#90EE90
    style APP fill:#90EE90
    style OTHER fill:#FF6B6B

Kubebuilder's approach:

Metrics access: Only namespaces labeled metrics: enabled can scrape metrics (port 8443)
Webhook access: Only namespaces labeled webhook: enabled can use webhooks (port 443)

Kubebuilder Network Policy Example

# config/network-policy/allow-metrics-traffic.yaml
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: allow-metrics-traffic
  namespace: system
spec:
  podSelector:
    matchLabels:
      control-plane: controller-manager
      app.kubernetes.io/name: postgres-operator
  policyTypes:
    - Ingress
  ingress:
    - from:
      - namespaceSelector:
          matchLabels:
            metrics: enabled  # Only from labeled namespaces
      ports:
        - port: 8443
          protocol: TCP

Labeling Namespaces

For the policies to allow traffic, label your namespaces:

# Allow Prometheus to scrape metrics
kubectl label namespace monitoring metrics=enabled

# Allow webhook traffic from namespaces where you create CRs
kubectl label namespace default webhook=enabled

Key Concepts

Field	Description
`podSelector`	Selects pods the policy applies to (empty = all pods in namespace)
`policyTypes`	Which direction to control: `Ingress`, `Egress`, or both
`ingress.from`	Who can send traffic TO the selected pods
`namespaceSelector`	Match pods in namespaces with specific labels

Important: Network Policies require a CNI plugin that supports them (Calico, Cilium, Weave, etc.). The default Kubernetes networking (kubenet) does NOT enforce Network Policies!

Security Scanning

Scanning Flow

sequenceDiagram
    participant Dev
    participant Build as Build Process
    participant Scanner as Security Scanner
    participant Registry as Registry
    
    Dev->>Build: Build Image
    Build->>Scanner: Scan Image
    Scanner->>Scanner: Check Vulnerabilities
    Scanner-->>Dev: Report Issues
    Dev->>Build: Fix Issues
    Build->>Registry: Push Image
    
    Note over Scanner: Tools: Trivy,<br/>Grype, Snyk

Kubebuilder Security Configuration

Kubebuilder's generated deployment in config/manager/manager.yaml includes security best practices:

spec:
  template:
    spec:
      securityContext:
        runAsNonRoot: true
      containers:
      - name: manager
        securityContext:
          allowPrivilegeEscalation: false
          capabilities:
            drop:
            - ALL
        # Resource limits from config/manager/manager.yaml
        resources:
          limits:
            cpu: 500m
            memory: 128Mi
          requests:
            cpu: 10m
            memory: 64Mi

Key Takeaways

RBAC controls operator permissions
Service Accounts identify the operator
Roles are namespaced, ClusterRoles are cluster-wide
Kubebuilder markers generate RBAC automatically via make manifests
Principle of least privilege minimizes risk
Kubebuilder's Dockerfile uses distroless images by default
Security scanning finds vulnerabilities
Review config/rbac/ to verify generated permissions
Network Policies provide defense in depth by restricting network traffic
Operators typically only need egress to Kubernetes API (443) and DNS (53)

Understanding for Building Operators

When configuring RBAC and security with kubebuilder:

Add RBAC markers above your Reconcile function
Run make manifests to regenerate RBAC
Review config/rbac/role.yaml for generated permissions
Remove unnecessary markers to minimize permissions
Use the distroless base image (already in kubebuilder Dockerfile)
Configure security contexts in config/manager/manager.yaml
Enable network policies by uncommenting ../network-policy in config/default/kustomization.yaml
Label namespaces with metrics: enabled and webhook: enabled as needed
Scan images for vulnerabilities before deployment
Test network policies in a cluster with CNI support (Calico, Cilium)

Related Lab

Lab 7.2: Configuring RBAC - Hands-on exercises for this lesson

References

Official Documentation

Next Steps

Now that you understand RBAC and security, let's learn about high availability.

Navigation: ← Previous: Packaging and Distribution | Module Overview | Next: High Availability →

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Lesson 7.2: RBAC and Security

Introduction

Theory: RBAC and Security

Why Security Matters

RBAC Components

Security Best Practices

RBAC Architecture

RBAC Components

Service Account

Role vs ClusterRole

Kubebuilder RBAC Markers

Generating RBAC Manifests

RBAC Marker Format

Principle of Least Privilege

Security Best Practices

Practice 1: Use Distroless Images

Practice 2: Run as Non-Root

Practice 3: Read-Only Root Filesystem

Practice 4: Network Policies

Kubebuilder-Generated Network Policies

How Kubebuilder's Network Policies Work

Kubebuilder Network Policy Example

Labeling Namespaces

Key Concepts

Security Scanning

Scanning Flow

Kubebuilder Security Configuration

Key Takeaways

Understanding for Building Operators

Related Lab

References

Official Documentation

Further Reading

Related Topics

Next Steps

FilesExpand file tree

02-rbac-security.md

Latest commit

History

02-rbac-security.md

File metadata and controls

Lesson 7.2: RBAC and Security

Introduction

Theory: RBAC and Security

Why Security Matters

RBAC Components

Security Best Practices

RBAC Architecture

RBAC Components

Service Account

Role vs ClusterRole

Kubebuilder RBAC Markers

Generating RBAC Manifests

RBAC Marker Format

Principle of Least Privilege

Security Best Practices

Practice 1: Use Distroless Images

Practice 2: Run as Non-Root

Practice 3: Read-Only Root Filesystem

Practice 4: Network Policies

Kubebuilder-Generated Network Policies

How Kubebuilder's Network Policies Work

Kubebuilder Network Policy Example

Labeling Namespaces

Key Concepts

Security Scanning

Scanning Flow

Kubebuilder Security Configuration

Key Takeaways

Understanding for Building Operators

Related Lab

References

Official Documentation

Further Reading

Related Topics

Next Steps