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

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

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

طلب HTTP

POST https://KACLS_URL/wrap

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

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

بلا عُري

نص الطلب

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

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

string

رمز JWT الصادر عن موفِّر الهوية (idP) لتأكيد هوية المستخدم. راجِع الرموز المميزة للمصادقة.
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=="
}