REST Resource: users.settings.cse.keypairs

資源：CseKeyPair

用戶端加密 S/MIME 金鑰組，由公開金鑰、憑證鏈結和配對私密金鑰的中繼資料組成。Gmail 會使用金鑰組完成以下工作：

  • 簽署用戶端加密郵件。
  • 儲存及重新開啟用戶端加密郵件的草稿。
  • 儲存並重新開啟已傳送的郵件。
  • 將內送或已封存的 S/MIME 郵件解密。
JSON 表示法 
{
  "keyPairId": string,
  "pkcs7": string,
  "pem": string,
  "subjectEmailAddresses": [
    string
  ],
  "enablementState": enum (EnablementState),
  "disableTime": string,
  "privateKeyMetadata": [
    {
      object (CsePrivateKeyMetadata)
    }
  ]
}
欄位
keyPairId

string

僅供輸出。用戶端加密 S/MIME 金鑰組的不可變更 ID。
pkcs7

string

僅限輸入。公開金鑰及其憑證鏈結。鏈結必須採用 PKCS#7 格式，並採用 PEM 編碼和 ASCII 臂。
pem

string

僅供輸出。公開金鑰及其憑證鏈結，採用 PEM 格式。
subjectEmailAddresses[]

string

僅供輸出。在分葉憑證上指定的電子郵件地址身分。
enablementState

enum (EnablementState)

僅供輸出。金鑰組目前的狀態。
disableTime

string (Timestamp format)

僅供輸出。如果金鑰組設為 DISABLED，代表金鑰組的狀態從 ENABLED 變更為 DISABLED 的時間。只有在金鑰組處於 DISABLED 狀態時，才會出現此欄位。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
privateKeyMetadata[]

object (CsePrivateKeyMetadata)

這個金鑰組私密金鑰的執行個體中繼資料。

EnablementState

金鑰組目前狀態的列舉。

列舉
stateUnspecified 未設定金鑰組的目前狀態。金鑰組並未開啟或關閉。
enabled

金鑰組已開啟。Gmail 會對這組金鑰加密的所有電子郵件進行解密，並使用私密金鑰簽署所有外寄郵件。

如要啟用金鑰組，請使用 keypairs.enable 方法。
disabled

金鑰組已關閉。通過驗證的使用者無法解密電子郵件，也無法簽署外寄郵件。如果金鑰組關閉超過 30 天，可以永久刪除。

如要關閉金鑰組，請使用 keypairs.disable 方法。

CsePrivateKeyMetadata

私密金鑰執行個體的中繼資料。

JSON 表示法 
{
  "privateKeyMetadataId": string,

  // Union field metadata_variant can be only one of the following:
  "kaclsKeyMetadata": {
    object (KaclsKeyMetadata)
  },
  "hardwareKeyMetadata": {
    object (HardwareKeyMetadata)
  }
  // End of list of possible types for union field metadata_variant.
}
欄位
privateKeyMetadataId

string

僅供輸出。私密金鑰中繼資料執行個體的不可變更 ID。
聯集欄位 metadata_variant。聯集欄位：必須簡述下列其中一種中繼資料變數類型。metadata_variant 只能是下列其中一項：
kaclsKeyMetadata

object (KaclsKeyMetadata)

由外部金鑰存取控制清單服務代管的私密金鑰執行個體中繼資料。
hardwareKeyMetadata

object (HardwareKeyMetadata)

硬體金鑰的中繼資料。

KaclsKeyMetadata

由外部金鑰存取控制清單服務管理的私密金鑰中繼資料。如要進一步瞭解如何管理金鑰存取權，請參閱「Google Workspace CSE API 參考資料」。

JSON 表示法 
{
  "kaclsUri": string,
  "kaclsData": string
}
欄位
kaclsUri

string

管理私密金鑰的金鑰存取控制清單 (ACL) 服務 URI。
kaclsData

string

金鑰存取控制清單服務產生及使用的不透明資料，大小上限：8 KiB。

HardwareKeyMetadata

硬體金鑰的中繼資料。

JSON 表示法 
{
  "description": string
}
欄位
description

string

硬體金鑰的說明。

方法

create

 為已驗證使用者建立及上傳用戶端加密 S/MIME 公開金鑰憑證鏈結和私密金鑰中繼資料。

disable

 停用用戶端加密金鑰組合。

enable

 開啟已停用的用戶端加密金鑰組合。

get

 擷取現有的用戶端加密金鑰組合。

list

 列出已驗證使用者的用戶端加密金鑰組合。

obliterate

 這會立即永久刪除用戶端加密金鑰組合。