授權權杖

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

為防止濫用,Key Access Control List Service (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