本頁面說明如何使用授權政策,將 Identity-Aware Proxy (IAP) 指定為應用程式負載平衡器授權政策中的自訂授權引擎。
如要將授權委派給 IAP 和 Identity and Access Management (IAM),請根據代管負載平衡器的 IAM 或使用者身分,授權流量傳送至轉送規則。這樣就能對後端服務強制執行以 IAP 為基礎的存取控管。
事前準備
瞭解授權政策概念。
確認轉送規則的後端服務未啟用 IAP。如果已啟用 IAP,提交設定時會收到錯誤訊息。
建立授權政策並啟用 IAP
如要建立授權政策,請先建立政策檔案,定義目標和規則,然後在轉送規則上啟用 IAP。您可以在政策檔案的 httpRules 區段中定義條件,選擇僅對特定要求套用 IAP。如果省略 httpRules 區段,系統會對所有要求強制執行 IAP。
gcloud
執行下列指令,準備
policy.yaml檔案。這項政策允許 IP 位址範圍為10.0.0.0/24的用戶端,在轉送規則上啟用 IAP。$ cat << EOF > policy.yaml action: CUSTOM description: authz policy with Cloud IAP name: AUTHZ_POLICY_NAME httpRules: - from: sources: - ipBlocks: - prefix: "10.0.0.0" length: 24 customProvider: cloudIap: {} target: loadBalancingScheme: EXTERNAL_MANAGED resources: - https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/FORWARDING_RULE_ID EOF執行下列指令,為轉送規則啟用 IAP。
gcloud network-security authz-policies import AUTHZ_POLICY_NAME \ --source=policy.yaml \ --location=LOCATION \ --project=PROJECT_ID
更改下列內容:
PROJECT_ID: Google Cloud 專案 ID。
LOCATION:資源所在的區域。
FORWARDING_RULE_ID:轉送規則資源的 ID。
AUTHZ_POLICY_NAME:授權政策的名稱。
API
執行下列指令,準備
policy.json檔案。cat << EOF > policy.json { "name": "AUTHZ_POLICY_NAME", "target": { "loadBalancingScheme": "INTERNAL_MANAGED", "resources": [ "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/LOCATION/forwardingRules/FORWARDING_RULE_ID" ], }, "action": "CUSTOM", "httpRules": [ { "from": { "sources": { "ipBlocks": [ { "prefix": "10.0.0.0", "length": 24 } ] } } } ], "customProvider": { "cloudIap": {} } } EOF執行下列指令,為轉送規則啟用 IAP。
curl -X PATCH \\ -H "Authorization: Bearer $(gcloud auth print-access-token)" \\ -H "Accept: application/json" \\ -H "Content-Type: application/json" \\ -d @policy.json \\ "https://networksecurity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authzPolicies"
更改下列內容:
PROJECT_ID: Google Cloud 專案 ID。
LOCATION:資源所在的區域。
FORWARDING_RULE_ID:轉送規則資源的 ID。
AUTHZ_POLICY_NAME:授權政策的名稱。
將權限套用至資源
您可以使用 IAP API,將 IAM 權限套用至受 IAP 保護專案中的個別資源。在特定層級授予的 IAM 權限,會套用至其下的所有層級。舉例來說,在專案層級授予的權限,會套用至專案中的所有 Google Cloud 資源。
以下是設定權限的一些指令範例。詳情請參閱 gcloud iap web set-iam-policy。
gcloud
在範例指令中,將 POLICY_FILE 替換為 YAML 格式檔案的路徑,該檔案應包含有效政策。以下是 YAML 檔案範例:
bindings:
members: user:example@example.com
role: roles/iap.httpsResourceAccessor
更新轉送規則資源的存取權限
gcloud iap web set-iam-policy POLICY_FILE [--organization=ORGANIZATION \ --folder=FOLDER --project=PROJECT_ID \ --resource-type=RESOURCE_TYPE --service=SERVICE]
在組織層級設定權限
gcloud iap web set-iam-policy POLICY_FILE --organization=ORGANIZATION
在資料夾層級設定權限
gcloud iap web set-iam-policy POLICY_FILE --folder=FOLDER
在專案層級設定權限
gcloud iap web set-iam-policy POLICY_FILE --project=PROJECT_ID --resource-type=iap_web
設定專案中所有全域轉送規則的權限
gcloud iap web set-iam-policy POLICY_FILE --project=PROJECT_ID --resource-type=forwarding_rule
為專案中某個區域的所有轉送規則設定權限
gcloud iap web set-iam-policy POLICY_FILE --project=PROJECT_ID \ --resource-type=forwarding_rule --region=REGION
為專案中的特定全域轉送規則設定權限
gcloud iap web set-iam-policy POLICY_FILE --project=PROJECT_ID \ --resource-type=forwarding_rule --service=SERVICE
為區域中專案的特定轉送規則設定權限
gcloud iap web set-iam-policy POLICY_FILE --project=PROJECT_ID \ --resource-type=forwarding_rule --service=SERVICE --region=REGION
更改下列內容:
POLICY_FILE:YAML 檔案的路徑,其中包含有效的政策。
ORGANIZATION:組織 ID。
FOLDER:包含應用程式的資料夾。
PROJECT_ID: Google Cloud 專案 ID。
RESOURCE_TYPE:IAP 資源類型。資源類型必須是
app-engine、iap_web、compute、organization或folder。SERVICE:轉送規則 ID 或名稱。
REGION:資源所在的區域。
API
在組織層級設定權限
organization/ORGANIZATION
在資料夾層級設定權限
folders/FOLDER
在專案層級設定權限
projects/PROJECT_ID
設定專案中所有全域轉送規則的權限
projects/PROJECT_ID/forwarding_rule
為專案中某個區域的所有轉送規則設定權限
projects/PROJECT_ID/iap_web/forwarding_rule-REGION
為專案中的特定全域轉送規則設定權限
projects/PROJECT_ID/iap_web/forwarding_rule/services/SERVICE
為區域中專案的特定轉送規則設定權限
projects/PROJECT_ID/iap_web/forwarding_rule-REGION/services/SERVICE
設定授權政策
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d @policy.json \ "https://iap.googleapis.com/v1/RESOURCE_NAME:setIamPolicy"
如要建立 policy.json 的 JSON 檔案,請執行下列指令。視需要更新值。
cat << EOF > policy.json
{
"bindings": {
"members": "user:example@example.com",
"role": "roles/iap.httpsResourceAccessor",
}
}
EOF
更改下列內容:
ORGANIZATION:組織 ID。
FOLDER:包含應用程式的資料夾。
PROJECT_ID: Google Cloud 專案 ID。
REGION:資源所在的區域。
SERVICE:轉送規則 ID 或名稱。