الطريقة: فك الترميز

تعرض مفتاح تشفير البيانات (DEK) الذي تم فك تشفيره.

لمعرفة مزيد من التفاصيل، يُرجى الاطّلاع على تشفير البيانات وفك تشفيرها.

طلب HTTP

POST https://KACLS_URL/unwrap

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

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

بلا عُري

نص الطلب

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

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

string

رمز JWT صادر عن موفِّر الهوية لتأكيد هوية المستخدم. يُرجى الاطّلاع على الرموز المميزة للمصادقة.
authorization

string

رمز JWT يؤكّد أنّه مسموح للمستخدم بفتح مفتاح لـ resource_name. يُرجى الاطّلاع على الرموز المميّزة للتفويض.
reason

string (UTF-8)

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

string

يشير ذلك المصطلح إلى الكائن الثنائي base64 الذي يعرضه wrap.

نص الاستجابة

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

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

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

string

تمثّل هذه السمة DEK بترميز base64.

مثال

يقدم هذا المثال نموذجًا لطلب وردًّا على طريقة unwrap.

الطلب

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

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

الإجابة

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