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

تعرض هذه الدالة مفتاح تشفير البيانات (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="
}