الطريقة: wrapprivatekey

يغلّف هذا الطلب المفتاح الخاص بالمستخدم. هذه عملية مميزة لا يمكن إجراؤها إلا من قِبل مشرفي "خدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير" (KACLS) المفوّضين. واجهة برمجة التطبيقات هذه اختيارية. لا تستدعي Google ولا برنامج Gmail واجهة برمجة التطبيقات هذه. المواصفات المقدَّمة هي اقتراح وليس شرطًا.

طلب 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 كيلوبايت

مثال

يعرض هذا المثال نموذجًا لطلب وردّ للطريقة 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=="
}