الطريقة: ملخص

يستقبل هذا الطلب مفتاح تشفير البيانات (DEK) الذي تم تغليفه باستخدام واجهة برمجة التطبيقات الخاصة بالتغليف، ويعرض تجزئة مفتاح المورد بترميز base64.

يُرجى الاطّلاع أيضًا على: rewrap

طلب HTTP

POST https://KACLS_URL/digest

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

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

بلا عُري

نص الطلب

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

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

string

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

string (UTF-8)

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

string

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

نص الاستجابة

في حال نجاح العملية، يعرض هذا الإجراء قيمة تجزئة لمفتاح المورد بترميز base64.

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

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

string

كائن ثنائي مشفّر بتنسيق base64 اطّلِع على تجزئة مفتاح المورد.

مثال

طلب

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

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

الردّ

{
   "resource_key_hash": "qClT153ghqBOLPpdMsc4S4n6okPrRaLPBYT0zRcn+go="
}