קבלת סטטוס של ביקורת

בדף הזה מוסבר איך מקבלים את הסטטוס של ביקורת בתהליך שהתחלתם באמצעות Audit Manager או Compliance Manager. ביקורות הן פעולות ממושכות, ולכן כדאי לקבל את הסטטוס של הביקורת בזמן שהפעולה מתבצעת.

לפני שמתחילים

• מוודאים שיש לכם אחד מהתפקידים הבאים ב-IAM:

  • אדמין ב-Audit Manager (roles/auditmanager.admin)
  • מבקר ב-Audit Manager (roles/auditmanager.auditor)
  • הצגת Compliance Manager (roles/cloudsecuritycompliance.viewer) (נדרש אם מבצעים ביקורת על מסגרת שיצרתם באמצעות Compliance Manager)

• מאתרים את הביקורת שרוצים לקבל את הסטטוס שלה.

קבלת הסטטוס של ביקורת בתהליך

המסוף

1. נכנסים לדף View audits במסוף Google Cloud .

   מעבר לצפייה בביקורות

2. בדף View assessments (הצגת הערכות) אפשר לראות את הסטטוס הנוכחי של ביקורת שנמצאת בתהליך, או לקבל מידע נוסף על ביקורת שהושלמה.

3. כדי לראות מידע נוסף על הביקורת, לוחצים על הקישור בעמודה סטטוס.

4. (תצוגה מקדימה) אופציונלי: כדי לראות את סטטוס הביקורת באמצעות הממשק החדש של המסוף, מבצעים את הפעולות הבאות:

   1. לוחצים על מעבר לגרסה החדשה.

   2. כדי לראות מידע נוסף על הביקורת, לוחצים על שם הביקורת.

gcloud

הפקודה gcloud audit-manager operations describe מתארת פעולת ביקורת.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫RESOURCE_TYPE: סוג המשאב, שיכול להיות ארגון (בגרסת Preview), תיקייה או פרויקט. לדוגמה: folders או projects.
• ‫RESOURCE_ID: מזהה המשאב של הארגון (בגרסת Preview), הפרויקט או התיקייה. לדוגמה: 8767234.
• LOCATION: המיקום של נקודת קצה ל-API של כלי לניהול ביקורות. רשימה של נקודות הקצה הזמינות מופיעה במאמר מיקומים של כלי לניהול ביקורות. לדוגמה: us-central1.
• ‫AUDIT_OPERATION_ID: המזהה הייחודי של הפעולה שנמצאת בתהליך, שנכלל בגוף התגובה כשמריצים את הביקורת. לדוגמה: 098234.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud audit-manager operations describe AUDIT_OPERATION_ID \
    --RESOURCE_TYPE=RESOURCE_ID \
    --location=LOCATION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud audit-manager operations describe AUDIT_OPERATION_ID `
    --RESOURCE_TYPE=RESOURCE_ID `
    --location=LOCATION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud audit-manager operations describe AUDIT_OPERATION_ID ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --location=LOCATION

תשובה מוצלחת כוללת אחד מסוגי סטטוס הביצוע הבאים:

סוג הסטטוס	תיאור
OPERATION_STATE_UNSPECIFIED	מצב לא תקין.
OPERATION_STATE_NOT_STARTED	תהליך יצירת דוח הביקורת עדיין לא התחיל.
OPERATION_STATE_EVALUATION_IN_PROGRESS	‫כלי לניהול ביקורות מעריך את המשאבים בהשוואה לאמצעי בקרה לתאימות.
OPERATION_STATE_EVALUATION_DONE	הושלמה הערכת התאימות ב-Audit Manager.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS	כלי לניהול ביקורות יוצר דוח ביקורת מהנתונים שנבדקו.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE	כלי לניהול ביקורות השלים את יצירת דוח הביקורת.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS	מערכת Audit Manager מעלה את דוח הביקורת ואת הראיות ליעד.
OPERATION_STATE_DONE	תהליך הפקת דוח הביקורת הושלם.
OPERATION_STATE_FAILED	תהליך יצירת דוח הביקורת נכשל.

לכל אחד מסוגי סטטוס הביצוע יכול להיות מידע נוסף מהסוגים הבאים, בהתאם לצורך:

