יומני ביקורת של Kubernetes

ביומני הביקורת ב-Google Distributed Cloud (GDC)‎ עם air gap מתועד רצף כרונולוגי של בקשות API שרלוונטיות לאבטחה באשכולות Kubernetes. המסמך הזה מחלץ את סכימת ה-JSON ואת הגדרות השדות מהמפרט הציבורי של המקור. לעיון במאמרי העזרה המלאים של Go, ראו type Event של חבילת הביקורת.

ייצוג ב-JSON

{
  "kind": string,
  "apiVersion": string,
  "level": string,
  "auditID": string,
  "stage": string,
  "requestURI": string,
  "verb": string,
  "user": {
    object
  },
  "sourceIPs": [
    string array
  ],
  "userAgent": string,
  "objectRef": {
    object
  },
  "requestReceivedTimestamp": string,
  "stageTimestamp": string,
  "hostname": string
}
שדות
kind

string

סוג האובייקט של Kubernetes שנוצר באופן אוטומטי בתגובה לשינויים במשאבים אחרים. לדוגמה, "Event"

apiVersion

string

גרסת קבוצת ה-API שמכילה את האובייקט שאליו מתייחסים. לדוגמה, "audit.k8s.io/v1"

level

string

רמת הביקורת שבה התרחש האירוע. לדוגמה, "Metadata"

auditID

string

ערך הזיהוי הייחודי של הביקורת, שנוצר לכל בקשה. לדוגמה, "c5f48f91-d4da-4659-97eb-56bdbcd0817c"

stage

string

השלב בטיפול בבקשה שבו נוצר מופע האירוע. לדוגמה, "RequestReceived"

requestURI

string

ה-URI של הבקשה שהלקוח שולח לשרת. לדוגמה, "/apis/fleet.gpc.gke.io/v1/namespaces/gpc-system/fleets/root?fieldManager=kubectl-edit"

verb

string

הפועל של Kubernetes שמשויך לבקשה. בבקשות שלא קשורות למשאבים, הערך הזה הוא ה-method של ה-HTTP באותיות קטנות.

  • "verb": "create"
  • "verb": "delete"
  • "verb": "get"
  • "verb": "list"
  • "verb": "patch"
  • "verb": "update"
  • "verb": "watch"
user

object

מידע על שם המשתמש והקבוצות של המשתמש המאומת. לדוגמה,

{
  "username": "kubernetes-admin",
  "groups": [
    "system:masters",
    "system:authenticated"
  ]
}
sourceIPs

string array

מערך של כתובות IP שמהן הגיעה הבקשה וכל שרתי ה-proxy שבאמצע. כתובות ה-IP של המקור מוצגות ברשימה ממוינת הבאה:

  1. כתובות IP של כותרת הבקשה X-Forwarded-For
  2. כותרת X-Real-IP, אם היא לא קיימת ברשימה X-Forwarded-For
  3. הכתובת המרוחקת של החיבור, אם היא לא תואמת לכתובת ה-IP האחרונה ברשימה עד כאן

הלקוח יכול להגדיר באופן שרירותי את כל כתובות ה-IP, חוץ מהאחרונה. לדוגמה, ["10.200.0.3"]

userAgent

string

מחרוזת סוכן המשתמש שהלקוח מדווח עליה. לדוגמה, "kubectl/v1.19.4 (linux/amd64) kubernetes/d360454"

objectRef

object

מידע על ההפניה לאובייקט שהבקשה מטרגטת. לדוגמה,

{
  "resource": "fleets",
  "namespace": "gpc-system",
  "name": "root",
  "apiGroup": "fleet.gpc.gke.io",
  "apiVersion": "v1"
}
requestReceivedTimestamp

string

השעה שבה הבקשה הגיעה ל-apiserver של Kubernetes. לדוגמה, "2022-05-05T05:38:57.155218Z"

stageTimestamp

string

השעה שבה הבקשה הגיעה לשלב הביקורת הנוכחי. לדוגמה, "2022-05-05T05:38:57.155218Z"

hostname

string

השם של מארח יומן הביקורת. לדוגמה, "audit-logs-forwarder-2k4d9"