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

בדף הזה מוסבר איך מקבלים את הסטטוס של ביקורת בתהליך שהתחלתם באמצעות 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. כדי לראות מידע נוסף על הביקורת, לוחצים על הקישור בעמודה סטטוס.

gcloud

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

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

• ‫RESOURCE_TYPE: סוג המשאב, פרויקט או תיקייה. לדוגמה: folders או projects.
• ‫RESOURCE_ID: מזהה המשאב של הפרויקט או התיקייה. לדוגמה: 8767234.
• ‫LOCATION: המיקום של נקודת הקצה של Audit Manager API. רשימה של נקודות הקצה הזמינות מופיעה במאמר מיקומים של Audit Manager. לדוגמה: 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	‫Audit Manager מעריך את המשאבים בהשוואה לאמצעי בקרה לתאימות.
OPERATION_STATE_EVALUATION_DONE	הושלמה הערכת התאימות ב-Audit Manager.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS	מערכת Audit Manager יוצרת דוח ביקורת מהנתונים שנבדקו.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE	מערכת Audit Manager סיימה ליצור את דוח הביקורת.
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: סוג המשאב, פרויקט או תיקייה. לדוגמה: folders או projects.
• ‫RESOURCE_ID: מזהה המשאב של הפרויקט או התיקייה. לדוגמה: 8767234.
• ‫LOCATION: המיקום של נקודת הקצה של Audit Manager API. רשימה של נקודות הקצה הזמינות מופיעה במאמר מיקומים של Audit Manager. לדוגמה: 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	‫Audit Manager מעריך את המשאבים בהשוואה לאמצעי בקרה לתאימות.
OPERATION_STATE_EVALUATION_DONE	הושלמה הערכת התאימות ב-Audit Manager.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS	מערכת Audit Manager יוצרת דוח ביקורת מהנתונים שנבדקו.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE	מערכת Audit Manager סיימה ליצור את דוח הביקורת.
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"
  }
}

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

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

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