סטטוס נוסף	תיאור
failure_reason	אם הערכת הביקורת נכשלת, בשדה הזה מופיעה הסיבה לכשל.
evaluation_percent_complete	אם ההערכה התחילה, בשדה הזה מופיע אחוז ההתקדמות. אם התהליך עדיין לא התחיל, הערך בשדה הוא 0. בסיום התהליך, השדה מוגדר ל-100.
report_generation_percent_complete	אם הפקת הדוח התחילה, בשדה הזה מופיע אחוז ההתקדמות. אם התהליך עדיין לא התחיל, הערך בשדה הוא 0. בסיום התהליך, השדה מוגדר ל-100.
report_uploading_percent_complete	אם העלאת הדוח התחילה, בשדה הזה מופיע אחוז ההתקדמות. אם התהליך עדיין לא התחיל, הערך בשדה הוא 0. בסיום התהליך, השדה מוגדר ל-100.

תגובה מוצלחת של gcloud תיראה כך:

done: true
name: projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID
response:
  '@type': type.googleapis.com/google.cloud.auditmanager.v1.AuditReport
  gcsUri: gs://testbucketauditmanager

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫RESOURCE_TYPE: סוג המשאב, שיכול להיות ארגון (בגרסת Preview), תיקייה או פרויקט. לדוגמה: folders או projects.
• ‫RESOURCE_ID: מזהה המשאב של הארגון (בגרסת Preview), הפרויקט או התיקייה. לדוגמה: 8767234.
• LOCATION: המיקום של נקודת קצה ל-API של כלי לניהול ביקורות. רשימה של נקודות הקצה הזמינות מופיעה במאמר מיקומים של כלי לניהול ביקורות. לדוגמה: us-central1.
• ‫AUDIT_OPERATION_ID: המזהה הייחודי של הפעולה שנמצאת בתהליך, שנכלל בגוף התגובה כשמריצים את הביקורת. לדוגמה: 098234.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID

כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:

curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID"

PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION//operationDetails/AUDIT_OPERATION_ID" | Select-Object -Expand Content

תשובה מוצלחת כוללת אחד מסוגי סטטוס הביצוע הבאים:

סוג הסטטוס	תיאור
OPERATION_STATE_UNSPECIFIED	מצב לא תקין.
OPERATION_STATE_NOT_STARTED	תהליך יצירת דוח הביקורת עדיין לא התחיל.
OPERATION_STATE_EVALUATION_IN_PROGRESS	‫כלי לניהול ביקורות מעריך את המשאבים בהשוואה לאמצעי בקרה לתאימות.
OPERATION_STATE_EVALUATION_DONE	הושלמה הערכת התאימות ב-Audit Manager.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS	כלי לניהול ביקורות יוצר דוח ביקורת מהנתונים שנבדקו.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE	כלי לניהול ביקורות השלים את יצירת דוח הביקורת.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS	מערכת Audit Manager מעלה את דוח הביקורת ואת הראיות ליעד.
OPERATION_STATE_DONE	תהליך הפקת דוח הביקורת הושלם.
OPERATION_STATE_FAILED	תהליך יצירת דוח הביקורת נכשל.

לכל אחד מסוגי סטטוס הביצוע יכול להיות מידע נוסף מהסוגים הבאים, בהתאם לצורך:

סטטוס נוסף	תיאור
failure_reason	אם הערכת הביקורת נכשלת, בשדה הזה מופיעה הסיבה לכשל.
evaluation_percent_complete	אם ההערכה התחילה, בשדה הזה מופיע אחוז ההתקדמות. אם התהליך עדיין לא התחיל, הערך בשדה הוא 0. בסיום התהליך, השדה מוגדר ל-100.
report_generation_percent_complete	אם הפקת הדוח התחילה, בשדה הזה מופיע אחוז ההתקדמות. אם התהליך עדיין לא התחיל, הערך בשדה הוא 0. בסיום התהליך, השדה מוגדר ל-100.
report_uploading_percent_complete	אם העלאת הדוח התחילה, בשדה הזה מופיע אחוז ההתקדמות. אם התהליך עדיין לא התחיל, הערך בשדה הוא 0. בסיום התהליך, השדה מוגדר ל-100.

תגובה מוצלחת מ-REST נראית כך:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operationDetails/AUDIT_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.auditmanager.v1.AuditReport",
    "gcsUri": "gs://testbucketauditmanager"
  }
}

כשדוח ביקורת מסתיים ומועלה, מוחזר קישור לדוח.

המאמרים הבאים

• איך צופים בדוח ביקורת