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

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

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

קבלת הסטטוס של ביקורת שמתבצעת

המסוף

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

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

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

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

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

gcloud

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

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

  • ‫RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם organization,‏ folder ו-project.
  • ‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
  • ‫LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. ברשימת המיקומים של הכלי לניהול ביקורות מפורטות נקודות הקצה הזמינות. לדוגמה: us-central1.
  • ‫AUDIT_OPERATION_ID: המזהה הייחודי של הפעולה שמתבצעת, שנכלל בגוף התגובה כשהפעלתם את הביקורת. לדוגמה: 098234.

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

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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 הכלי לניהול ביקורות סיים את הערכת התאימות.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS הכלי לניהול ביקורות יוצר דוח ביקורת מהנתונים שנבדקו.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE הכלי לניהול ביקורות סיים ליצור את דוח הביקורת.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS הכלי לניהול ביקורות מעלה את דוח הביקורת וההוכחות ליעד.
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: סוג המשאב. הערכים התקינים הם organizations, folders ו-projects.
  • ‫RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה: 8767234.
  • ‫LOCATION: המיקום של נקודת קצה ל-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

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

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

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

$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 הכלי לניהול ביקורות סיים את הערכת התאימות.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_IN_PROGRESS הכלי לניהול ביקורות יוצר דוח ביקורת מהנתונים שנבדקו.
OPERATION_STATE_EVIDENCE_REPORT_GENERATION_DONE הכלי לניהול ביקורות סיים ליצור את דוח הביקורת.
OPERATION_STATE_EVIDENCE_UPLOAD_IN_PROGRESS הכלי לניהול ביקורות מעלה את דוח הביקורת וההוכחות ליעד.
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"
  }
}

כשהדוח מוכן ומועלה, מוחזר קישור לדוח.

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