權杖類型

Cloud de Confiance by S3NS 使用多種權杖進行驗證。您可以根據這些權杖的用途和交換對象,將其分類。

權杖類別 通訊路徑 目的
存取權杖 授權伺服器 ⭢ 用戶端 ⭢ Google API 允許用戶端呼叫 Cloud de Confiance by S3NS API。
授予權杖的權杖 授權伺服器 ⭤ 用戶端 讓用戶端取得新的或不同的權杖,可能在稍後的時間點。
身分識別權杖 授權伺服器 ⭢ 用戶端 讓用戶端識別互動對象。

大多數存取權杖和身分權杖都是不記名權杖。不記名權杖會將存取權授予持有權杖的一方,無論對方如何取得權杖。如果惡意人士攔截不記名權杖,就能用來取得未經授權的存取權。

繫結權杖會授予特定用戶端的存取權。如要使用繫結權杖,用戶端必須提供額外證明,證明自己是權杖的合法擁有者。因此,繫結權杖比不記名權杖更具限制性,有助於降低權杖遭竊的風險。

存取權杖

用戶端可使用存取權杖,對 Cloud de Confiance by S3NS API 發出經過驗證的呼叫。Cloud de Confiance by S3NS 支援多種不同類型的存取權杖,這些權杖具有下列共同屬性:

  • 驗證主體 (使用者或工作負載)。

  • 只會核發給特定客戶。

  • 這類權杖的效期很短,最多幾小時後就會失效。

  • 僅限特定 OAuth 範圍、端點或資源。這表示存取權杖通常不會授予使用者所有資源的存取權,而只會授予特定部分資源的存取權。

存取權杖可能會有下列差異:

  • Issuer:核發權杖的一方。

  • 主體:權杖可驗證的主體類型。

  • Restrictions:可對權杖施加的限制。

下表列出不同類型的存取權杖:

權杖類型 核發單位 主體 限制
服務帳戶存取權杖 Cloud de Confiance by S3NS IAM 授權伺服器 服務帳戶 個 OAuth 範圍
服務帳戶 JSON Web Token (JWT) 客戶 服務帳戶 OAuth 範圍或 API
聯合存取權杖 Cloud de Confiance by S3NS IAM 授權伺服器
  • 員工身分集區主體
  • workload identity pool 主體
個 OAuth 範圍
代理身分存取權杖 Cloud de Confiance by S3NS IAM 授權伺服器 代理身分主體 個 OAuth 範圍
憑證存取權邊界權杖 Cloud de Confiance by S3NS IAM 授權伺服器
  • 使用者 (受管理使用者)
  • 使用者 (消費者帳戶)
  • 服務帳戶
特定 Cloud Storage 物件
用戶端核發的憑證存取邊界權杖 客戶 服務帳戶 特定 Cloud Storage 物件

不同類型的存取權杖也具有不同的安全性屬性:

  • 格式:部分存取權杖是不透明的,也就是採用專屬格式,無法檢查。其他權杖則編碼為 JSON Web Token,可由用戶端解碼。
  • 生命週期:權杖的生命週期和可修改程度各有不同。
  • 可撤銷性:部分權杖可以撤銷。其他權杖在到期前仍有效。
  • 繫結:部分權杖可選擇繫結至額外憑證,成為「繫結權杖」。

下表摘要說明存取權杖類型之間的差異。

權杖類型 格式 可自我檢查 效期 可撤銷 繫結
服務帳戶存取權杖 Opaque 否 5 分鐘到 12 小時 否
服務帳戶 JSON Web Token (JWT) JWT 不適用 5 分鐘至 1 小時 否
聯合存取權杖 Opaque 否 請參閱「聯合存取權杖」 否
代理身分存取權杖 Opaque 否 請參閱「代理身分存取權杖」 否 X.509 用戶端憑證
憑證存取邊界權杖 Opaque 否 請參閱「憑證存取權邊界權杖」 否
用戶端核發的憑證存取邊界權杖 Opaque 否 不適用 否

服務帳戶存取權杖

服務帳戶存取權杖是不記名權杖,用於驗證服務帳戶。權杖是不透明的進行檢查。

如果是服務帳戶存取權杖,API 傳回的輸出內容會類似於以下範例:

