الطريقة: Premierdunwrap

تتم الاستعانة بهذه السمة لفك تشفير البيانات التي يتم تصديرها من Google في سياق مميّز. يُعرف هذا الهدف سابقًا باسم TakeoutUnwrap. تعرض هذه الطريقة مفتاح تشفير البيانات (DEK) الذي تم تغليفه باستخدام wrap بدون التحقّق من المستند الأصلي أو قائمة التحكّم بالوصول إلى الملف (ACL). للاطّلاع على مثال عن حالة الاستخدام، يُرجى الرجوع إلى: Google Takeout.

طلب HTTP

POST https://KACLS_URL/privilegedunwrap

استبدِل KACLS_URL بعنوان URL الخاص بخدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير (KACLS).

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

بلا عُري

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "authentication": string,
  "reason": string,
  "resource_name": string,
  "wrapped_key": string
}
الحقول
authentication

string

رمز JWT صادر عن موفّر الهوية يؤكّد هوية المستخدم. يمكنك الاطّلاع على رموز المصادقة.
reason

string (UTF-8)

سلسلة JSON لتمرير البيانات توفّر سياقًا إضافيًا حول العملية. يجب تنظيف ملف JSON المقدَّم قبل عرضه. الحد الأقصى للحجم: 1 كيلوبايت
resource_name

string (UTF-8)

معرّف للعنصر المشفّر باستخدام مفتاح تشفير البيانات يجب أن تتطابق هذه القيمة مع resource_name المستخدَم لتضمين المفتاح. الحد الأقصى للحجم: 128 بايت.
wrapped_key

string

كائن base64 الثنائي الذي تعرضه wrap.

نص الاستجابة

في حال النجاح، تعرض هذه الطريقة مفتاح تشفير المستند.

في حال تعذُّر تنفيذ العملية، يجب عرض ردّ خطأ منظَّم.

تمثيل JSON 
{
  "key": string
}
الحقول
key

string

مفتاح تشفير البيانات (DEK) المشفّر باستخدام Base64

مثال

يقدّم هذا المثال نموذجًا لطلب وردّ خاصين بطريقة privilegedunwrap.

طلب

POST https://mykacls.example.com/v1/takeout_unwrap

{
   "wrapped_key": "7qTh6Mp+svVwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg==",
   "authentication": "eyJhbGciOi…"
   "reason": "{client:'takeout' op:'read'}"
   "resource_name": "item123"
}

الردّ

{
    "key": "0saNxttLMQULfXuTbRFJzi/QJokN1jW16u0yaNvvLdQ="
}