mcpField
K
k8s-security-policies

k8s-security-policies

github.com/wshobsonセキュリティ41.9k14.9k 回インストール2 週間前に更新
リポジトリ

k8s-security-policies について

k8s-security-policiesは、アクセス制御、ネットワーク分離、コンプライアンス設定を担う運用・セキュリティチーム向けのKubernetesセキュリティポリシーガイドです。Pod Security Standards、NetworkPolicy、RBAC、ポリシー適用の例を通じて、多層防御の実装方法を示します。

主な機能

  1. 01Pod Security Standardsの設定
  2. 02NetworkPolicyによるネットワーク分離
  3. 03最小権限のRBACアクセス設定
  4. 04Gatekeeperによるポリシー適用
  5. 05Istioサービスメッシュのセキュリティポリシー設定

活用シーン

  1. 01クラスターのネットワーク境界の定義
  2. 02サービスアカウントへの最小権限付与
  3. 03マルチテナントクラスターのセキュリティポリシー策定
  4. 04クラスターのコンプライアンス制御の実装

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/wshobson/agents --skill k8s-security-policies

インストール後、Claude Code で/k8s-security-policiesを入力して読み込まれたか確認します。

同梱ファイルassets/network-policy-template.yamlreferences/rbac-patterns.md

詳細

Kubernetes セキュリティポリシー

Kubernetes における NetworkPolicy、PodSecurityPolicy、RBAC、Pod Security Standards を実装するための包括的なガイドです。

目的

ネットワークポリシー、Pod セキュリティ標準、RBAC を使用して、Kubernetes クラスターに多層防御のセキュリティを実装します。

このスキルを使用する場面

  • ネットワークセグメンテーションを実装する
  • Pod セキュリティ標準を構成する
  • 最小権限アクセスのための RBAC を設定する
  • コンプライアンスのためのセキュリティポリシーを作成する
  • アドミッションコントロールを実装する
  • マルチテナントクラスターを保護する

Pod セキュリティ標準

1. Privileged(制限なし)
apiVersion: v1
kind: Namespace
metadata:
  name: privileged-ns
  labels:
    pod-security.kubernetes.io/enforce: privileged
    pod-security.kubernetes.io/audit: privileged
    pod-security.kubernetes.io/warn: privileged
2. Baseline(最小限の制限)
apiVersion: v1
kind: Namespace
metadata:
  name: baseline-ns
  labels:
    pod-security.kubernetes.io/enforce: baseline
    pod-security.kubernetes.io/audit: baseline
    pod-security.kubernetes.io/warn: baseline
3. Restricted(最も厳格な制限)
apiVersion: v1
kind: Namespace
metadata:
  name: restricted-ns
  labels:
    pod-security.kubernetes.io/enforce: restricted
    pod-security.kubernetes.io/audit: restricted
    pod-security.kubernetes.io/warn: restricted

ネットワークポリシー

すべてをデフォルトで拒否
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: default-deny-all
  namespace: production
spec:
  podSelector: {}
  policyTypes:
    - Ingress
    - Egress
フロントエンドからバックエンドへの許可
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: allow-frontend-to-backend
  namespace: production
spec:
  podSelector:
    matchLabels:
      app: backend
  policyTypes:
    - Ingress
  ingress:
    - from:
        - podSelector:
            matchLabels:
              app: frontend
      ports:
        - protocol: TCP
          port: 8080
DNS の許可
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: allow-dns
  namespace: production
spec:
  podSelector: {}
  policyTypes:
    - Egress
  egress:
    - to:
        - namespaceSelector:
            matchLabels:
              name: kube-system
      ports:
        - protocol: UDP
          port: 53

参照: assets/network-policy-template.yaml を参照してください

RBAC の構成

Role(Namespace スコープ)
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: pod-reader
  namespace: production
rules:
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["get", "watch", "list"]
ClusterRole(クラスター全体)
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: secret-reader
rules:
  - apiGroups: [""]
    resources: ["secrets"]
    verbs: ["get", "watch", "list"]
RoleBinding
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: read-pods
  namespace: production
subjects:
  - kind: User
    name: jane
    apiGroup: rbac.authorization.k8s.io
  - kind: ServiceAccount
    name: default
    namespace: production