{
  "azp": "000000000000000000000",
  "aud": "000000000000000000000",
  "scope": "https://www.googleapis.com/auth/userinfo.email",
  "exp": "1744687132",
  "expires_in": "3568",
  "email": "service-account@example.s3ns.iam.gserviceaccount.com",
  "email_verified": "true",
  "access_type": "online"
}

服務帳戶權杖包含下列欄位:

欄位 名稱 說明
aud 目標對象 權杖所屬的服務帳戶,等同於授權方。
azp 授權方 要求權杖的服務帳戶,以專屬 ID 識別。
email 主要電子郵件地址

服務帳戶的電子郵件地址。

只有在權杖包含 https://www.googleapis.com/auth/userinfo.email 範圍時,才會顯示這個欄位。

exp 期限 權杖的到期時間,採用 Unix 紀元時間格式。

服務帳戶存取權杖無法撤銷,在到期前都有效。

根據預設,服務帳戶存取權杖會在 1 小時後過期。使用 serviceAccounts.generateAccessToken 方法,即可要求不同生命週期的權杖。由於權杖生命週期越長,風險就越高,因此您必須設定 iam.allowServiceAccountCredentialLifetimeExtension 限制,允許用戶端要求生命週期超過一小時的服務帳戶存取權杖。

服務帳戶 JSON Web Token

服務帳戶 JSON Web Token (JWT) 是驗證服務帳戶的不記名權杖。服務帳戶存取權杖是由授權伺服器核發,而服務帳戶 JWT 則可由用戶端自行核發。

有時稱為「自行簽署」JWT。如果您需要向某些 Google API 進行驗證,但不想從授權伺服器取得存取權杖,例如建立自己的用戶端程式庫時,API 金鑰就非常實用。

如要核發服務帳戶 JWT,用戶端必須執行下列步驟:

  1. 準備 JSON 網路簽章酬載,其中包含服務帳戶的電子郵件地址、OAuth 範圍或 API 端點,以及到期時間。

  2. 使用各個服務帳戶的服務帳戶金鑰簽署酬載。用戶端可以使用使用者自行管理的服務帳戶金鑰,在離線狀態下簽署酬載,或使用 signJwt 方法和 Google 代管的服務帳戶金鑰,在線上簽署酬載。詳情請參閱「建立自行簽署的 JSON Web Token」。

解碼後的服務帳戶 JWT 如下所示,其中 SIGNATURE 會替換為權杖的簽章:

{
  "alg": "RS256",
  "kid": "290b7bf588eee0c35d02bf1164f4336229373300",
  "typ": "JWT"
}.{
  "iss": "service-account@example.s3ns.iam.gserviceaccount.com",
  "sub": "service-account@example.s3ns.iam.gserviceaccount.com",
  "scope": "https://www.googleapis.com/auth/cloud-platform",
  "exp": 1744851267,
  "iat": 1744850967
}.SIGNATURE

服務帳戶 JWT 可以在 aud 金鑰中指定 API 端點,而不是在 scope 金鑰中指定 OAuth 範圍:

{
  "alg": "RS256",
  "kid": "290b7bf588eee0c35d02bf1164f4336229373300",
  "typ": "JWT"
}.{
  "iss": "service-account@example.s3ns.iam.gserviceaccount.com",
  "sub": "service-account@example.s3ns.iam.gserviceaccount.com",
  "aud": "https://cloudresourcemanager.s3nsapis.fr/",
  "exp": 1744854799,
  "iat": 1744851199
}.SIGNATURE

服務帳戶 JWT 包含下列欄位:

欄位 名稱 說明
aud 目標對象 用戶端可存取的 API 端點。只有在未指定 scope 時才有效。
exp 期限 權杖的到期時間,採用 Unix 紀元時間格式。
iat 問題時間 權杖的核發時間,採用 Unix 紀元時間格式。
iss 核發單位 權杖的核發者,也就是服務帳戶本身。
scope 個 OAuth 範圍 用戶端可存取的 API 組合,由 OAuth 範圍識別。只有在未指定 aud 時才有效。
sub 主旨 已驗證的主體,即服務帳戶本身。

服務帳戶 JWT 的有效期限最長為一小時,且無法撤銷。

