授權權杖

不記名權杖 (JWT：RFC 7516)，由 Google 核發，用於驗證呼叫者是否有權加密或解密資源。

為防止濫用，金鑰存取控制清單服務 (KACLS) 應先驗證呼叫端是否已獲授權加密物件 (檔案或文件)，再封裝金鑰；並先驗證呼叫端是否已獲授權解密物件，再解封裝 DEK。

Google 文件和雲端硬碟、日曆和 Meet 用戶端加密 (CSE) 的授權權杖

JSON 表示法 
{
  "aud": string,
  "delegated_to": string,
  "email": string,
  "email_type": string,
  "exp": string,
  "iat": string,
  "iss": string,
  "kacls_url": string,
  "perimeter_id": string,
  "resource_name": string,
  "role": string
}
欄位
aud

string

Google 識別出的目標對象。應根據本機設定檢查。
delegated_to

string

(選用) 獲授權存取資源的使用者電子郵件地址。
email

string (UTF-8)

使用者的電子郵件地址。
email_type

string

包含下列其中一個值：

  • google：這個電子郵件地址屬於 Google 帳戶。
  • google-visitor：這個電子郵件地址不屬於 Google 帳戶，但已通過 Google 的 PIN 碼驗證。
  • customer-idp：這個電子郵件地址不屬於 Google 帳戶，但系統是透過客戶設定的 IdP 擷取使用者的電子郵件地址。
  • 聲明可以不設定，在這種情況下，預設值為 `google`。
exp

string

到期時間。
iat

string

發卡時間。
iss

string

權杖核發者。應根據一組可信的驗證簽發者進行驗證。
kacls_url

string

設定的 KACLS 基礎網址，用於防範中間人 (PITM) 攻擊。
perimeter_id

string (UTF-8)

(選用) 與文件位置相關聯的值，可用於選擇在解除包裝時要檢查的周邊範圍。大小上限：128 個位元組。
resource_name

string (UTF-8)

由 DEK 加密的物件 ID。大小上限：128 個位元組。
role

string

包含下列其中一個值：

Gmail CSE 的授權權杖

JSON 表示法 
{
  "aud": string,
  "email": string,
  "exp": string,
  "iat": string,
  "message_id": string,
  "iss": string,
  "kacls_url": string,
  "perimeter_id": string,
  "resource_name": string,
  "role": string,
  "spki_hash": string,
  "spki_hash_algorithm": string
}
欄位
aud

string

Google 識別出的目標對象。應根據本機設定檢查。
email

string (UTF-8)

使用者的電子郵件地址。
exp

string

到期時間。
iat

string

發卡時間。
message_id

string

要執行解密或簽署作業的訊息 ID。用於稽核用途的客戶原因。
iss

string

權杖核發者。應根據一組可信的驗證簽發者進行驗證。
kacls_url

string

設定的 KACLS 基礎網址，用於防範中間人 (PITM) 攻擊。
perimeter_id

string (UTF-8)

(選用) 與文件位置相關聯的值，可用於選擇解包時要檢查的周邊範圍。大小上限：128 個位元組。
resource_name

string (UTF-8)

由 DEK 加密的物件 ID。大小上限：512 個位元組。
role

string

包含下列其中一個值：

  • decrypter：可以解密。
  • signer：可以簽署。
spki_hash

string

以標準 Base64 編碼的摘要，該摘要是存取私密金鑰的 DER 編碼 SubjectPublicKeyInfo。
spki_hash_algorithm

string

用於產生 spki_hash 的演算法。可以是 SHA-256。

KACLS 遷移服務的授權權杖

JSON 表示法 
{
  "aud": string,
  "email": string,
  "exp": string,
  "iat": string,
  "iss": string,
  "kacls_url": string,
  "resource_name": string,
  "role": string
}
欄位
aud

string

Google 識別出的目標對象。應根據本機設定檢查。
email

string (UTF-8)

使用者的電子郵件地址。
exp

string

到期時間。
iat

string

發卡時間。
iss

string

權杖核發者。應根據一組可信的驗證簽發者進行驗證。
kacls_url

string

設定的 KACLS 基礎網址，用於防範中間人 (PITM) 攻擊。
role

string

包含下列其中一個值：

  • migrator：只能撥打 rewrap。
  • verifier：只能撥打 digest。