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

출력 전용. 리프 인증서에 지정된 이메일 주소 ID입니다.
enablementState

enum (EnablementState)

출력 전용. 키 쌍의 현재 상태입니다.
disableTime

string (Timestamp format)

출력 전용. 키 쌍이 DISABLED로 설정된 경우 키 쌍의 상태가 ENABLED에서 DISABLED로 변경된 시간입니다. 이 필드는 키 쌍이 DISABLED 상태인 경우에만 존재합니다.

RFC3339 UTC '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)
  }
  // End of list of possible types for union field metadata_variant.
}
필드
privateKeyMetadataId

string

출력 전용. 비공개 키 메타데이터 인스턴스의 변경 불가능한 ID입니다.
통합 필드 metadata_variant는 공용체 필드: 다음 메타데이터 변형 유형 중 정확히 하나만 있어야 합니다. metadata_variant은 다음 중 하나여야 합니다.
kaclsKeyMetadata

object (KaclsKeyMetadata)

외부 키 액세스 제어 목록 서비스에서 관리하는 비공개 키 인스턴스의 메타데이터입니다.

KaclsKeyMetadata

외부 키 액세스 제어 목록 서비스에서 관리하는 비공개 키의 메타데이터입니다. 키 액세스 관리에 대한 자세한 내용은 Google Workspace CSE API 참조를 확인하세요.

JSON 표현 
{
  "kaclsUri": string,
  "kaclsData": string
}
필드
kaclsUri

string

비공개 키를 관리하는 키 액세스 제어 목록 서비스의 URI입니다.
kaclsData

string

키 액세스 제어 목록 서비스에서 생성하고 사용하는 불투명한 데이터입니다. 최대 크기: 8KiB

방법

create

 인증된 사용자의 클라이언트 측 암호화 S/MIME 공개 키 인증서 체인과 비공개 키 메타데이터를 만들고 업로드합니다.

disable

 클라이언트 측 암호화 키 쌍을 사용 중지합니다.

enable

 사용 중지된 클라이언트 측 암호화 키 쌍을 사용 설정합니다.

get

 기존 클라이언트 측 암호화 키 쌍을 검색합니다.

list

 인증된 사용자의 클라이언트 측 암호화 키 쌍을 나열합니다.

obliterate

 클라이언트 측 암호화 키 쌍을 영구적으로 영구적으로 삭제합니다.