聯合存取權杖

聯合存取權杖是不記名權杖,可驗證身分工作團隊集區主體或 workload identity pool 主體。

員工身分聯盟可讓用戶端將外部權杖,換成驗證員工集區主體的聯合存取權杖。員工身分集區主體會以類似下列的主體 ID 識別:

principal://iam.googleapis.com/locations/global/workforcePools/POOL/subject/raha@altostrat.com.

用戶端可透過 Workload Identity Federation,將外部權杖換成聯合存取權杖,用於驗證工作負載集區主體。workload identity pool 主體會以類似下列的主體 ID 識別:

principal://iam.googleapis.com/projects/PROJECT/locations/global/workloadIdentityPools/POOL/subject/SUBJECT_ATTRIBUTE_VALUE

聯合存取權杖不透明,無法進行內省。權杖無法撤銷,且在到期前仍有效。各類權杖的到期時間設定如下:

  • 員工身分聯盟會將權杖到期時間設為下列兩個值中較小的一個:

    • 員工身分聯盟工作階段到期前的剩餘時間

    • 1 小時

    員工身分聯盟工作階段的到期時間,取決於登入時間和員工身分聯盟集區設定的工作階段持續時間。

  • Workload Identity Federation 會設定權杖到期時間,使其與外部權杖的到期時間一致。

代理身分存取權杖

代理身分存取權杖會驗證已獲派代理身分的代理,並使用類似下列的主體 ID:

principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/us-central1/reasoningEngines/REASONING_ENGINE_ID

主體 ID 是根據代理程式 X.509 用戶端憑證的 SPIFFE ID 產生,但使用前置字串 principal://,而非 spiffe://。

代理可以從 Compute Engine 中繼資料伺服器取得代理身分存取權杖。代理程式可以選擇要求將權杖繫結至其 X.509 用戶端憑證。繫結代理程式身分存取權杖只有在透過相互 TLS 連線使用時才有效,該連線會使用權杖繫結的 X.509 用戶端憑證進行驗證。

與聯合存取權杖一樣,代理身分存取權杖是不透明的,無法檢查或撤銷,且在到期前都有效。根據預設,代理身分存取權杖的有效期限為 1 小時,但如果權杖繫結至即將到期的 X.509 用戶端憑證,有效期限可能會縮短。

憑證存取邊界權杖

憑證存取權邊界權杖是不記名權杖,可驗證使用者或服務帳戶,並包含存取權邊界。存取權邊界會限制權杖,使其只能用於存取 Cloud Storage 資源的定義子集。

憑證存取邊界權杖有時稱為「範圍縮減」,因為這類權杖衍生自輸入權杖,但授予存取權的資源更受限制。

憑證存取權邊界權杖的到期時間取決於輸入權杖的到期時間, 是 服務帳戶存取權杖。憑證存取權邊界權杖是不透明的,無法檢查或撤銷。

用戶端核發的憑證存取邊界權杖

用戶端核發的憑證存取邊界權杖與憑證存取邊界權杖類似,但經過最佳化,適用於用戶端需要頻繁取得具有不同存取邊界的憑證存取邊界權杖的情境。

用戶端可以使用 Cloud 用戶端程式庫和存取邊界中介權杖,在本機建立用戶端核發的憑證存取邊界權杖,並定期更新。

用戶端核發的憑證存取邊界權杖不透明,無法檢查或撤銷。

權杖授予權杖

用戶端可透過權杖授予權杖取得新的或不同的權杖,可能是在稍後取得。 Cloud de Confiance by S3NS 支援多種不同類型的權杖授予權杖,這些權杖都有以下共通點:

  • 代表先前驗證。

  • 這些權杖會驗證主體,主體可以是 Google Identity (使用者或工作負載) 或外部身分。

  • 可用來兌換存取權杖。

  • 這類權杖與存取權杖不同,無法用於發出 Google API 呼叫。

權杖授予權杖的差異如下:

  • Issuer:核發權杖的一方。

  • 主體:權杖可驗證的主體身分類型。

  • Restrictions:可對權杖施加的限制。

下表列出不同類型的權杖授予權杖。

