GCP 雲端資源的權限管理服務是 IAM，其全稱為 Identity and Access Management，可讓管理員(Administrator)去授權(authorize)一個 Identity，使它可以 action 操作特定的 Resources。對應到其他的雲端服務是 :

  • Amazon Web Services (AWS) : AWS Identity and Access Managemen
  • Microsoft Azure : Microsoft Entra ID (舊稱 Azure Active Directory)

簡單從英文上來說 IAM 是做什麼的 : 「manage who can do what on which resources」，此概念會貫穿整個 IAM 的使用，用於保護 GCP 資源不受未經授權的存取，提供了非常細粒度的控制，可根據具體需求定制安全性策略。

IAM 的工作原理

透過 IAM 來定義 :

「誰(Principal)」對「哪個資源(Resource)」具有什麼「訪問許可權(Role)」

其中最簡單直觀可以了解的，大概就是 Resource 是什麼 :

  • 例如說 Compute Engine、GKE、Cloud Storage 這些我們熟知的 GCP 服務
  • 甚至比較抽象的 Organization、Folder、Project

以上這些都可以定義為資源 Resource 。接下來用下圖來說明 Role 和 Principal :

Role

在開始 Role 介紹之前先提一下 Permission ，它是決定「對 Resource 來說哪些操作是允許執行的」，在 GCP IAM 中的 Permission 形式格式表示為 :

<service>.<resource>.<verb>

實際舉幾個 Permission 例子如 pubsub.subscriptions.consume、storage.buckets.create 等等。現在大概知道 Permission 的樣子了，那 Role 是什麼呢？

「 Role 是 Permissions 的集合 」

從官方文件的介紹知道 Role 的形式格式表示為 :

roles/<service>.<roleName>

例如說 GCP 已經有一個定義 Role 名稱叫 Compute Instance Admin，從 API 呈現是 roles/compute.instanceAdmin ，並且其擁有的 Permissions 從官網上查尋到如下圖 :

上圖 Compute Instance Admin 其還有很多 Permissions 但因為圖片大小而沒有辦法列出來，基本上要做到最小權限原則是要花時間精力的，只能花時間去看每個 Role 。

Role 可當成是用來管理許多 Permissions 的載體，因為 GCP 上面 Permissions 大概近萬個，為了管理這些權限 GCP 已經有先幫把一些 Permissions 組合成一些常見的 Role 來描述了：

  • Basic roles

    有 Owner、Editor、Viewer、Browser，因為這些 Role 太廣義，故不建議在 production 上

  • Predefined roles

    像上述 Compute Instance Admin 就是一個範例，比 Basic Role 更精細，為特定服務提供 granular access ，這些 Role 會由 Google 來創建及維護，當有新的服務或功能加入時，這些 Role 的權限也會跟著擴充

  • Custom role:

    也可以選擇來完全自己客製化 Role ，自己取名稱以及加上適用的 Permissions

「Access」 和「Permission」也十分相像，個人自己看完文件後，我個人的理解是:

  • Permission 比較是指「對某個資源的一個具體的操作」如讀取、寫入或刪除，是比較官方且具體的說法，文件中也有對 Permission 的定義
  • Access 比較是指「對資源進行操作的能力」，並沒有特別指說是哪種特定的動作，相比 Permission 來說比較抽象描述，通常只是夾雜在句子的描述用詞

Principal

首先來看官網的簡單介紹，會知道每個 Principal 都有一個 identifier 唯一標示碼，然後:

「 Principal 代表是有能力 access 資源的 Identity 」

故看起來: Principal = Identity + Role。 Principal 也可以詳細稱為 「Authenticated principal」; 另外官網中其實也有說在過去 Principal 的舊稱是 member，這個稱呼在一些 API 上也還是有沿用(例如 Terraform)。實際上 Resource 的 Permission 並不會直接給 Principal，而是先把 Permissions 集中起來成一個 Role，再來 granted Role 給 Principal。

