الطريقة: wrapprivatekey

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

طلب HTTP

POST https://BASE_URL/wrapprivatekey

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

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

بلا عُري

نص الطلب

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

{
  "authentication": string,
  "perimeter_id": string,
  "private_key": string
}

نص الاستجابة

وإذا نجحت هذه الطريقة، ستعرض هذه الطريقة المفتاح الخاص الذي تم تشفيره باستخدام أحد الملفات.

إذا فشلت العملية، سيتم عرض رد بالخطأ المنظم.

{
  "wrapped_private_key": string
}

مثال

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