權杖類型 核發單位 已兌換的存取權杖類型 主體 限制
聯合更新權杖 Cloud de Confiance by S3NS IAM 授權伺服器 聯合存取權杖 員工身分集區主體 個 OAuth 範圍
聯合授權碼 Cloud de Confiance by S3NS IAM 授權伺服器 聯合存取權杖 員工身分集區主體 個 OAuth 範圍
外部 JSON Web Token 外部身分識別提供者 聯合存取權杖 外部主體 無
外部 SAML 宣告或回應 外部身分識別提供者 聯合存取權杖 外部主體 無
Amazon Web Services (AWS) GetCallerIdentity 權杖 外部身分識別提供者 聯合存取權杖 外部主體 無

不同類型的權杖授予權杖也具有不同的安全性屬性:

  • 格式:部分權杖不透明。其他權杖可由用戶端解碼。

  • 生命週期:權杖的生命週期和可修改程度不盡相同。

  • 多重用途:部分權杖授予權杖只能使用一次。其他權杖則可多次使用。

  • 可撤銷性:部分權杖可以撤銷。其他權杖在到期前仍有效。

  • 繫結:部分權杖會繫結至額外憑證,成為「繫結權杖」。其他權杖則未繫結,因此屬於不記名權杖。

下表摘要說明權杖授予權杖的這些屬性差異:

權杖類型 格式 效期 可撤銷 多次使用 繫結
聯合更新權杖 Opaque 不一定,請參閱聯合更新權杖 否 是 OAuth 用戶端憑證
聯合授權碼 Opaque 10 分鐘 否 否 OAuth 用戶端憑證
外部權杖或外部 JSON Web Token JWT 視識別資訊提供者而定 視識別資訊提供者而定 是
外部 SAML 斷言或回應 SAML 視識別資訊提供者而定 視識別資訊提供者而定 是
Amazon Web Services (AWS) GetCallerIdentity 權杖 文字 blob 視識別資訊提供者而定 視識別資訊提供者而定 是

聯合更新權杖

聯合更新權杖是不透明的權杖,如果使用者先前已授權用戶端代表他們執行操作,用戶端就能取得員工身分集區主體的存取權杖。

與更新權杖一樣,聯合更新權杖會繫結至特定用戶端,且只能與有效的用戶端憑證搭配使用,例如用戶端 ID 和用戶端密鑰。

與更新權杖不同,聯合更新權杖無法撤銷。聯合更新權杖的生命週期與用於取得權杖的員工身分工作階段連結,在工作階段到期前都有效。

聯合授權碼

與授權碼一樣,聯合授權碼是不透明的短期權杖。授權碼僅用於使用者驗證,做為 用戶端與 Cloud de Confiance by S3NS IAM 授權伺服器之間的中介。

授權碼會與用戶端繫結,只能與有效的用戶端憑證搭配使用,且只能使用一次。

外部 JSON Web Token

外部 JSON Web Token (JWT) 是由外部身分提供者核發,例如 Microsoft Entra ID、Okta、Kubernetes 或 GitHub。結構和內容可能有所不同。

設定員工身分聯盟或 Workload Identity Federation,即可在 Cloud de Confiance by S3NS 和外部身分提供者之間建立信任關係。工作負載接著可以使用外部 JWT 做為權杖授予權杖,取得聯合存取權杖。

使用員工身分聯盟時,產生的聯合存取權杖會驗證員工身分集區主體。

使用 Workload Identity Federation 時,產生的聯合存取權杖會驗證工作負載身分集區主體。

在這兩種情況下,主體 ID 都是從外部 JWT 的一或多個宣告衍生而來。

外部 JWT 必須符合特定規定,才能與員工身分聯盟或 Workload Identity Federation 相容。

外部 SAML 斷言或回應

外部安全宣告標記語言 (SAML) 宣告是由外部識別資訊提供者 (例如 Microsoft Entra ID、Okta 或 Active Directory Federation Services) 發出的 SAML 2.0 宣告。這些外部 SAML 宣告可選擇包含在 SAML 2.0 回應中,或經過加密。

與外部 JSON Web Token 類似,您可以設定員工身分聯盟或 Workload Identity Federation,讓工作負載使用外部 SAML 斷言或回應做為權杖授予權杖,以取得聯合存取權杖。

