يتم فك التشفير بدون التحقّق من قائمة التحكم بالوصول (ACL) للمفتاح الخاص المرفق. فهي تُستخدم لفك تشفير البيانات التي تم تصديرها (تصدير المحتوى) من Google
طلب HTTP
POST https://BASE_URL/privilegedprivatekeydecrypt
استبدِل BASE_URL
بعنوان URL الأساسي.
مَعلمات المسار
بلا عُري
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "authentication": string, "algorithm": string, "encrypted_data_encryption_key": string, "rsa_oaep_label": string, "reason": string, "spki_hash": string, "spki_hash_algorithm": string, "wrapped_private_key": string } |
الحقول | |
---|---|
authentication |
ملف JWT صادر عن موفِّر الهوية (IdP) لتأكيد هوية المستخدم. راجِع الرموز المميزة للمصادقة. |
algorithm |
الخوارزمية التي تم استخدامها لتشفير مفتاح تشفير البيانات (DEK) في تشفير المغلف. |
encrypted_data_encryption_key |
مفتاح تشفير المحتوى بترميز Base64، والذي يتم تشفيره باستخدام المفتاح العام المرتبط بالمفتاح الخاص. الحدّ الأقصى للحجم: 1 كيلوبايت |
rsa_oaep_label |
التصنيف L بترميز Base64، إذا كانت الخوارزمية هي RSAES-OAEP. إذا لم تكن الخوارزمية RSAES-OAEP، سيتم تجاهل هذا الحقل. |
reason |
سلسلة JSON مرورية توفر سياقًا إضافيًا حول العملية. يجب تصحيح ملف JSON المقدَّم قبل عرضه. الحدّ الأقصى للحجم: 1 كيلوبايت |
spki_hash |
هذا ملخص عادي بترميز base64 لـ |
spki_hash_algorithm |
الخوارزمية المستخدمة لإنتاج |
wrapped_private_key |
هذا هو المفتاح الخاص الملفوف بترميز base64. الحدّ الأقصى للحجم: 8 كيلوبايت. |
نص الاستجابة
وفي حال إتمام الإجراء، ستعرض هذه الطريقة مفتاح تشفير البيانات base64. هذا المفتاح هو من جهة العميل لفك تشفير نص الرسالة.
إذا فشلت العملية، فسيتم الردّ على الأخطاء المنظَّمة .
تمثيل JSON | |
---|---|
{ "data_encryption_key": string } |
الحقول | |
---|---|
data_encryption_key |
هو مفتاح تشفير البيانات بترميز base64. |
مثال
يقدم هذا المثال نموذجًا لطلب واستجابة
طريقة privilegedprivatekeydecrypt
.
الطلب
POST https://mykacls.example.org/v1/privilegedprivatekeydecrypt
{
"wrapped_private_key": "wHrlNOTI9mU6PBdqiq7EQA...",
"encrypted_data_encryption_key": "dGVzdCB3cmFwcGVkIGRlaw...",
"authentication": "eyJhbGciOi...",
"spki_hash": "LItGzrmjSFD57QdrY1dcLwYmSwBXzhQLAA6zVcen+r0=",
"spki_hash_algorithm": "SHA-256",
"algorithm": "RSA/ECB/PKCS1Padding",
"reason": "admin decrypt"
}
الرد
{
"data_encryption_key": "akRQtv3nr+jUhcFL6JmKzB+WzUxbkkMyW5kQsqGUAFc"
}