المرجع: CseKeyزوج
يشير ذلك المصطلح إلى زوج مفاتيح 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 "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
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 للمفتاح العام للتشفير من جهة العميل وبيانات وصفية للمفتاح الخاص للمستخدم الذي تمت المصادقة عليه. |
|
يتم إيقاف زوج مفاتيح التشفير من جهة العميل. |
|
يؤدي هذا الخيار إلى تفعيل زوج مفاتيح التشفير من جهة العميل الذي تم إيقافه. |
|
لاسترداد زوج مفاتيح التشفير من جهة العميل الحالي. |
|
يسرد أزواج مفاتيح التشفير من جهة العميل لمستخدم تمت مصادقته. |
|
يؤدي هذا الإجراء إلى حذف مفتاحَي تشفير من جهة العميل نهائيًا وعلى الفور. |