存取層級屬性

存取層級可定義各種屬性，這些屬性用來篩選對特定資源提出的要求。下表列出存取層級支援的屬性，並提供有關各項屬性的額外詳細資料。

使用 gcloud 指令列工具建立或修改存取層級時，您必須格式化 YAML 中的屬性。這個表格包含每個屬性的 YAML 語法以及有效值，並且也會針對各項屬性提供 REST 和 RPC 參考資料的連結。

如要進一步瞭解存取層級和 YAML，請參閱存取層級的 YAML 範例。

您可在存取層級納入下列屬性：

• IP 子網路

• 區域

• 存取層級依附元件

• 原則

• 裝置政策

屬性
IP 子網路	說明 檢查要求是否來自一或多個您指定的 IPv4 和/或 IPv6 CIDR 區塊。 如果您指定多個 IP 子網路，系統會在評估條件時使用 OR 運算子合併您輸入的值。要求必須符合您指定的任一值，才能讓條件評估為 true。 YAML ipSubnetworks 有效值 一或多個 IPv4 和/或 IPv6 CIDR 區塊的清單。 API 參考資料 REST RPC
區域	說明 檢查要求是否來自特定地區。地區是由對應的 ISO 3166-1 alpha-2 代碼識別。 注意：要求的來源會根據產生要求的 IP 位址地理位置判定。因此，region 屬性僅適用於來自公開 IP 位址的要求。 由於私人 IP 位址無法進行地理定位，因此需要指定區域的存取層級一律會拒絕來自私人 IP 位址的要求，也不支援使用私人 Google 存取權提出的要求。 如果指定多個區域，系統會在評估條件時將您輸入的值以 OR 運算，如果使用者位於您指定的任一區域，系統就會授予他們存取權。 YAML regions 有效值 一或多個 ISO 3166-1 alpha-2 代碼的清單。 API 參考資料 無
存取層級依附元件	說明 檢查要求是否符合一或多個存取層級的條件。 YAML requiredAccessLevels 有效值 一或多個現有存取層級的清單，格式如下： accessPolicies/POLICY-NAME/accessLevels/LEVEL-NAME 其中： POLICY-NAME 是您機構的存取權政策以數字表示的名稱。 LEVEL-NAME 是指您要視為依附元件新增的存取層級名稱。 API 參考資料 REST RPC
原則	說明 檢查要求是否來自特定使用者或服務帳戶。 只有在使用 gcloud 指令列工具或 Access Context Manager API 建立或修改存取層級時，才能在條件中加入這個屬性。如果您是使用 Google Cloud 主控台建立存取層級，可以使用上述任一方法將使用者加入該存取層級。 YAML members 有效值 一或多個使用者或服務帳戶的清單，格式如下： user: EMAIL serviceAccount: EMAIL 其中： EMAIL 是指您要納入存取層級的使用者或服務帳戶的個別電子郵件。 不支援群組。 API 參考資料 REST RPC
裝置政策	相關規定 如要在行動裝置上使用裝置政策屬性，您必須為貴機構設定 MDM。 如要在其他裝置上使用裝置政策屬性，必須啟用 端點驗證。 說明 裝置政策是一組 屬性集合，可根據要求來源裝置的相關資訊來篩選要求。 舉例來說，裝置政策屬性搭配 Identity-Aware Proxy 使用可支援情境感知存取權。 YAML devicePolicy 有效值 devicePolicy 是一或多個裝置政策屬性的清單，以下是支援的屬性： 必須使用螢幕鎖定 儲存空間加密 須經管理員核准 需要公司自有裝置 OS 政策 只有特定裝置政策屬性可用於行動裝置。「支援行動裝置」列會指出屬性是否可與行動裝置搭配使用。 API 參考資料 REST RPC 裝置政策屬性 必須使用螢幕鎖定功能 說明 檢查裝置是否已啟用螢幕鎖定功能。 支援行動裝置 是 YAML requireScreenlock 有效值 true false 如果省略此屬性，系統會預設為 false。 API 參考資料 REST RPC 儲存空間加密 說明 檢查裝置是否加密、未加密或不支援儲存空間加密。 支援行動裝置 是 重要事項：如要讓 iOS 裝置符合儲存空間加密屬性，必須在裝置上啟用螢幕鎖定功能。 YAML allowedEncryptionStatuses 有效值 下列其中一個或多個值： ENCRYPTION_UNSUPPORTED ENCRYPTED UNENCRYPTED API 參考資料 REST RPC 須經管理員核准 說明 檢查裝置是否已通過管理員核准。 支援行動裝置 是 YAML requireAdminApproval 有效值 true false 如果省略此屬性，系統會預設為 false。 API 參考資料 無 需要公司自有裝置 說明 檢查裝置是否由您的企業擁有。 支援行動裝置 是 YAML requireCorpOwned 有效值 true false 如果省略此屬性，系統會預設為 false。 API 參考資料 無 OS 政策 說明 檢查政策目前使用的是否為指定的作業系統。此外，您還可指定裝置必須使用的最低 OS 版本。 如果您建立的是 Chrome OS 政策，也可指定必須使用 已驗證的 Chrome OS 。 選取多個作業系統後，系統會在評估條件時使用「或」運算子。如果使用者使用您指定的其中一個作業系統，系統就會授予存取權。 支援行動裝置 是 YAML osConstraints 有效值 osConstraints 是一份必須包含一或多個 osType 例項的清單。osType 可與 minimumVersion 例項配對，但不需要 minimumVersion。 osType 必須納入下列其中一個或多個值的清單： DESKTOP_MAC DESKTOP_WINDOWS DESKTOP_CHROME_OS DESKTOP_LINUX IOS ANDROID minimumVersion 為選用欄位。如果要使用，就必須隨附於 osType。 minimumVersion 必須包含格式為 MAJOR.MINOR.PATCH 的最低版本。 例如 10.5.301。 如果您為 osType 指定 DESKTOP_CHROME_OS，可以選擇納入 requireVerifiedChromeOs。 requireVerifiedChromeOs 的有效值如下： true false 如果您為 osType 指定 IOS 或 ANDROID，可以選擇加入任何支援行動裝置的裝置政策屬性。 API 參考資料 REST RPC