roleRef:
  kind: Role
  name: pod-reader
  apiGroup: rbac.authorization.k8s.io

参照: references/rbac-patterns.md を参照してください

Pod セキュリティコンテキスト

Restricted Pod
apiVersion: v1
kind: Pod
metadata:
  name: secure-pod
spec:
  securityContext:
    runAsNonRoot: true
    runAsUser: 1000
    fsGroup: 1000
    seccompProfile:
      type: RuntimeDefault
  containers:
    - name: app
      image: myapp:1.0
      securityContext:
        allowPrivilegeEscalation: false
        readOnlyRootFilesystem: true
        capabilities:
          drop:
            - ALL

OPA Gatekeeper によるポリシー適用

ConstraintTemplate
apiVersion: templates.gatekeeper.sh/v1
kind: ConstraintTemplate
metadata:
  name: k8srequiredlabels
spec:
  crd:
    spec:
      names:
        kind: K8sRequiredLabels
      validation:
        openAPIV3Schema:
          type: object
          properties:
            labels:
              type: array
              items:
                type: string
  targets:
    - target: admission.k8s.gatekeeper.sh
      rego: |
        package k8srequiredlabels
        violation[{"msg": msg, "details": {"missing_labels": missing}}] {
          provided := {label | input.review.object.metadata.labels[label]}
          required := {label | label := input.parameters.labels[_]}
          missing := required - provided
          count(missing) > 0
          msg := sprintf("missing required labels: %v", [missing])
        }
Constraint
apiVersion: constraints.gatekeeper.sh/v1beta1
kind: K8sRequiredLabels
metadata:
  name: require-app-label
spec:
  match:
    kinds:
      - apiGroups: ["apps"]
        kinds: ["Deployment"]
  parameters:
    labels: ["app", "environment"]

サービスメッシュのセキュリティ(Istio)

PeerAuthentication(mTLS)
apiVersion: security.istio.io/v1beta1
kind: PeerAuthentication
metadata:
  name: default
  namespace: production
spec:
  mtls:
    mode: STRICT
AuthorizationPolicy
apiVersion: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
  name: allow-frontend
  namespace: production
spec:
  selector:
    matchLabels:
      app: backend
  action: ALLOW
  rules:
    - from:
        - source:
            principals: ["cluster.local/ns/production/sa/frontend"]

ベストプラクティス

  1. Pod セキュリティ標準を実装する(Namespace レベルで)
  2. ネットワークポリシーを使用する(ネットワークセグメンテーションのため)
  3. 最小権限の RBAC を適用する(すべてのサービスアカウントに対して)
  4. アドミッションコントロールを有効にする(OPA Gatekeeper/Kyverno)
  5. コンテナを非 root で実行する
  6. 読み取り専用のルートファイルシステムを使用する
  7. 必要がない限りすべてのケイパビリティを削除する
  8. リソースクォータと制限範囲を実装する
  9. セキュリティイベントの監査ログを有効にする
  10. イメージの定期的なセキュリティスキャンを実施する

コンプライアンスフレームワーク

CIS Kubernetes Benchmark
  • RBAC 認証を使用する
  • 監査ログを有効にする
  • Pod セキュリティ標準を使用する
  • ネットワークポリシーを構成する
  • 保存時のシークレット暗号化を実装する
  • ノード認証を有効にする
NIST サイバーセキュリティフレームワーク
  • 多層防御を実装する
  • ネットワークセグメンテーションを使用する
  • セキュリティ監視を構成する
  • アクセスコントロールを実装する
  • ログと監視を有効にする

トラブルシューティング

NetworkPolicy が機能しない場合:

# Check if CNI supports NetworkPolicy
kubectl get nodes -o wide
kubectl describe networkpolicy <name>

RBAC のアクセス許可が拒否された場合:

# Check effective permissions
kubectl auth can-i list pods --as system:serviceaccount:default:my-sa
kubectl auth can-i '*' '*' --as system:serviceaccount:default:my-sa

関連スキル

  • k8s-manifest-generator - 安全なマニフェストを作成するため
  • gitops-workflow - ポリシーの自動デプロイのため

コメント