الطريقة: wrapprivatekey

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

طلب HTTP

POST https://BASE_URL/wrapprivatekey

استبدِل BASE_URL بعنوان URL الأساسي.

مَعلمات المسار

بلا عُري

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل 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==",
}