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

تعرض هذه السمة مفتاح تشفير البيانات (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) في نظام "خدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير" (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=="
}