- المورد: CseKeypair
- EnablementState
- CsePrivateKeyMetadata
- KaclsKeyMetadata
- HardwareKeyMetadata
- الطُرق
المرجع: CseKeypair
يشير هذا المصطلح إلى زوج مفاتيح S/MIME للتشفير من جهة العميل، والذي يتألف من مفتاح عام وسلسلة شهاداته والبيانات الوصفية لمفتاحه الخاص المقترن. يستخدم Gmail مفتاحَي التشفير لإكمال المهام التالية:
- توقيع الرسائل الصادرة المشفَّرة من جهة العميل
- حفظ مسودات الرسائل المشفّرة من جهة العميل وإعادة فتحها
- حفظ الرسائل المُرسَلة وإعادة فتحها
- فك تشفير رسائل S/MIME الواردة أو المؤرشفة.
تمثيل JSON |
---|
{ "keyPairId": string, "pkcs7": string, "pem": string, "subjectEmailAddresses": [ string ], "enablementState": enum ( |
الحقول | |
---|---|
keyPairId |
النتائج فقط. المعرّف غير القابل للتغيير لمفتاحَي التشفير S/MIME للتشفير من جهة العميل |
pkcs7 |
الإدخال فقط. المفتاح العام وسلسلة الشهادات الخاصة به يجب أن تكون السلسلة بالتنسيق PKCS#7 وأن تستخدم ترميز PEM ودرع ASCII. |
pem |
النتائج فقط. تمثّل هذه السمة المفتاح العام وسلسلة شهاداته بتنسيق PEM. |
subjectEmailAddresses[] |
النتائج فقط. هويات عناوين البريد الإلكتروني التي تم تحديدها في الشهادة التجريبية. |
enablementState |
النتائج فقط. الحالة الحالية لمفتاحَي التشفير. |
disableTime |
النتائج فقط. في حال ضبط مفتاحَي التشفير على طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
privateKeyMetadata[] |
البيانات الوصفية لمثيلات المفتاح الخاص لزوج المفاتيح هذا |
EnablementState
التعداد للحالة الحالية لزوج المفاتيح.
عمليات التعداد | |
---|---|
stateUnspecified |
لم يتم ضبط الحالة الحالية لمفتاحَي التشفير. لم يتم تفعيل مفتاحَي التشفير أو إيقافهما. |
enabled |
مفتاحا التشفير في وضع التفعيل. بالنسبة إلى أي رسائل إلكترونية يشفّرها زوج المفاتيح هذا، يعمل Gmail على فك تشفير الرسائل وتوقيع أي بريد صادر باستخدام المفتاح الخاص. لتفعيل مفتاحَي تشفير، استخدِم الطريقة |
disabled |
تم إيقاف مفتاحَي التشفير. ولا يمكن للمستخدمين الذين تمت مصادقتهم فك تشفير الرسائل الإلكترونية أو توقيع الرسائل الصادرة. إذا تم إيقاف مفتاحَي التشفير لمدة تزيد عن 30 يومًا، يمكنك حذفهما نهائيًا. لإيقاف مفتاحَي التشفير، استخدِم الطريقة |
CsePrivateKeyMetadata
البيانات الوصفية لمثيل مفتاح خاص
تمثيل JSON |
---|
{ "privateKeyMetadataId": string, // Union field |
الحقول | |
---|---|
privateKeyMetadataId |
النتائج فقط. رقم التعريف غير القابل للتغيير لمثيل البيانات الوصفية للمفتاح الخاص. |
حقل الاتحاد metadata_variant . حقل الاتحاد: يجب أن يتوفّر واحد بالضبط من أنواع صيغ البيانات الوصفية التالية. يمكن أن يكون metadata_variant واحدًا فقط مما يلي: |
|
kaclsKeyMetadata |
البيانات الوصفية لمثيل مفتاح خاص تديره خدمة قائمة التحكّم بالوصول إلى مفاتيح خارجية |
hardwareKeyMetadata |
البيانات الوصفية لمفاتيح الأجهزة |
KaclsKeyMetadata
البيانات الوصفية للمفاتيح الخاصة التي تديرها خدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير الخارجية للحصول على تفاصيل عن إدارة الوصول إلى مفتاح التشفير، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات لميزة "التشفير من جهة العميل" في Google Workspace.
تمثيل JSON |
---|
{ "kaclsUri": string, "kaclsData": string } |
الحقول | |
---|---|
kaclsUri |
معرِّف الموارد المنتظم (URI) لخدمة قائمة التحكّم بالوصول إلى مفاتيح التشفير التي تدير المفتاح الخاص. |
kaclsData |
بيانات معتمة يتم إنشاؤها واستخدامها بواسطة خدمة قائمة التحكم بالوصول إلى مفاتيح التشفير. الحد الأقصى للحجم: 8 كيبيبايت. |
HardwareKeyMetadata
البيانات الوصفية لمفاتيح الأجهزة
تمثيل JSON |
---|
{ "description": string } |
الحقول | |
---|---|
description |
وصف حول مفتاح الجهاز |
الطُرق |
|
---|---|
|
إنشاء وتحميل سلسلة شهادات المفتاح العام S/MIME للتشفير من جهة العميل والبيانات الوصفية للمفتاح الخاص للمستخدم الذي تمت مصادقته. |
|
إيقاف مفتاحَي تشفير من جهة العميل |
|
تفعيل مفتاحَي تشفير من جهة العميل تم إيقافه |
|
لاسترداد مفتاحَي تشفير حاليَين من جهة العميل. |
|
يسرد أزواج مفاتيح التشفير من جهة العميل لمستخدم تمت مصادقته. |
|
يتم حذف مفتاحَي تشفير من جهة العميل نهائيًا وعلى الفور. |