nl:: Weave:: الملفات الشخصية:: الأمان:: AppKeys:: GroupKeyStoreBase
هذا صف مجرَّد
#include <src/lib/profiles/security/WeaveApplicationKeys.h>
تمثّل هذه الخاصية تعريف فئة تخزين مفاتيح مجموعة Weave.
الملخّص
يتم استدعاء الدوال في هذا الصف لإدارة مفاتيح مجموعة التطبيقات.
الاكتساب
الفئات الفرعية المعروفة مباشرةً:nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl{/10Key::Key::Appa:}إعدادات أساسية:الأمن المفتاح::المستخدم: المستخدم }
السمات المحمية |
|
---|---|
LastUsedEpochKeyId
|
uint32_t
|
NextEpochKeyStartTime
|
uint32_t
|
وظائف عامة |
|
---|---|
Clear(void)=0
|
virtual WEAVE_ERROR
|
DeleteGroupKey(uint32_t keyId)=0
|
virtual WEAVE_ERROR
|
DeleteGroupKeysOfAType(uint32_t keyType)=0
|
virtual WEAVE_ERROR
|
DeriveApplicationKey(uint32_t & appKeyId, const uint8_t *keySalt, uint8_t saltLen, const uint8_t *keyDiversifier, uint8_t diversifierLen, uint8_t *appKey, uint8_t keyBufSize, uint8_t keyLen, uint32_t & appGroupGlobalId)
|
يستفيد من مفتاح التطبيق.
|
EnumerateGroupKeys(uint32_t keyType, uint32_t *keyIds, uint8_t keyIdsArraySize, uint8_t & keyCount)=0
|
virtual WEAVE_ERROR
|
GetCurrentAppKeyId(uint32_t keyId, uint32_t & curKeyId)
|
عرض رقم تعريف المفتاح الحالي.
|
GetCurrentUTCTime(uint32_t & utcTime)
|
virtual WEAVE_ERROR
احصل على التوقيت العالمي المتفق عليه للمنصة بالثواني.
|
GetGroupKey(uint32_t keyId, WeaveGroupKey & groupKey)
|
الحصول على مفتاح مجموعة التطبيقات.
|
RetrieveGroupKey(uint32_t keyId, WeaveGroupKey & key)=0
|
virtual WEAVE_ERROR
|
StoreGroupKey(const WeaveGroupKey & key)=0
|
virtual WEAVE_ERROR
|
دوال محمية |
|
---|---|
Init(void)
|
void
إعداد معلمات متجر مفتاح المجموعة المحلية
|
OnEpochKeysChange(void)
|
void
عرض رقم تعريف المفتاح الحالي.
|
RetrieveLastUsedEpochKeyId(void)=0
|
virtual WEAVE_ERROR
|
StoreLastUsedEpochKeyId(void)=0
|
virtual WEAVE_ERROR
|
السمات المحمية
معرّف LastUsedEpochKeyId
uint32_t LastUsedEpochKeyId
تذكرة NextEpochKeyStartTime
uint32_t NextEpochKeyStartTime
وظائف عامة
محو
virtual WEAVE_ERROR Clear( void )=0
حذف المجموعة
virtual WEAVE_ERROR DeleteGroupKey( uint32_t keyId )=0
حذف المجموعة الرئيسية من النوع
virtual WEAVE_ERROR DeleteGroupKeysOfAType( uint32_t keyType )=0
DeriveApplicationKey
WEAVE_ERROR DeriveApplicationKey( uint32_t & appKeyId, const uint8_t *keySalt, uint8_t saltLen, const uint8_t *keyDiversifier, uint8_t diversifierLen, uint8_t *appKey, uint8_t keyBufSize, uint8_t keyLen, uint32_t & appGroupGlobalId )
يستفيد من مفتاح التطبيق.
تتوفر ثلاثة أنواع من مفاتيح التطبيق: مفتاح التطبيق الحالي، ومفتاح التطبيق بالتناوب، ومفتاح التطبيق الثابت. عندما يُطلب مفتاح التطبيق الحالي، تبحث الدالة عن مفتاح الحقبة الحالي وتستخدمه استنادًا إلى وقت النظام الحالي ومعلمة وقت البدء لكل مفتاح حقبة.
التفاصيل | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||||||||||||
قيم الإرجاع |
|
EnumerateGroupKeys
virtual WEAVE_ERROR EnumerateGroupKeys( uint32_t keyType, uint32_t *keyIds, uint8_t keyIdsArraySize, uint8_t & keyCount )=0
GetCurrentAppKeyId
WEAVE_ERROR GetCurrentAppKeyId( uint32_t keyId, uint32_t & curKeyId )
عرض رقم تعريف المفتاح الحالي.
للعثور على مفتاح الحقبة الحالية استنادًا إلى وقت النظام الحالي ومعلمة وقت البدء لكل مفتاح من الحقبة. إذا لم يكن لدى النظام وقت صالح ودقيقة، يتم عرض معرّف مفتاح آخر حقبة استخدام.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||
قيم الإرجاع |
|
وقت الحصول على التوقيت العالمي المنسق (UTC)
virtual WEAVE_ERROR GetCurrentUTCTime( uint32_t & utcTime )
احصل على التوقيت العالمي المتفق عليه للمنصة بالثواني.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||
قيم الإرجاع |
|
GetGroupKey
WEAVE_ERROR GetGroupKey( uint32_t keyId, WeaveGroupKey & groupKey )
الحصول على مفتاح مجموعة التطبيقات.
تشتق هذه الدالة مفاتيح مجموعة التطبيقات أو تستردها. تشمل أنواع المفاتيح المتوافقة مع هذه الوظيفة: سر القماش، ومفتاح الجذر، ومفتاح الحقبة، والمفتاح الرئيسي للمجموعة، والمفتاح المتوسط.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المعلَمات |
|
||||||||
قيم الإرجاع |
|
مفتاح استرداد المجموعة
virtual WEAVE_ERROR RetrieveGroupKey( uint32_t keyId, WeaveGroupKey & key )=0
مفتاح المجموعة Store
virtual WEAVE_ERROR StoreGroupKey( const WeaveGroupKey & key )=0
دوال محمية
إنيت
void Init( void )
إعداد معلمات متجر مفتاح المجموعة المحلية
تغيير مفتاح OnEpochKeys
void OnEpochKeysChange( void )
عرض رقم تعريف المفتاح الحالي.
تعمل هذه السياسة على ضبط متغيرات الأعضاء المرتبطة بمفاتيح الحقبة على القيم التلقائية عند حدوث أي تغيير (حذف أو تخزين) لمجموعة مفاتيح حقبة التطبيق. وتقع على عاتقك مسؤولية تنفيذ الفئة الفرعية التي تنفّذ وظائف الدوال StoreGroupKey() وDeleteGroupKey() وDeleteGroupKeysOfAType() لاستدعاء هذه الطريقة.