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

يأخذ هذا الاستدعاء مفتاح تشفير البيانات (DEK) ملفوفًا مع wrap API، تُنتج تنسيق 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="
}