הגדרת ההגדרות של Privileged Access Manager

כאדמינים של הגדרות של Privileged Access Manager, אתם יכולים להגדיר כמה הגדרות נוספות של תהליך העבודה לאישור והעדפות ההתראות.

ההגדרות שאתם קובעים ברמת הארגון או התיקייה חלות באופן אוטומטי על משאבי הצאצאים, אלא אם אתם מבטלים במפורש את ההגדרות ברמת משאב הצאצא.

אתם יכולים להפעיל אישורים אוטומטיים כדי לאפשר לחשבונות שירות ולזהויות של סוכנים להיות מאשרים כשירים. ההגדרה של אישורים אוטומטיים משפיעה על האופן שבו אפשר לשלב אוטומציה וגישה פרוגרמטית בתהליכי העבודה של אישורים לגישה עם הרשאות.

ההגדרה 'אישורים אוטומטיים' מאפשרת לאדמינים להוסיף חשבונות שירות, זהויות של סוכנים וזהויות במאגרי זהויות של עומסי עבודה כמאשרים כשיוצרים או משנים הרשאה.

אתם יכולים להתאים אישית את העדפות ההתראות ברמת המשאב לגבי אירועים שונים של 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

אישורים אוטומטיים

המסוף

  1. עוברים לדף Privileged Access Manager.

    כניסה ל-Privileged Access Manager

  2. בוחרים את הארגון, התיקייה או הפרויקט.

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

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

  5. כדי להפעיל אישורים אוטומטיים, מפעילים את המתג 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.

התאמה אישית של ההעדפות לגבי התראות

המסוף

  1. עוברים לדף Privileged Access Manager.

    כניסה ל-Privileged Access Manager

  2. בוחרים את הארגון, התיקייה או הפרויקט.

  3. לוחצים על הכרטיסייה הגדרות.

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

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

    אירוע אדמין הגורם המבקש הגורם המאשר
    ההרשאה הוקצתה - ✓ -
    נדרש אישור למתן הגישה - - ✓
    המענקים מופעלים ✓ ✓ -
    בקשות הגישה נדחות - ✓ -
    פג התוקף של בקשות הגישה - ✓ -
    הגישה הסתיימה ✓ ✓ -
    בקשות הגישה נדחות - ✓ -
    בקשות הגישה שונו על ידי גורם חיצוני ✓ ✓ -
    ההפעלה של בקשות הגישה נכשלה ✓ ✓ -
  5. כדי לבטל את ההורשה של ההגדרות מההורה, מפעילים את המתג שליחת התראות לגבי האירועים הבאים.

  6. כדי להשבית את ההתראות על אירוע ופרסונה ספציפיים של PAM, מבטלים את הסימון בתיבות הסימון המתאימות ולוחצים על שמירה.

  7. כדי להשבית את כל ההתראות, מבטלים את הסימון של שליחת התראות לגבי האירועים הבאים ולוחצים על שמירה.

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.

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