เมธอด: Privatekeydecrypt

คลายคีย์ส่วนตัวที่ปกปิดไว้ แล้วถอดรหัสคีย์การเข้ารหัสเนื้อหาที่เข้ารหัสเป็นคีย์สาธารณะ

คำขอ HTTP

POST https://BASE_URL/privatekeydecrypt

ให้แทนที่ BASE_URL ด้วย URL พื้นฐาน

พารามิเตอร์เส้นทาง

ไม่มี

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "authentication": string,
  "authorization": string,
  "algorithm": string,
  "encrypted_data_encryption_key": string,
  "rsa_oaep_label": string,
  "reason": string,
  "wrapped_private_key": string
}
ช่อง
authentication

string

JWT ที่ออกโดยผู้ให้บริการข้อมูลประจำตัว (IdP) ที่ยืนยันว่าผู้ใช้เป็นใคร ดูโทเค็นการตรวจสอบสิทธิ์
authorization

string

JWT ที่ยืนยันว่าผู้ใช้ได้รับอนุญาตให้แยกคีย์ของ resource_name ดูโทเค็นการให้สิทธิ์
algorithm

string

อัลกอริทึมที่ใช้ในการเข้ารหัสคีย์การเข้ารหัสข้อมูล (DEK) ในการเข้ารหัสเอนเวโลป
encrypted_data_encryption_key

string (UTF-8)

คีย์การเข้ารหัสเนื้อหาที่เข้ารหัสแบบ Base64 ซึ่งเข้ารหัสด้วยคีย์สาธารณะที่เชื่อมโยงกับคีย์ส่วนตัว ขนาดสูงสุด: 1 KB
rsa_oaep_label

string

ป้ายกํากับ L ที่เข้ารหัส Base64 หากอัลกอริทึมคือ RSAES-OAEP หากอัลกอริทึมไม่ใช่ RSAES-OAEP ช่องนี้จะถูกละเว้น
reason

string (UTF-8)

สตริง JSON แบบ Passthrough ที่ให้บริบทเพิ่มเติมเกี่ยวกับการดำเนินการ ควรล้างไฟล์ JSON ที่ระบุก่อนแสดง ขนาดสูงสุด: 1 KB
wrapped_private_key

string

คีย์ส่วนตัวที่เข้ารหัสฐาน 64 ขนาดสูงสุด: 8 KB

รูปแบบของคีย์ส่วนตัวหรือคีย์ส่วนตัวที่รวมไว้จะขึ้นอยู่กับการใช้งาน Key Access Control List Service (KACLS) ในไคลเอ็นต์และฝั่ง Gmail จะถือว่าเป็น BLOB ที่คลุมเครือ

เนื้อหาการตอบกลับ

หากสำเร็จ เมธอดนี้จะแสดงคีย์การเข้ารหัสข้อมูล Base64

หากดำเนินการไม่สำเร็จ ระบบจะแสดงผลการตอบกลับข้อผิดพลาดที่มีโครงสร้าง

การแสดง JSON 
{
  "data_encryption_key": string
}
ช่อง
data_encryption_key

string

คีย์การเข้ารหัสข้อมูลที่เข้ารหัสฐาน 64

ตัวอย่าง

ตัวอย่างนี้แสดงตัวอย่างคำขอและการตอบกลับสำหรับเมธอด privatekeydecrypt

ส่งคำขอ

POST https://mykacls.example.org/v1/privatekeydecrypt

{
  "wrapped_private_key": "wHrlNOTI9mU6PBdqiq7EQA...",
  "encrypted_data_encryption_key": "dGVzdCB3cmFwcGVkIGRlaw...",
  "authorization": "eyJhbGciOi...",
  "authentication": "eyJhbGciOi...",
  "algorithm": "RSA/ECB/PKCS1Padding",
  "reason": "decrypt"
}

คำตอบ

{
  "data_encryption_key": "akRQtv3nr+jUhcFL6JmKzB+WzUxbkkMyW5kQsqGUAFc="
}