查看 Privileged Access Manager 設定

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Privileged Access Manager 設定檢視者可以查看機構、資料夾或專案的 Privileged Access Manager 設定。

事前準備

如要取得查看 Privileged Access Manager 設定所需的權限，請要求管理員在機構、資料夾或專案中授予下列 IAM 角色：

• 如要查看設定： PAM 設定檢視器 (roles/privilegedaccessmanager.settingsViewer)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這些預先定義角色具備查看 Privileged Access Manager 設定所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要查看 Privileged Access Manager 設定，您必須具備下列權限：

• 如要查看設定，請按照下列步驟操作：
  • privilegedaccessmanager.settings.get
  • privilegedaccessmanager.settings.fetchEffective

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

查看設定

控制台

1. 前往「Privileged Access Manager」頁面。

   前往 Privileged Access Manager

2. 選取要查看 Privileged Access Manager 設定的機構、資料夾或專案。

3. 按一下 [設定] 標籤。

「設定」頁面會顯示所選資源的 Privileged Access Manager 設定詳細資料。

REST

您可以查看資源的下列設定：

• 直接在資源上設定的個別設定。

• 資源上設定或從父項資源繼承的有效設定。

  查看資源的個別設定

  Privileged Access Manager API 的 getSettings 方法會查看 Privileged Access Manager 設定。

  使用任何要求資料之前，請先替換以下項目：

  • SCOPE：您要擷取設定的機構、資料夾或專案，格式為 organizations/ORGANIZATION_ID、folders/FOLDER_ID 或 projects/PROJECT_ID。專案 ID 為英數字串，例如 my-project。資料夾和機構 ID 都是數字，例如 123456789012。

  HTTP 方法和網址：

  GET https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings

  如要傳送要求，請展開以下其中一個選項：

  curl (Linux、macOS 或 Cloud Shell)

  注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或使用 Cloud Shell，自動登入 gcloud CLI。 您可以執行 gcloud auth list 查看目前有效的帳戶。

  執行下列指令：

  curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       "https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings"

  PowerShell (Windows)

  注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。 您可以執行 gcloud auth list 查看目前有效的帳戶。

  執行下列指令：

  $cred = gcloud auth print-access-token
  $headers = @{ "Authorization" = "Bearer $cred" }
  
  Invoke-WebRequest `
      -Method GET `
      -Headers $headers `
      -Uri "https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings" | Select-Object -Expand Content

  您應該會收到如下的 JSON 回應：

  
  {
    "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": "\"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md\"",
    "name": "SCOPE/locations/global/settings",
    "serviceAccountApproverSettings": {
      "enabled": true
    },
    "updateTime": "2025-05-18T10:10:10.101010101Z"
  }
  
  

  查看資源的有效設定

  Privileged Access Manager API 的 fetchEffectiveSettings 方法會查看 Privileged Access Manager 設定。

  使用任何要求資料之前，請先替換以下項目：

  • SCOPE：您要擷取設定的機構、資料夾或專案，格式為 organizations/ORGANIZATION_ID、folders/FOLDER_ID 或 projects/PROJECT_ID。專案 ID 為英數字串，例如 my-project。資料夾和機構 ID 都是數字，例如 123456789012。

  HTTP 方法和網址：

  GET https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global:effectiveSettings

  如要傳送要求，請展開以下其中一個選項：

  curl (Linux、macOS 或 Cloud Shell)

  注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或使用 Cloud Shell，自動登入 gcloud CLI。 您可以執行 gcloud auth list 查看目前有效的帳戶。

  執行下列指令：

  curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       "https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global:effectiveSettings"

  PowerShell (Windows)

  注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。 您可以執行 gcloud auth list 查看目前有效的帳戶。

  執行下列指令：

  $cred = gcloud auth print-access-token
  $headers = @{ "Authorization" = "Bearer $cred" }
  
  Invoke-WebRequest `
      -Method GET `
      -Headers $headers `
      -Uri "https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global:effectiveSettings" | Select-Object -Expand Content

  您應該會收到如下的 JSON 回應：

  {
    "emailNotificationSettings": {
      "customNotificationBehavior": {
        "adminNotifications": {
          "notifyGrantActivated": "true",
          "notifyGrantActivationFailed": "true",
          "notifyGrantEnded": "true",
          "notifyGrantExternallyModified": "true"
        },
        "approverNotifications": {
          "notifyPendingApproval": "true"
        },
        "requesterNotifications": {
          "notifyEntitlementAssigned": "true",
          "notifyEntitlementUpdated": "true",
          "notifyGrantActivated": "true",
          "notifyGrantActivationFailed": "true",
          "notifyGrantEnded": "true",
          "notifyGrantExpired": "true",
          "notifyGrantExternallyModified": "true",
          "notifyGrantRevoked": "true"
        }
      }
    },
    "parent": "SCOPE/locations/global",
    "serviceAccountApproverSettings": {}
  }
  
  

後續步驟

• 建立授權