nl::Weave::Profiles::Security::KeyExport::WeaveKeyExportDelegate

هذه فئة تجريدية.

#include <src/lib/profiles/security/WeaveKeyExport.h>

فئة مجرد التفويض التي يستدعيها محرّك KeyExport لتنفيذ إجراءات متنوعة متعلقة بالمصادقة أثناء تصدير المفتاح

ملخّص

الاكتساب

الفئات الفرعية المعروفة المباشرة: nl::Weave::Profiles::Security::KeyExport::WeaveStandAloneKeyExportClient

الدوال العامة
BeginCertValidation(WeaveKeyExport *keyExport, ValidationContext & validCtx, WeaveCertificateSet & certSet)=0
virtual WEAVE_ERROR
استعد للتحقق من صحة شهادة الزميل.
EndCertValidation(WeaveKeyExport *keyExport, ValidationContext & validCtx, WeaveCertificateSet & certSet)=0
virtual WEAVE_ERROR
تحرير الموارد المرتبطة بالتحقق من صحة شهادات الزملاء.
GenerateNodeSignature(WeaveKeyExport *keyExport, const uint8_t *msgHash, uint8_t msgHashLen, TLVWriter & writer)=0
virtual WEAVE_ERROR
يمكنك إنشاء توقيع لرسالة تصدير مفتاح.
GetNodeCertSet(WeaveKeyExport *keyExport, WeaveCertificateSet & certSet)=0
virtual WEAVE_ERROR
احصل على مجموعة شهادة تصدير المفتاح للعقدة المحلية.
HandleCertValidationResult(WeaveKeyExport *keyExport, ValidationContext & validCtx, WeaveCertificateSet & certSet, uint32_t requestedKeyId)=0
virtual WEAVE_ERROR
معالجة نتائج التحقق من صحة شهادة الأقران.
ReleaseNodeCertSet(WeaveKeyExport *keyExport, WeaveCertificateSet & certSet)=0
virtual WEAVE_ERROR
حرر مجموعة شهادة العقدة.
ValidateUnsignedKeyExportMessage(WeaveKeyExport *keyExport, uint32_t requestedKeyId)=0
virtual WEAVE_ERROR
تحقَّق من أمان رسالة تصدير المفتاح غير الموقعة.

الدوال العامة

BeginCertValidation

virtual WEAVE_ERROR BeginCertValidation(
  WeaveKeyExport *keyExport,
  ValidationContext & validCtx,
  WeaveCertificateSet & certSet
)=0

استعد للتحقق من صحة شهادة الزميل.

تم استدعاء هذا الإجراء في بداية عملية التحقّق من صحة الشهادة. تكون هذه الطريقة مسؤولة عن إعداد مجموعة الشهادات المقدّمة وسياق التحقّق من الصحة للاستخدام في التحقّق من صحة شهادة العقدة المشابهة. يجب أن تؤدي عمليات التنفيذ إلى تهيئة الكائن WeaveCertificateSet الذي يتضمن موارد كافية للتعامل مع عملية التحقُّق من الشهادة القادمة. ويجب أيضًا أن يتم في عملية التنفيذ تحميل أي شهادات جذر أو شهادات CA ضرورية وموثوق بها في مجموعة الشهادات.

سيتم إعداد سياق التحقّق من الصحة المقدَّم باستخدام مجموعة من معايير التحقّق التلقائية، والتي قد يغيّرها التنفيذ حسب الضرورة. يجب أن يتم في عملية التنفيذ إما ضبط حقل ActivateTime أو ضبط علامات التحقّق المناسبة لإيقاف عملية التحقّق من صحة الشهادة منذ إنشائها.

ويجب تنفيذ هذا الإجراء من أجل الحفاظ على أي موارد مخصّصة أثناء BeginCertValidation() إلى أن يتم استدعاء EndCertValidation() المقابل. تضمن عمليات التنفيذ أنّه سيتم استدعاء الدالة EndCertValidation() مرة واحدة بالضبط لكل استدعاء ناجح إلى BeginCertValidation().

EndCertValidation

virtual WEAVE_ERROR EndCertValidation(
  WeaveKeyExport *keyExport,
  ValidationContext & validCtx,
  WeaveCertificateSet & certSet
)=0

