الطريقة: التفاف النص

لعرض مفتاح تشفير البيانات المشفَّر (DEK) والبيانات المرتبطة به.

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

طلب HTTP

POST https://KACLS_URL/wrap

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

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

بلا عُري

نص الطلب

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

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

string

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

string

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

string

وحدة DEK بترميز base64. الحد الأقصى للحجم: 128 بايت.
reason

string (UTF-8)

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

نص الاستجابة

وفي حال نجاحها، تعرض هذه الطريقة كائنًا ثنائيًا مبهمًا سيتم تخزينه من خلال Google Workspace على طول العنصر المشفَّر ويتم إرساله كما هو في أي عملية لاحقة لفك التفاف المفتاح.

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

يجب أن يحتوي الكائن الثنائي على النسخة الوحيدة من DEK المشفّر، ويمكن تخزين بيانات خاصة بالتنفيذ فيه.

يجب عدم تخزين DEK في نظام خدمة قائمة الوصول إلى المفاتيح (KACLS)، بل تشفيره وإعادته في الكائن wrapped_key. ويمنع ذلك التناقضات الدائمة بين المستند ومفاتيحه. على سبيل المثال، لضمان محو بيانات المستخدم بالكامل عند طلبها، أو للتأكّد من أن النُسخ السابقة التي تمت استعادتها من نسخة احتياطية قابلة لفك تشفيرها.

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

string

الكائن الثنائي بترميز base64. الحدّ الأقصى للحجم: 1 كيلوبايت.

مثال

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

الطلب

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

{
   "key":"wHrlNOTI9mU6PBdqiq7EQA==",
   "authorization": "eyJhbGciOi…"
   "authentication": "eyJhbGciOi…"
   "reason": "{client:'drive' op:'update'}"
}

الإجابة

{
    "wrapped_key": "3qTh6Mp+svPwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg=="
}