外部 SAML 斷言必須符合特定規定,才能與員工身分聯盟或 Workload Identity Federation 相容。

Amazon Web Services (AWS) GetCallerIdentity 權杖

外部 AWS GetCallerIdentity 權杖是文字 blob,其中包含對 AWS GetCallerIdentity API 的已簽署要求。與外部 JSON Web Token類似,您可以設定員工身分聯盟或 Workload Identity Federation,讓工作負載將這些文字 blob 做為權杖授予權杖,以取得聯合存取權杖。

身分識別權杖

用戶端可透過身分 (ID) 權杖,識別互動對象。 Cloud de Confiance by S3NS 支援多種不同類型的身分權杖,這些權杖有以下共通點:

身分權杖可能會有下列差異:

  • 目標對象:預期解碼及使用權杖的一方。

  • Issuer:核發權杖的一方。

  • 主體:權杖可驗證的主體身分類型。

下表列出不同類型的身分權杖。

權杖類型 核發單位 目標對象 主體
服務帳戶 ID 權杖 Cloud de Confiance by S3NS IAM 授權伺服器 可自由選擇任何目標對象 服務帳戶
代理身分 ID 權杖 Cloud de Confiance by S3NS IAM 授權伺服器 可自由選擇任何目標對象 代理身分
Identity-Aware Proxy (IAP) 斷言 IAP
  • 後端
  • App Engine 應用程式
  • 使用者 (受管理使用者)
  • 使用者 (消費者帳戶)
  • 員工身分集區主體

不同類型的身分權杖也具有不同的安全性屬性:

  • 格式:部分權杖是 JSON Web Token (JWT),其他權杖則使用 XML 格式。

  • 生命週期:權杖的生命週期不盡相同。

  • 繫結:部分權杖可選擇繫結至額外憑證,成為「繫結權杖」。

下表摘要說明身分權杖類型之間的差異。

權杖類型 格式 效期 繫結
服務帳戶 ID 權杖 JWT 1 小時
代理身分 ID 權杖 JWT 1 小時 X.509 用戶端憑證
Identity-Aware Proxy (IAP) 斷言 JWT 10 分鐘

服務帳戶 ID 權杖

服務帳戶 ID 權杖是 JSON Web Token (JWT),用於驗證服務帳戶。

與服務帳戶 JWT 和服務帳戶 JWT 聲明不同,服務帳戶 ID 權杖並非由服務帳戶金鑰簽署。而是由 Google JSON Web 金鑰組 (JWKS) 簽署。

解碼後的服務帳戶 ID 權杖如下所示,其中 SIGNATURE 會替換為權杖的簽章:

{
  "alg": "RS256",
  "kid": "c37da75c9fbe18c2ce9125b9aa1f300dcb31e8d9",
  "typ": "JWT"
}.{
  "aud": "example-audience",
  "azp": "112010400000000710080",
  "email": "service-account@example.s3ns.iam.gserviceaccount.com",
  "email_verified": true,
  "exp": 1745365618,
  "iat": 1745362018,
  "iss": "https://accounts.google.com",
  "sub": "112010400000000710080"
}.SIGNATURE

服務帳戶 ID 權杖包含下列欄位:

欄位 名稱 說明
aud 目標對象 這個權杖所屬參與方的 ID。權杖要求者可以自由選擇這個值。
azp 授權方 要求權杖的服務帳戶,以專屬 ID 識別。
exp 期限 權杖的到期時間,採用 Unix 紀元時間格式。
iss 核發單位 權杖的核發者,一律設為 https://accounts.google.com。
sub 主旨 要求權杖的服務帳戶,以專屬 ID 識別。

ID 權杖中包含的確切聲明組合,取決於要求 ID 權杖的方式。舉例來說,Compute Engine 中繼資料伺服器要求的 ID 權杖,可視需要加入額外聲明,斷言 VM 的身分。使用 IAM Credentials API 要求的 ID 權杖,可選擇包含服務帳戶專案的組織 ID。

服務帳戶 ID 權杖的有效期限為一小時,且無法撤銷。

代理身分 ID 權杖

代理身分 ID 權杖是 SPIFFE 可驗證身分文件 (JWT-SVID),用於驗證已指派代理身分的代理。

