الطريقة: accessdprivatekeydecrypt

يتم فك التشفير بدون التحقّق من قائمة التحكم بالوصول (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

string

ملف JWT صادر عن موفِّر الهوية (IdP) لتأكيد هوية المستخدم. راجِع الرموز المميزة للمصادقة.

algorithm

string

الخوارزمية التي تم استخدامها لتشفير مفتاح تشفير البيانات (DEK) في تشفير المغلف.

encrypted_data_encryption_key

string (UTF-8)

مفتاح تشفير المحتوى بترميز Base64، والذي يتم تشفيره باستخدام المفتاح العام المرتبط بالمفتاح الخاص. الحدّ الأقصى للحجم: 1 كيلوبايت

rsa_oaep_label

string

التصنيف L بترميز Base64، إذا كانت الخوارزمية هي RSAES-OAEP. إذا لم تكن الخوارزمية RSAES-OAEP، سيتم تجاهل هذا الحقل.

reason

string (UTF-8)

سلسلة JSON مرورية توفر سياقًا إضافيًا حول العملية. يجب تصحيح ملف JSON المقدَّم قبل عرضه. الحدّ الأقصى للحجم: 1 كيلوبايت

spki_hash

string

هذا ملخص عادي بترميز base64 لـ SubjectPublicKeyInfo بترميز DER للمفتاح الخاص الذي يتم الوصول إليه.

spki_hash_algorithm

string

الخوارزمية المستخدمة لإنتاج spki_hash. يمكن أن تكون خوارزمية SHA-256.

wrapped_private_key

string

هذا هو المفتاح الخاص الملفوف بترميز base64. الحدّ الأقصى للحجم: 8 كيلوبايت.

نص الاستجابة

وفي حال إتمام الإجراء، ستعرض هذه الطريقة مفتاح تشفير البيانات base64. هذا المفتاح هو من جهة العميل لفك تشفير نص الرسالة.

إذا فشلت العملية، فسيتم الردّ على الأخطاء المنظَّمة .

تمثيل JSON
{
  "data_encryption_key": string
}
الحقول
data_encryption_key

string

هو مفتاح تشفير البيانات بترميز 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"
}