使用用戶端程式庫授予角色
瞭解如何以您偏好的程式設計語言,開始使用 Resource Manager API 的 IAM 方法。
事前準備
建立 Cloud de Confiance 專案
在這個快速入門導覽課程中,您需要使用新的 Cloud de Confiance 專案。
-
安裝 Google Cloud CLI。
-
設定 gcloud CLI,使用您的聯合身分。
詳情請參閱「使用聯合身分登入 gcloud CLI」。
-
執行下列指令,初始化 gcloud CLI:
gcloud init -
選取或建立專案所需的角色
- 選取專案:選取專案時,不需要具備特定 IAM 角色,只要您已獲授角色,即可選取任何專案。
-
建立專案:如要建立專案,您需要具備專案建立者角色 (
roles/resourcemanager.projectCreator),其中包含resourcemanager.projects.create權限。瞭解如何授予角色。
-
建立 Cloud de Confiance 專案:
gcloud projects create PROJECT_ID
將
PROJECT_ID替換為您要建立的 Cloud de Confiance 專案名稱。 -
選取您建立的 Cloud de Confiance 專案:
gcloud config set project PROJECT_ID
將
PROJECT_ID替換為 Cloud de Confiance 專案名稱。
啟用 Resource Manager API:
啟用 API 時所需的角色
如要啟用 API,您需要具備服務使用情形管理員 IAM 角色 (
roles/serviceusage.serviceUsageAdmin),其中包含serviceusage.services.enable權限。瞭解如何授予角色。gcloud services enable cloudresourcemanager.googleapis.com
-
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果系統傳回驗證錯誤,且您使用外部識別資訊提供者 (IdP),請確認您已 使用聯合身分登入 gcloud CLI。
-
將角色授予使用者帳戶。針對下列每個 IAM 角色,執行一次下列指令:
roles/resourcemanager.projectIamAdmingcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
更改下列內容:
PROJECT_ID:專案 ID。USER_IDENTIFIER:使用者帳戶的 ID。 帳戶。如需範例,請參閱「 在 IAM 政策中代表工作團隊集區使用者」。ROLE:授予使用者帳戶的 IAM 角色。
安裝用戶端程式庫
C#
如要進一步瞭解如何設定 C# 開發環境,請參閱 C# 開發環境設定指南。
install-package Google.Apis.Iam.v1 install-package Google.Apis.CloudResourceManager.v1
Go
go get golang.org/x/oauth2/google go get google.golang.org/api/cloudresourcemanager/v1
Java
如要進一步瞭解如何設定 Java 開發環境,請參閱 Java 開發環境設定指南。
如果您使用 Maven,請將下列指令新增到pom.xml 檔案中:
Python
如要進一步瞭解如何設定 Python 開發環境,請參閱「Python 開發環境設定指南」。
pip install --upgrade google-api-python-client google-auth google-auth-httplib2
讀取、修改及寫入允許政策
本快速入門導覽課程中的程式碼片段會執行下列操作:
- 初始化 Resource Manager 服務,該服務可管理 Cloud de Confiance專案。
- 讀取專案的允許政策。
- 修改允許政策,將記錄檔寫入者角色 (
roles/logging.logWriter) 授予您的 Google 帳戶。 - 寫入更新後的允許政策。
- 顯示具備專案層級記錄檔寫入者角色 (
roles/logging.logWriter) 的所有主體。 - 撤銷記錄檔寫入者角色。
執行程式碼片段前,請先替換下列值:
your-project:專案 ID。your-member:使用者帳戶的電子郵件地址。例如:principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com。
C#
如要瞭解如何安裝及使用 Resource Manager 的用戶端程式庫,請參閱「Resource Manager 用戶端程式庫」。詳情請參閱 Resource Manager C# API 參考文件。
如要向 Resource Manager 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Go
如要瞭解如何安裝及使用 Resource Manager 的用戶端程式庫,請參閱「Resource Manager 用戶端程式庫」。詳情請參閱 Resource Manager Go API 參考文件。
如要向 Resource Manager 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Java
如要瞭解如何安裝及使用 Resource Manager 的用戶端程式庫,請參閱「Resource Manager 用戶端程式庫」。詳情請參閱 Resource Manager Java API 參考文件。
如要向 Resource Manager 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Python
如要瞭解如何安裝及使用 Resource Manager 的用戶端程式庫,請參閱「Resource Manager 用戶端程式庫」。詳情請參閱 Resource Manager Python API 參考文件。
如要向 Resource Manager 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
恭喜!您已使用 Resource Manager API 中的 IAM 方法,修改專案的存取權。
還順利嗎?
清除所用資源
-
選用:撤銷您建立的驗證憑證,並刪除本機憑證檔案。
gcloud auth application-default revoke
-
選用:從 gcloud CLI 撤銷憑證。
gcloud auth revoke
後續步驟
- 請參閱身分與存取權管理的運作方式。
- 進一步瞭解如何授予、變更及撤銷存取權。
- 使用政策疑難排解工具排解存取權問題。