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

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