تحرير الموارد المرتبطة بالتحقق من صحة شهادات الزملاء.

يتم استدعاء هذا الحدث عند اكتمال التحقُّق من صحة شهادة التطبيقات المشابهة والتحقّق من الطلب.

GenerateNodeSignature

virtual WEAVE_ERROR GenerateNodeSignature(
  WeaveKeyExport *keyExport,
  const uint8_t *msgHash,
  uint8_t msgHashLen,
  TLVWriter & writer
)=0

يمكنك إنشاء توقيع لرسالة تصدير مفتاح.

تكون هذه الطريقة مسؤولة عن احتساب توقيع لقيمة التجزئة المحددة باستخدام المفتاح الخاص للعقدة المحلية وكتابة التوقيع على كاتب TLV المقدم كبنية WeaveSignature TLV.

GetNodeCertSet

virtual WEAVE_ERROR GetNodeCertSet(
  WeaveKeyExport *keyExport,
  WeaveCertificateSet & certSet
)=0

احصل على مجموعة شهادة تصدير المفتاح للعقدة المحلية.

يتم استدعاء هذا الإجراء عندما يستعد محرّك تصدير المفتاح للتوقيع على رسالة تصدير مفتاح. تكون هذه الطريقة مسؤولة عن إعداد مجموعة الشهادات وتحميل جميع الشهادات التي سيتم تضمينها أو الإشارة إليها في توقيع الرسالة. يجب أن تكون آخر شهادة تم تحميلها هي شهادة التوقيع.

HandleCertValidationResult

virtual WEAVE_ERROR HandleCertValidationResult(
  WeaveKeyExport *keyExport,
  ValidationContext & validCtx,
  WeaveCertificateSet & certSet,
  uint32_t requestedKeyId
)=0

معالجة نتائج التحقق من صحة شهادة الأقران.

يتم استدعاء هذا الإجراء عند اكتمال التحقُّق من شهادة العقدة المشابهة. يتم استدعاء هذه الطريقة فقط في حال اكتمال عملية التحقق من صحة الشهادة بنجاح. قد تستخدم عمليات التنفيذ هذا الطلب لفحص نتائج التحقّق، وربما إلغاء النتيجة بخطأ.

بالنسبة إلى عقدة مستجيبة، من المتوقع أن تتحقَّق الطريقة من صلاحية مقدِّم الطلب لتصدير المفتاح المطلوب.

بالنسبة إلى عقدة البدء، من المتوقع أن تتحقق الطريقة من أن الشهادة التي تم التحقق من صحتها تحدد بشكل صحيح النظير الذي تم إرسال طلب تصدير المفتاح إليه.

ReleaseNodeCertSet

virtual WEAVE_ERROR ReleaseNodeCertSet(
  WeaveKeyExport *keyExport,
  WeaveCertificateSet & certSet
)=0

حرر مجموعة شهادة العقدة.

يتم استدعاء هذا الإجراء عند انتهاء محرك تصدير المفتاح من مجموعة الشهادات التي يعرضها GetNodeCertSet().

ValidateUnsignedKeyExportMessage

virtual WEAVE_ERROR ValidateUnsignedKeyExportMessage(
  WeaveKeyExport *keyExport,
  uint32_t requestedKeyId
)=0

تحقَّق من أمان رسالة تصدير المفتاح غير الموقعة.

يتم استدعاء هذا الحدث عندما تتلقّى العُقدة رسالة تصدير مفتاح غير موقَّعة. من المتوقّع أن تتحقّق الطريقة من أمان رسالة تصدير مفتاح لم يتم توقيعها استنادًا إلى سياق اتصالها، على سبيل المثال من خلال سمات جلسة الأمان المستخدَمة لإرسال الرسالة.

بالنسبة إلى عقدة مستجيبة، من المتوقّع أن تتحقّق الطريقة من صلاحية بادئ تشغيل المفتاح المطلوب تصديره.

بالنسبة إلى عقدة البدء، من المتوقّع أن تتحقّق الطريقة من الرسالة التي نشأت من الرسالة النظيرة التي تم إرسال طلب تصدير المفتاح إليها.