ההגדרות שאתם קובעים ברמת הארגון או התיקייה חלות באופן אוטומטי על משאבי הצאצאים, אלא אם אתם מבטלים במפורש את ההגדרות ברמת משאב הצאצא.
אתם יכולים להפעיל אישורים אוטומטיים כדי לאפשר לחשבונות שירות ולזהויות של סוכנים להיות מאשרים כשירים. ההגדרה של אישורים אוטומטיים משפיעה על האופן שבו אפשר לשלב אוטומציה וגישה פרוגרמטית בתהליכי העבודה של אישורים לגישה עם הרשאות.
ההגדרה 'אישורים אוטומטיים' מאפשרת לאדמינים להוסיף חשבונות שירות, זהויות של סוכנים וזהויות במאגרי זהויות של עומסי עבודה כמאשרים כשיוצרים או משנים הרשאה.
אתם יכולים להתאים אישית את העדפות ההתראות ברמת המשאב לגבי אירועים שונים של Privileged Access Manager. אפשר להשבית התראות לגבי אירועים ספציפיים ופרסונות ספציפיות, או להשבית את כל ההתראות.
לפני שמתחילים
כדי לקבל את ההרשאות שדרושות להגדרה של ההגדרות של הכלי לניהול גישה עם הרשאות מיוחדות, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:
-
כדי לקבוע את ההגדרות של הפרויקט, התיקייה או הארגון: אדמין של הגדרות PAM (
roles/privilegedaccessmanager.settingsAdmin) בארגון -
כדי להציג את ההגדרות של הפרויקט, התיקייה או הארגון:
צפייה בהגדרות PAM (
roles/privilegedaccessmanager.settingsViewer) בפרויקט, בתיקייה או בארגון
התפקידים המוגדרים מראש האלה מכילים את ההרשאות שנדרשות להגדרת ההגדרות של Privileged Access Manager. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי להגדיר את ההגדרות של Privileged Access Manager, נדרשות ההרשאות הבאות:
-
קובעים את ההגדרות:
privilegedaccessmanager.settings.update -
הצגת ההגדרות:
-
privilegedaccessmanager.settings.get -
privilegedaccessmanager.settings.fetchEffective
-
אישורים אוטומטיים
המסוף
עוברים לדף Privileged Access Manager.
בוחרים את הארגון, התיקייה או הפרויקט.
לוחצים על הכרטיסייה הגדרות. בקטע מקור ההגדרות, האפשרות ירושה מההורה מסומנת כברירת מחדל.
כדי לשנות הגדרות שמועברות בירושה ממקור האב למקור צאצא, בקטע אישורים אוטומטיים בוחרים באפשרות שינוי הגדרות שמועברות בירושה.
כדי להפעיל אישורים אוטומטיים, מפעילים את המתג Enable Agent Identity and Service Account as Approvers ולוחצים על Save.
gcloud
הפקודה
gcloud alpha pam settings update
מגדירה עוד Privileged Access Manager.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: אופציונלי. סוג המשאב שרוצים לעדכן את ההגדרות שלו. אפשר להשתמש בערךorganization,folderאוproject. -
RESOURCE_ID: משמש עםRESOURCE_TYPE. המזהה של הפרויקט, התיקייה או הארגון שרוצים לנהל את ההרשאות שלהם. Google Cloudמזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות וארגונים מכילים רק ספרות, למשל123456789012. -
SA_AS_APPROVER: ערך בוליאני בשדהserviceAccountApproverSettingsשמציין אם לחשבונות שירות ולזהויות של סוכנים מותר לאשר הענקות. ערך ברירת המחדל הואfalse.- אם מציינים ערך בשדה
serviceAccountApproverSettings, ההגדרה הזו חלה על המשאב. - אם מציינים את השדה
serviceAccountApproverSettingsאבל לא ממלאים אותו, המערכת מחילה על המשאב את הגדרות ברירת המחדל. - אם לא מציינים את השדה
serviceAccountApproverSettingsבכלל, המשאב יקבל בירושה את ההגדרות מהמשאב הראשי.
אם משביתים את ההגדרה הזו, לא יאושרו הרשאות שנדרש אישור לגביהן מחשבונות שירות או מזהויות של סוכנים. אם בהרשאות שלכם יש רק חשבונות שירות או זהויות של סוכנים כמאשרים, ההרשאות האלה לא תקפות.
- אם מציינים ערך בשדה
-
request.json: קובץ שמכיל את ההגדרות ששונו. כדי ליצור את הקובץ הזה, מקבלים את ההגדרות הקיימות, שומרים את התגובה בקובץ בשםrequest.json, ואז משנים אותו כדי להשתמש בו כגוף של בקשת העדכון. כדי לעדכן את הגרסה האחרונה של ההגדרות, צריך לכלול את ה-ETAG בגוף הבקשה.
שומרים את התוכן הבא בקובץ בשם filename.yaml:
emailNotificationSettings: customNotificationBehavior: adminNotifications: grantActivated: NOTIFICATION_MODE_1 grantActivationFailed: DISABLED grantEnded: ENABLED grantExternallyModified: ENABLED approverNotifications: pendingApproval: NOTIFICATION_MODE_2 requesterNotifications: entitlementAssigned: ENABLED grantActivated: ENABLED grantExpired: NOTIFICATION_MODE_3 grantRevoked: ENABLED etag:'"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md"' name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings serviceAccountApproverSettings: enabled: SA_AS_APPROVER
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud alpha pam settings update \ --location=global \ --RESOURCE_TYPE=RESOURCE_ID \ --settings-file FILENAME.yaml
Windows (PowerShell)
gcloud alpha pam settings update ` --location=global ` --RESOURCE_TYPE=RESOURCE_ID ` --settings-file FILENAME.yaml
Windows (cmd.exe)
gcloud alpha pam settings update ^ --location=global ^ --RESOURCE_TYPE=RESOURCE_ID ^ --settings-file FILENAME.yaml
אמורים לקבל תגובה שדומה לזו:
Parsed [location] resource: RESOURCE_TYPE/RESOURCE_ID/locations/global
Request issued for: [global]
Updated location [global].
createTime: '2025-05-18T10:10:10.101010101Z'
emailNotificationSettings:
customNotificationBehavior:
adminNotifications:
grantActivated: ENABLED
grantActivationFailed: DISABLED
grantEnded: ENABLED
grantExternallyModified: ENABLED
approverNotifications:
pendingApproval: ENABLED
requesterNotifications:
entitlementAssigned: ENABLED
grantActivated: ENABLED
grantExpired: ENABLED
grantRevoked: ENABLED
etag: "ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md1"
name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings
serviceAccountApproverSettings:
enabled: true
updateTime: '2025-05-18T10:10:40.101010101Z'
REST
השיטה של Privileged Access Manager API
updateSettings
מגדירה Privileged Access Manager נוסף.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
SCOPE: הארגון, התיקייה או הפרויקט שרוצים לעדכן את ההגדרות שלהם, בפורמטorganizations/ORGANIZATION_ID,folders/FOLDER_IDאוprojects/PROJECT_ID. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות וארגונים מכילים רק ספרות, למשל123456789012. -
UPDATED_FIELDS: רשימה מופרדת בפסיקים של השדות שצריך לעדכן בהגדרות. לדוגמה,emailNotificationSettings,serviceAccountApproverSettings.כדי לעדכן את כל השדות שאפשר לשנות, מגדירים את מסכת העדכון ל-
*. -
SA_AS_APPROVER: ערך בוליאני בשדהserviceAccountApproverSettingsשמציין אם לחשבונות שירות ולזהויות של סוכנים מותר לאשר הענקות. ערך ברירת המחדל הואfalse.- אם מציינים ערך בשדה
serviceAccountApproverSettings, ההגדרה הזו חלה על המשאב. - אם מציינים את השדה
serviceAccountApproverSettingsאבל לא ממלאים אותו, המערכת מחילה על המשאב את הגדרות ברירת המחדל. - אם לא מציינים את השדה
serviceAccountApproverSettingsבכלל, המשאב יקבל בירושה את ההגדרות מהמשאב הראשי.
אם משביתים את ההגדרה הזו, לא תאושרנה הענקות שדורשות אישורים מחשבונות שירות או מזהויות של סוכנים. אם בהרשאות שלכם יש רק חשבונות שירות או זהויות של סוכנים כמאשרים, ההרשאות האלה לא תקפות.
- אם מציינים ערך בשדה
-
request.json: קובץ שמכיל את ההגדרות ששונו. כדי ליצור את הקובץ הזה, מקבלים את ההגדרות הקיימות, שומרים את התגובה בקובץ בשםrequest.json, ואז משנים אותו כדי להשתמש בו כגוף של בקשת העדכון. כדי לעדכן את הגרסה האחרונה של ההגדרות, צריך לכלול את ה-ETAG בגוף הבקשה.
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings?updateMask=UPDATED_FIELDS
תוכן בקשת JSON:
{
"emailNotificationSettings": {
"customNotificationBehavior": {
"adminNotifications": {
"grantActivated": "NOTIFICATION_MODE_1",
"grantActivationFailed": "DISABLED",
"grantEnded": "ENABLED",
"grantExternallyModified": "ENABLED"
},
"approverNotifications": {
"pendingApproval": "NOTIFICATION_MODE_2"
},
"requesterNotifications": {
"entitlementAssigned": "ENABLED",
"grantActivated": "ENABLED",
"grantExpired": "NOTIFICATION_MODE_3",
"grantRevoked": "ENABLED"
}
}
},
"etag": "\"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md\"",
"name": "SCOPE/locations/global/settings",
"serviceAccountApproverSettings": {
"enabled": SA_AS_APPROVER
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "SCOPE/locations/global/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.privilegedaccessmanager.v1beta.OperationMetadata",
"createTime": "2024-03-25T01:55:02.544562950Z",
"target": "SCOPE/locations/global/settings",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v1beta"
},
"done": false
}
כדי לבדוק את התקדמות פעולת העדכון, אפשר לשלוח בקשת GET לנקודת הקצה הבאה:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID
כדי לראות רשימה של כל הפעולות, שולחים בקשת GET לנקודת הקצה הבאה:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations
Terraform
אתם יכולים להשתמש ב-Terraform כדי להגדיר את ההגדרות של Privileged Access Manager. למידע נוסף, תוכלו לעיין במאמר google_privileged_access_manager_settings במסמכי התיעוד של Terraform.
התאמה אישית של ההעדפות לגבי התראות
המסוף
עוברים לדף Privileged Access Manager.
בוחרים את הארגון, התיקייה או הפרויקט.
לוחצים על הכרטיסייה הגדרות.
בקטע התראות, האפשרות עובר בירושה מההורה מסומנת כברירת מחדל.
בטבלה הבאה מוצגות העדפות ההתראות שמוגדרות כברירת מחדל:
אירוע אדמין הגורם המבקש הגורם המאשר ההרשאה הוקצתה - ✓ - נדרש אישור למתן הגישה - - ✓ המענקים מופעלים ✓ ✓ - בקשות הגישה נדחות - ✓ - פג התוקף של בקשות הגישה - ✓ - הגישה הסתיימה ✓ ✓ - בקשות הגישה נדחות - ✓ - בקשות הגישה שונו על ידי גורם חיצוני ✓ ✓ - ההפעלה של בקשות הגישה נכשלה ✓ ✓ - כדי לבטל את ההורשה של ההגדרות מההורה, מפעילים את המתג שליחת התראות לגבי האירועים הבאים.
כדי להשבית את ההתראות על אירוע ופרסונה ספציפיים של PAM, מבטלים את הסימון בתיבות הסימון המתאימות ולוחצים על שמירה.
כדי להשבית את כל ההתראות, מבטלים את הסימון של שליחת התראות לגבי האירועים הבאים ולוחצים על שמירה.
gcloud
הפקודה
gcloud alpha pam settings update
מגדירה עוד Privileged Access Manager.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: אופציונלי. סוג המשאב שרוצים לעדכן את ההגדרות שלו. אפשר להשתמש בערךorganization,folderאוproject. -
RESOURCE_ID: משמש עםRESOURCE_TYPE. המזהה של הפרויקט, התיקייה או הארגון שרוצים לנהל את ההרשאות שלהם. Google Cloudמזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות וארגונים מכילים רק ספרות, למשל123456789012. NOTIFICATION_MODE: בשדהemailNotificationSettings, משתמשים ב-ENABLEDכדי לשלוח התראות באימייל על האירוע, או ב-DISABLEDכדי למנוע את השליחה.- אם מציינים ערך בשדה
emailNotificationSettings, ההגדרה הזו חלה על המשאב. - אם מציינים את השדה
emailNotificationSettingsאבל לא ממלאים אותו, המערכת מחילה על המשאב את הגדרות ברירת המחדל. - אם לא מציינים את השדה
emailNotificationSettingsבכלל, המשאב יקבל בירושה את ההגדרות מהמשאב הראשי.
- אם מציינים ערך בשדה
-
request.json: קובץ שמכיל את ההגדרות ששונו. כדי ליצור את הקובץ הזה, מקבלים את ההגדרות הקיימות, שומרים את התגובה בקובץ בשםrequest.json, ואז משנים אותו כדי להשתמש בו כגוף של בקשת העדכון. כדי לעדכן את הגרסה האחרונה של ההגדרות, צריך לכלול את ה-ETAG בגוף הבקשה.
שומרים את התוכן הבא בקובץ בשם filename.yaml:
emailNotificationSettings: customNotificationBehavior: adminNotifications: grantActivated: NOTIFICATION_MODE_1 grantActivationFailed: DISABLED grantEnded: ENABLED grantExternallyModified: ENABLED approverNotifications: pendingApproval: NOTIFICATION_MODE_2 requesterNotifications: entitlementAssigned: ENABLED grantActivated: ENABLED grantExpired: NOTIFICATION_MODE_3 grantRevoked: ENABLED etag:'"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md"' name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings serviceAccountApproverSettings: enabled: SA_AS_APPROVER
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud alpha pam settings update \ --location=global \ --RESOURCE_TYPE=RESOURCE_ID \ --settings-file FILENAME.yaml
Windows (PowerShell)
gcloud alpha pam settings update ` --location=global ` --RESOURCE_TYPE=RESOURCE_ID ` --settings-file FILENAME.yaml
Windows (cmd.exe)
gcloud alpha pam settings update ^ --location=global ^ --RESOURCE_TYPE=RESOURCE_ID ^ --settings-file FILENAME.yaml
אמורים לקבל תגובה שדומה לזו:
Parsed [location] resource: RESOURCE_TYPE/RESOURCE_ID/locations/global
Request issued for: [global]
Updated location [global].
createTime: '2025-05-18T10:10:10.101010101Z'
emailNotificationSettings:
customNotificationBehavior:
adminNotifications:
grantActivated: ENABLED
grantActivationFailed: DISABLED
grantEnded: ENABLED
grantExternallyModified: ENABLED
approverNotifications:
pendingApproval: ENABLED
requesterNotifications:
entitlementAssigned: ENABLED
grantActivated: ENABLED
grantExpired: ENABLED
grantRevoked: ENABLED
etag: "ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md1"
name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings
serviceAccountApproverSettings:
enabled: true
updateTime: '2025-05-18T10:10:40.101010101Z'
REST
השיטה של Privileged Access Manager API
updateSettings
מגדירה Privileged Access Manager נוסף.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
SCOPE: הארגון, התיקייה או הפרויקט שרוצים לעדכן את ההגדרות שלהם, בפורמטorganizations/ORGANIZATION_ID,folders/FOLDER_IDאוprojects/PROJECT_ID. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות וארגונים מכילים רק ספרות, למשל123456789012. -
UPDATED_FIELDS: רשימה מופרדת בפסיקים של השדות שצריך לעדכן בהגדרות. לדוגמה,emailNotificationSettings,serviceAccountApproverSettings.כדי לעדכן את כל השדות שאפשר לשנות, מגדירים את מסכת העדכון ל-
*. NOTIFICATION_MODE: בשדהemailNotificationSettings, משתמשים ב-ENABLEDכדי לשלוח התראות באימייל על האירוע או ב-DISABLEDכדי למנוע את השליחה.- אם מציינים ערך בשדה
emailNotificationSettings, ההגדרה הזו חלה על המשאב. - אם מציינים את השדה
emailNotificationSettingsאבל לא ממלאים אותו, המערכת מחילה על המשאב את הגדרות ברירת המחדל. - אם לא מציינים את השדה
emailNotificationSettingsבכלל, המשאב יקבל בירושה את ההגדרות מהמשאב הראשי.
- אם מציינים ערך בשדה
-
request.json: קובץ שמכיל את ההגדרות ששונו. כדי ליצור את הקובץ הזה, מקבלים את ההגדרות הקיימות, שומרים את התגובה בקובץ בשםrequest.json, ואז משנים אותו כדי להשתמש בו כגוף של בקשת העדכון. כדי לעדכן את הגרסה האחרונה של ההגדרות, צריך לכלול את ה-ETAG בגוף הבקשה.
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings?updateMask=UPDATED_FIELDS
תוכן בקשת JSON:
{
"emailNotificationSettings": {
"customNotificationBehavior": {
"adminNotifications": {
"grantActivated": "NOTIFICATION_MODE_1",
"grantActivationFailed": "DISABLED",
"grantEnded": "ENABLED",
"grantExternallyModified": "ENABLED"
},
"approverNotifications": {
"pendingApproval": "NOTIFICATION_MODE_2"
},
"requesterNotifications": {
"entitlementAssigned": "ENABLED",
"grantActivated": "ENABLED",
"grantExpired": "NOTIFICATION_MODE_3",
"grantRevoked": "ENABLED"
}
}
},
"etag": "\"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md\"",
"name": "SCOPE/locations/global/settings",
"serviceAccountApproverSettings": {
"enabled": SA_AS_APPROVER
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "SCOPE/locations/global/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.privilegedaccessmanager.v1beta.OperationMetadata",
"createTime": "2024-03-25T01:55:02.544562950Z",
"target": "SCOPE/locations/global/settings",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v1beta"
},
"done": false
}
כדי לבדוק את התקדמות פעולת העדכון, אפשר לשלוח בקשת GET לנקודת הקצה הבאה:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations/OPERATION_ID
כדי לראות רשימה של כל הפעולות, שולחים בקשת GET לנקודת הקצה הבאה:
https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/operations
Terraform
אתם יכולים להשתמש ב-Terraform כדי להגדיר את ההגדרות של Privileged Access Manager. למידע נוסף, תוכלו לעיין במאמר google_privileged_access_manager_settings במסמכי התיעוד של Terraform.