代理程式可以從 Compute Engine 中繼資料伺服器取得 ID 權杖。代理程式可以選擇要求將權杖繫結至其 X.509 用戶端憑證。繫結代理身分 ID 權杖包含 cnf 宣告中 X.509 用戶端憑證的指紋。

與使用者 ID 權杖和服務帳戶 ID 權杖不同,代理身分 ID 權杖並非由 Google JSON Web 金鑰組 (JWKS) 簽署。而是由代理身分集區專屬的 JWKS 簽署。

解碼後的代理身分 ID 權杖如下所示,其中 SIGNATURE 會替換為權杖的簽章:

{
  "alg": "RS256",
  "kid": "78ab40e4a0319f9ced58024f5bb66e6387d68066",
  "typ": "JWT"
}.{
  "iss": "https://sts.googleapis.com/v1/organizations/1234567890/locations/global/workloadIdentityPools/agents.global.org-1234567890.system.id.goog",
  "sub": "spiffe://agents.global.org-1234567890.system.id.goog/resources/aiplatform/projects/1234567890/locations/us-central1/reasoningEngines/987654321",
  "aud": ["https://example.com/"],
  "iat": 1775776191,
  "exp": 1775779791,
  "cnf": {
    "x5t#S256": "QTB5TSHeDxHrzDzcrrHU+/shhkfCnARcBEvMldp2uis"
  }
}.SIGNATURE

代理身分 ID 權杖包含下列欄位:

欄位 名稱 說明
aud 目標對象 這個權杖所屬參與方的 ID。這個值可由權杖要求者選擇。
exp 期限 權杖的到期時間,採用 Unix 紀元時間格式。
iss 核發單位 權杖的核發者,即包含代理的組織或專案的代理身分集區。
sub 主旨 代理的 SPIFFE ID。
cnf.x5t#S256 確認 權杖繫結的 X.509 用戶端憑證指紋。如果權杖未繫結,則這項憑證附加資訊會留空。

Identity-Aware Proxy 斷言

Identity-Aware Proxy (IAP) 宣告是 JSON Web Token (JWT),IAP 會在 x-goog-iap-jwt-assertion HTTP 要求標頭中,將這些權杖傳遞至受 IAP 保護的網頁應用程式。IAP 聲明會驗證使用者,並證明要求已獲得 IAP 授權。

IAP 聲明是使用 IAP JWKS 簽署。這個 JWKS 是全域資源,不同類型的使用者會使用相同的簽署金鑰,包括:

  • 受管理的使用者帳戶

  • 消費者帳戶

  • 服務帳戶

  • 員工身分集區主體

解碼後的 IAP 宣告如下所示,其中 SIGNATURE 會替換為權杖的簽章:

{
  "alg": "ES256",
  "typ": "JWT",
  "kid": "4BCyVw"
}.{
  "aud": "/projects/0000000000/global/backendServices/000000000000",
  "azp": "/projects/0000000000/global/backendServices/000000000000",
  "email": "user@example.com",
  "exp": 1745374290,
  "google": {
    "access_levels": [
      "accessPolicies/0000000000/accessLevels/Australia"
    ]
  },
  "iat": 1745373690,
  "identity_source": "WORKFORCE_IDENTITY",
  "iss": "https://cloud.google.com/iap",
  "sub": "sts.google.com:AAFTZ...Q",
  "workforce_identity": {
    "iam_principal": "principal://iam.googleapis.com/locations/global/workforcePools/example/subject/user-0000000000",
    "workforce_pool_name": "locations/global/workforcePools/example"
  }
}.SIGNATURE

IAP 斷言包含下列欄位:

欄位 名稱 說明
aud 目標對象 IAP 聲明適用的後端服務、App Engine 應用程式或 Cloud Run 服務。
iss 核發單位 權杖的核發者,一律設為 https://cloud.google.com/iap
sub 主旨

已驗證的主體,以專屬 ID 識別。

如果 IAP 已設為使用 Google Identity,這個 ID 就等同於 Directory API 中公開的 ID。

如要進一步瞭解 IAP 聲明,請參閱「驗證 JWT 酬載」。

IAP 斷言的有效期限為 10 分鐘,且無法撤銷。