เมธอด: wrapprivatekey

ห่อหุ้มคีย์ส่วนตัวของผู้ใช้ การดำเนินการนี้เป็นสิทธิ์พิเศษและดำเนินการได้โดยผู้ดูแลระบบบริการรายการควบคุมการเข้าถึงคีย์ (KACLS) ที่ได้รับอนุญาตเท่านั้น API นี้เป็นแบบไม่บังคับ ทั้ง Google และไคลเอ็นต์ Gmail จะไม่เรียก API นี้ ข้อมูลจำเพาะที่ให้ไว้เป็นเพียงคำแนะนำเท่านั้น ไม่ใช่ข้อกำหนด

คำขอ HTTP

POST https://KACLS_URL/wrapprivatekey

แทนที่ KACLS_URL ด้วย URL ของบริการรายการควบคุมการเข้าถึงคีย์ (KACLS)

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

ไม่มี

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

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

การแสดง JSON 
{
  "authentication": string,
  "perimeter_id": string,
  "private_key": string
}
ช่อง
authentication

string

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

string (UTF-8)

รหัสขอบเขตที่จะเข้ารหัสด้วยคีย์
private_key

string

DEK ที่เข้ารหัสแบบ Base64 ขนาดสูงสุด 128 ไบต์

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

หากสำเร็จ เมธอดนี้จะแสดงผลคีย์ส่วนตัวที่ห่อหุ้ม

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

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

string

คีย์ส่วนตัวที่ห่อหุ้มซึ่งเข้ารหัสแบบ Base64 ขนาดสูงสุด 8 KB

ตัวอย่าง

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

ส่งคำขอ

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

{
  "private_key": "-----BEGIN RSA PRIVATE KEY-----\\nMIIJ......\\n-----END RSA PRIVATE KEY-----",
  "perimeter_id": ""
}

คำตอบ

{
  "wrapped_private_key": "LpyCSy5ddy82PIp/87JKaMF4Jmt1KdrbfT1iqpB7uhVd3OwZiu+oq8kxIzB7Lr0iX4aOcxM6HiUyMrGP2PG8x0HkpykbUKQxBVcfm6SLdsqigT9ho5RYw20M6ZXNWVRetFSleKex4SRilTRny38e2ju/lUy0KDaCt1hDUT89nLZ1wsO3D1F3xk8J7clXv5fe7GPRd1ojo82Ny0iyVO7y7h1lh2PACHUFXOMzsdURYFCnxhKAsadccCxpCxKh5x8p78PdoenwY1tnT3/X4O/4LAGfT4fo98Frxy/xtI49WDRNZi6fsL6BQT4vS/WFkybBX9tXaenCqlRBDyZSFhatPQ=="
}