لعرض مفتاح تشفير البيانات المشفَّر (DEK) والبيانات المرتبطة به.
لمعرفة مزيد من التفاصيل، يُرجى الاطّلاع على تشفير البيانات وفك تشفيرها.
طلب HTTP
POST https://KACLS_URL/wrap
استبدل KACLS_URL
بعنوان URL لقائمة
التحكم بالوصول إلى المفاتيح (KACLS).
مَعلمات المسار
بلا عُري
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "authentication": string, "authorization": string, "key": string, "reason": string } |
الحقول | |
---|---|
authentication |
نموذج JWT صادر عن موفِّر الهوية لإثبات هوية المستخدم. يُرجى الاطّلاع على الرموز المميّزة للمصادقة. |
authorization |
رمز اختبار JWT يؤكّد أنّه يُسمح للمستخدم بلف مفتاح لـ |
key |
وحدة DEK بترميز base64. الحد الأقصى للحجم: 128 بايت. |
reason |
سلسلة JSON للمرور توفر سياقًا إضافيًا حول العملية. يجب تصحيح ملف JSON المُقدَّم قبل عرضه. الحدّ الأقصى للحجم: 1 كيلوبايت. |
نص الاستجابة
وفي حال نجاحها، تعرض هذه الطريقة كائنًا ثنائيًا مبهمًا سيتم تخزينه من خلال Google Workspace على طول العنصر المشفَّر ويتم إرساله كما هو في أي عملية لاحقة لفك التفاف المفتاح.
إذا فشلت العملية، يجب عرض رد بالخطأ المنظم.
يجب أن يحتوي الكائن الثنائي على النسخة الوحيدة من DEK المشفّر، ويمكن تخزين بيانات خاصة بالتنفيذ فيه.
يجب عدم تخزين DEK في نظام خدمة قائمة الوصول إلى المفاتيح (KACLS)، بل تشفيره وإعادته في الكائن wrapped_key. ويمنع ذلك التناقضات الدائمة بين المستند ومفاتيحه. على سبيل المثال، لضمان محو بيانات المستخدم بالكامل عند طلبها، أو للتأكّد من أن النُسخ السابقة التي تمت استعادتها من نسخة احتياطية قابلة لفك تشفيرها.
تمثيل JSON | |
---|---|
{ "wrapped_key": string } |
الحقول | |
---|---|
wrapped_key |
الكائن الثنائي بترميز 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=="
}