Principal 有很多不同的類型，舉簡單常見的例如 :

  • Google Account

    Google Account 基本可代表成 End-User 終端用戶，可以是 developer 或者 administrator，是使用 Google Account signup page 註冊的帳戶，其會有像是 gmail.com代表個人的 email address 或者是公司行號的 XXX@acompany.com 等等作為 identifier

  • Service Account

    Service Account 代表了非人類的使用者，是給 Application 使用的 Identity 。例如說有一段程式運行在 GCP 環境內且會呼叫其他 GCP 雲端服務，那會需要給那段程式一個 Identity ，這就會是其用 Service Account

雖然 「Google Account」 和 「Service Account」 是兩個最常見的 Principal，但其他還有像是 :

  • Google group 是 「 Google Accounts 和 Service Accounts 的集合」，會有一個代表 Group 的 unique email，其可在 GCP IAM 上設定，需要 organization 層級的權限

  • Google Workspace account 通常會代表一個公司組織的 internet domain name，例如說公司有申請 domain name 叫做 mysupercompany.com，那當創建 Google Account 是 username@mysupercompany.com的話，就會自動加入 Workspace 來管理

  • allAuthenticatedUsers & allUsers : 這兩個都是特別的 Principal 類型，例如在 Terraform 內設定 iam-binding 會看到

Policy

當我們有 Role 以後，要如何將它授權給 Principal 呢？ 這就需要使用 IAM Policy ，它是定義「哪些角色 Role(s)要 granted 給哪些 Principal(s)」，當 Principal 嘗試訪問某個 Resource 時，IAM 會檢查該資源的 IAM Policy 以確定 Principal 是否允許該操作。

Policy 除了常見的 Allow policy ，其實也有 Deny policy，目前先介紹 Allow policy

例如在 GCP IAM 的 Console 畫面:

當我們把某些 XXX@gmail.com、YYY@gmail.com 輸入到 Principal 格子內，然後再加上各種 Roles 然後按下創建，這就是一個 IAM Policy Binding 的過程。

會發現上圖中的 UI 邏輯算是把 Principal 和 Identity 當成一樣的事情了，所以個人自己看完文件後，我個人的理解是:

  • Principal(主體) : 是指一個擁有 Role 的實體，也是比較官方且具體的說法，文件中也有對其的詳細定義
  • Identity(身份) : 相比 Principal 來說也比較抽象描述，通常只是夾雜在句子的描述用詞，某些情況下可把 Identity 等同於 Principal

另外 Google Cloud Resources 有層次結構的例如:

organization >> Folders >> Project >> Resource

我們可以在資源層次中的任何 level 設定 Policy，子層級會繼承其所有父層級的 Policy。

Consistency model for the IAM API

IAM API 是 eventually consistent，所以如果更改 IAM ，然後立即讀取該 IAM，讀取操作可能會返回舊版本的資了，故可能需要一些時間等待更改生效。

Practice

如果有一個 GCP project owner 想把管理 Cloud Storage buckets 和 files 的權限 delegate 委託給同事 colleague 。若要依照 Google-recommended practices 來做的話，應該給 colleague 授予哪些 IAM Role ?

  • A. Project Editor
  • B. Storage Admin (O)
  • C. Storage Object Admin
  • D. Storage Object Creator

Project Editor 會有幾乎所有 GCP Resource 的編輯權限，賦予的權限太大，違反了最小權限原則。 Storage Admin 角色是針對 Cloud Storage 的最廣泛的 Role ，可以存取 buckets 和其內部的 objs 內容，這是正確答案 ; Storage Object Admin 就只有 obj 的權限，如果需要的是對 buckets 及其內容的全面管理，這個角色的權限不夠。

Practice

有一個已定義好 IAM Role 的 dev-project，若要創建一個 prod-project 並在此 prod-project 中擁有相同的 IAM Role，怎麼做最快速？

有 gcloud iam roles copy 可以使用，舉例如 :

gcloud iam roles copy --source="roles/myCustomAdmin" --destination=myCustomAdmin --dest-project=prod-project

參考資料