ביקורות מאפשרות לכם לאסוף את הראיות שאתם צריכים כדי להעריך את הארגון שלכם ב-Google Cloud בהתאם למסגרות הנתמכות. אתם יכולים לתזמן ביקורת שתפעל במרווחי זמן קבועים או להפעיל ביקורת על פי דרישה.
ביקורת היא פעולה ממושכת שיכולה להימשך כמה שעות. משך הזמן תלוי במספר המשאבים בהיקף הביקורת, כלומר הארגון, הפרויקט או התיקייה שרשמתם קודם לכן.
אם אתם מתזמנים ביקורת, אתם יכולים ליצור לוח זמנים למסגרת ולמשאב ספציפיים רק אם אין כבר לוח זמנים פעיל או מושהה לשילוב של המסגרת והמשאב.
לפני שמתחילים
מוודאים שיש לכם אחד מהתפקידים הבאים ב-IAM:
- אדמין בכלי לניהול ביקורות (
roles/auditmanager.admin) - ניהול כללים לביקורת בכלי לניהול ביקורות (
roles/auditmanager.auditor)
- אדמין בכלי לניהול ביקורות (
מוודאים שהארגון, הפרויקט או התיקייה רשומים לביקורת.
תזמון והרצה של ביקורת
אתם יכולים ליצור לוח זמנים להרצת ביקורת על בסיס קבוע, או להריץ ביקורת על פי דרישה.
המסוף
במסוף Google Cloud , נכנסים לדף Run assessment בכלי לניהול ביקורות.
בקטע Choose resource and region:
בוחרים את הארגון, התיקייה או הפרויקט שרוצים לבדוק.
בוחרים את המיקום שבו צריך לעבד את הערכת הביקורת. רשימת המיקומים שבהם אפשר להשתמש בכלי לניהול ביקורות
לוחצים על הבא.
בקטע Choose regulation, בוחרים את המסגרת שלפיה רוצים לבדוק את המשאב ולוחצים על Next. למידע על מסגרות נתמכות, ראו מסגרות נתמכות.
אופציונלי: אם מופיע הקטע Configure Parameters, מבצעים את הפעולות הבאות:
לוחצים על שינוי ההגדרות.
בחלון Configure parameters, מוסיפים את הפרמטרים הנדרשים לבקרות הענן. מידע נוסף על הפרמטרים זמין במאמרים הפניית בקרת ענן של Compliance Manager ובקרות ענן של Assured Workloads.
לוחצים על Save.
אופציונלי: בקטע View Assessment Plan, אתם יכולים להוריד קובץ ODS שמכיל מידע על היקף הביקורת, על סמך המסגרת שבחרתם. כדי להוריד את הקובץ, לוחצים על הקישור ואז על הבא.
בקטע Choose storage bucket, בוחרים קטגוריית אחסון שבה יישמרו דוח הביקורת וההוכחות, ולוחצים על Done. אם הקטגוריה לא מופיעה ברשימה, בקשו מהאדמין לרשום את המשאב בקטגוריית האחסון.
אופציונלי: בקטע לוח זמנים, מגדירים את האפשרויות הבאות:
תדירות החזרה על הביקורת (יומית, חודשית, רבעונית או שנתית).
התקופה שתיכלל בביקורת. אם בוחרים באפשרות ללא הגבלת זמן, הביקורת תמשיך לפעול מתאריך ההתחלה שציינתם עד שתפסיקו אותה ידנית.
כדי להתחיל את הביקורת, לוחצים על הפעלת ביקורת או על הפעלת ביקורת מתוזמנת.
אפשר לראות את סטטוס הביקורת בדף הצגת הערכות.
gcloud
אופציונלי: יצירת הערכת ביקורת
לפני שמריצים ביקורת בפועל, אפשר ליצור הערכת ביקורת (או היקף) שכוללת פירוט משימות מפורט לביקורת על סמך מסגרת התאימות שבחרתם.
הפקודה gcloud audit-manager audit-scopes generate יוצרת היקף ביקורת.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם
organization,folderו-project. - RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה:
8767234. - LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. במאמר מיקומים של Audit Manager מפורטת רשימה של נקודות הקצה הזמינות. לדוגמה:
us-central1. - FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה:
builtin-cis-v8. כדי למצוא את המזהה של מסגרת, אפשר לעיין בדף הצגת הערכות בכלי לניהול ביקורות. - AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר.
יש תמיכה רק בפורמט ODF:
AUDIT_REPORT_FORMAT_ODF. - OUTPUT_DIRECTORY: הספרייה שבה צריך לשמור את הפלט. לדוגמה:
reports. - OUTPUT_FILENAME: שם קובץ הפלט. אל תכללו את סיומת הקובץ בשם הקובץ. לדוגמה:
scopeReport.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud audit-manager audit-scopes generate \ --RESOURCE_TYPE=RESOURCE_ID \ --location=LOCATION \ --compliance-framework=FRAMEWORK \ --report-format=AUDIT_REPORT_FORMAT \ --output-directory=OUTPUT_DIRECTORY \ --output-file-name=OUTPUT_FILENAME
Windows (PowerShell)
gcloud audit-manager audit-scopes generate ` --RESOURCE_TYPE=RESOURCE_ID ` --location=LOCATION ` --compliance-framework=FRAMEWORK ` --report-format=AUDIT_REPORT_FORMAT ` --output-directory=OUTPUT_DIRECTORY ` --output-file-name=OUTPUT_FILENAME
Windows (cmd.exe)
gcloud audit-manager audit-scopes generate ^ --RESOURCE_TYPE=RESOURCE_ID ^ --location=LOCATION ^ --compliance-framework=FRAMEWORK ^ --report-format=AUDIT_REPORT_FORMAT ^ --output-directory=OUTPUT_DIRECTORY ^ --output-file-name=OUTPUT_FILENAME
הרצת ביקורת על פי דרישה
הפקודה gcloud audit-manager audit-reports generate מריצה ביקורת.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם
organization,folderו-project. - RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה:
8767234. - LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. במאמר מיקומים של Audit Manager מפורטת רשימה של נקודות הקצה הזמינות. לדוגמה:
us-central1. - FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה:
builtin-cis-v8. כדי למצוא את המזהה של מסגרת, אפשר לעיין בדף הצגת הערכות בכלי לניהול ביקורות. - BUCKET_URI: ה-URI של הקטגוריה ב-Cloud Storage. לדוגמה:
gs://testbucketauditmanager. - AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר.
יש תמיכה רק בפורמט ODF:
AUDIT_REPORT_FORMAT_ODF.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud audit-manager audit-reports generate \ --RESOURCE_TYPE=RESOURCE_ID \ --location=LOCATION \ --compliance-framework=FRAMEWORK \ --report-format=AUDIT_REPORT_FORMAT \ --gcs-uri=BUCKET_URI
Windows (PowerShell)
gcloud audit-manager audit-reports generate ` --RESOURCE_TYPE=RESOURCE_ID ` --location=LOCATION ` --compliance-framework=FRAMEWORK ` --report-format=AUDIT_REPORT_FORMAT ` --gcs-uri=BUCKET_URI
Windows (cmd.exe)
gcloud audit-manager audit-reports generate ^ --RESOURCE_TYPE=RESOURCE_ID ^ --location=LOCATION ^ --compliance-framework=FRAMEWORK ^ --report-format=AUDIT_REPORT_FORMAT ^ --gcs-uri=BUCKET_URI
אמורים לקבל תגובה שדומה לזו:
done: false name: projects/10398413/locations/987234/operations/operation-1726842525305-6228ddb4dca96-78a6db59-f9dd9a24
REST
אופציונלי: יצירת הערכת ביקורת
לפני שמריצים ביקורת בפועל, אפשר ליצור הערכת ביקורת (או היקף) שכוללת פירוט משימות לביקורת על סמך מסגרת התאימות שבחרתם.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם
organizations,foldersו-projects. - RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה:
8767234. - LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. במאמר מיקומים של Audit Manager מפורטת רשימה של נקודות הקצה הזמינות. לדוגמה:
us-central1. - FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה:
builtin-cis-v8. כדי למצוא את המזהה של מסגרת, אפשר לעיין בדף הצגת הערכות בכלי לניהול ביקורות. - AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר.
יש תמיכה רק בפורמט ODF:
AUDIT_REPORT_FORMAT_ODF.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate
גוף בקשת JSON:
{
"compliance_framework" : "FRAMEWORK"
"report_format" : "AUDIT_REPORT_FORMAT"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditScopesReport:generate" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"scope_report_contents" : "980u43nrf090834uhbkfehf......"
"name" : "folders/8767234/locations/us-west"
}
התגובה כוללת את הפרטים הבאים:
-
name: מזהה מחרוזת ייחודי של המשאב הרלוונטי.
השדה scope_reports_contents הוא פורמט הבייטים של התוכן, שצריך להמיר לפורמט ODF לפני הבדיקה.
הרצת ביקורת על פי דרישה
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם
organizations,foldersו-projects. - RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה:
8767234. - LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. במאמר מיקומים של Audit Manager מפורטת רשימה של נקודות הקצה הזמינות. לדוגמה:
us-central1. - FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה:
builtin-cis-v8. כדי למצוא את המזהה של מסגרת, אפשר לעיין בדף הצגת הערכות בכלי לניהול ביקורות. - BUCKET_URI: ה-URI של הקטגוריה ב-Cloud Storage. לדוגמה:
gs://testbucketauditmanager. - AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר.
יש תמיכה רק בפורמט ODF:
AUDIT_REPORT_FORMAT_ODF.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate
גוף בקשת JSON:
{
"destination" : {
"gcs_uri" : "BUCKET_URI"
},
"compliance_framework" : "FRAMEWORK"
"report_format" : "AUDIT_REPORT_FORMAT"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditReport:generate" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "organizations/834/projects/10398413/locations/987234/operations/098234",
"done": false
}
התגובה כוללת את הפרטים הבאים:
name: מזהה מחרוזת ייחודי של בקשת הפעולה להערכת הביקורת. המזהה הזה משמש למעקב אחרי ההתקדמות של תהליך הערכת הביקורת. לדוגמה:operation/098234.-
done: דגל בוליאני שמוגדר כ-falseומציין שהתהליך הופעל. הערך הזה מוגדר כ-trueכשהערכת הביקורת מסתיימת.
הרצת ביקורת מתוזמנת
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם
organizations,foldersו-projects. - RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה:
8767234. - LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. במאמר מיקומים של Audit Manager מפורטת רשימה של נקודות הקצה הזמינות. לדוגמה:
us-central1. - FRAMEWORK: המזהה של המסגרת שלפיה מתבצעת הביקורת. לדוגמה:
builtin-cis-v8. כדי למצוא את המזהה של מסגרת, אפשר לעיין בדף הצגת הערכות בכלי לניהול ביקורות. - BUCKET_URI: ה-URI של הקטגוריה ב-Cloud Storage. לדוגמה:
gs://testbucketauditmanager. - AUDIT_REPORT_FORMAT: הפורמט של דוח הביקורת שנוצר.
יש תמיכה רק בפורמט ODF:
AUDIT_REPORT_FORMAT_ODF. - DISPLAY_NAME: שם ללוח הזמנים של הביקורת. לדוגמה:
NIST 800-53 Daily Audit. - SCHEDULE_START_TIME: חותמת הזמן שבה לוח הזמנים של הביקורת הופך לפעיל. לדוגמה:
2026-02-25T10:00:00Z. - SCHEDULE_END_TIME: חותמת הזמן שבה לוח הזמנים של הביקורת מסתיים. לדוגמה:
2027-02-25T10:00:00Z. - FREQUENCY: התדירות של הרצות הביקורת המתוזמנות. אפשר להשתמש באחד מהערכים הבאים:
DAILY,WEEKLY,MONTHLY,QUARTERLYאוANNUALLY. לדוגמה:DAILY. - TIME_ZONE: אזור הזמן של לוח הזמנים של הביקורת בפורמט IANA. המשתנה הזה משמש לפרשנות של
start_timeו-end_time. אם לא מציינים אזור זמן, ברירת המחדל היא UTC. לדוגמה:America/New_York. - SCHEDULE_STATE: המצב של לוח הזמנים לביקורת. אפשר לבחור אחת מהאפשרויות הבאות:
SCHEDULE_STATE_ACTIVE,SCHEDULE_STATE_PAUSEDאוSCHEDULE_STATE_DELETED. לדוגמה:SCHEDULE_STATE_ACTIVE. - AUDIT_SCHEDULE_ID: מזהה ייחודי של לוח הזמנים לביקורת.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID
גוף בקשת JSON:
{
"display_name": "DISPLAY_NAME",
"gcs_uri": "BUCKET_URI",
"compliance_framework": "FRAMEWORK",
"report_format": "AUDIT_REPORT_FORMAT",
"schedule_config": {
"start_time": "SCHEDULE_START_TIME",
"end_time": "SCHEDULE_END_TIME",
"frequency": "FREQUENCY",
"time_zone": "TIME_ZONE"
},
"state": "SCHEDULE_STATE"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules?audit_schedule_id=AUDIT_SCHEDULE_ID" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
"display_name": "My first audit schedule",
"gcs_uri": "gs://my-bucket",
"compliance_framework": "NIST_800_53",
"report_format": "AUDIT_REPORT_FORMAT_ODF",
"schedule_config": {
"start_time": "2026-02-25T10:00:00Z",
"end_time": "2027-02-25T10:00:00Z",
"frequency": "DAILY",
"time_zone": "America/New_York"
},
"state": "SCHEDULE_STATE_ACTIVE",
"create_time": "2026-02-25T13:27:00Z",
"update_time": "2026-02-25T13:27:00Z"
}
עדכון ביקורות מתוזמנות
אתם יכולים להשהות, להמשיך ולהפסיק ביקורות חוזרות. כדי לשנות את לוח הזמנים, צריך למחוק את הביקורת המתוזמנת הקיימת וליצור ביקורת מתוזמנת חדשה.
המסוף
במסוף Google Cloud , נכנסים לדף Audit management בכלי לניהול ביקורות.
בכרטיסייה Schedules, מוצאים את הביקורת המתוזמנת שרוצים לעדכן.
מבצעים אחת מהפעולות הבאות:
כדי להשהות את לוח הזמנים של הביקורת, לוחצים על השהיית לוח הזמנים.
כדי להפעיל מחדש ביקורת שהושהתה, לוחצים על המשך לוח הזמנים.
כדי למחוק ביקורת מתוזמנת, לוחצים על הפסקת התזמון.
REST
כדי להשהות, להמשיך או למחוק לוח זמנים לביקורת, שולחים בקשת PATCH לעדכון ה-state של לוח הזמנים לביקורת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- RESOURCE_TYPE: סוג המשאב. הערכים התקינים הם
organizations,foldersו-projects. - RESOURCE_ID: מזהה המשאב של הארגון, הפרויקט או התיקייה. לדוגמה:
8767234. - LOCATION: המיקום של נקודת קצה ל-API של Audit Manager. במאמר מיקומים של Audit Manager מפורטת רשימה של נקודות הקצה הזמינות. לדוגמה:
us-central1. - AUDIT_SCHEDULE_ID: המזהה של לוח הזמנים של הביקורת שרוצים לעדכן. לדוגמה:
my-schedule-id. - SCHEDULE_STATE: מצב היעד של לוח הזמנים לביקורת. מגדירים אחת מהאפשרויות הבאות:
-
SCHEDULE_STATE_PAUSED: כדי להשהות לוח זמנים פעיל. -
SCHEDULE_STATE_ACTIVE: כדי להמשיך לוח זמנים שהושהה. -
SCHEDULE_STATE_DELETED: כדי להפסיק ולמחוק לוח זמנים.
-
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state
גוף בקשת JSON:
{
"state": "SCHEDULE_STATE"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://auditmanager.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/LOCATION/auditSchedules/AUDIT_SCHEDULE_ID?updateMask=state" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/834/locations/us-central1/auditSchedules/my-schedule-id",
"display_name": "My first audit schedule",
"gcs_uri": "gs://my-bucket",
"compliance_framework": "NIST_800_53",
"report_format": "AUDIT_REPORT_FORMAT_ODF",
"schedule_config": {
"start_time": "2026-02-25T10:00:00Z",
"end_time": "2027-02-25T10:00:00Z",
"frequency": "DAILY",
"time_zone": "America/New_York"
},
"state": "SCHEDULE_STATE_PAUSED",
"create_time": "2026-02-25T13:27:00Z",
"update_time": "2026-09-11T18:15:00Z"
}