nl::Weave::Profiles::Security::AppKeys::GroupKeyStoreBase

यह एक ऐब्सट्रैक्ट क्लास है.

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

Weave ग्रुप की स्टोर क्लास की परिभाषा.

खास जानकारी

इस क्लास के फ़ंक्शन को ऐप्लिकेशन ग्रुप की कुंजियों को मैनेज करने के लिए कॉल किया जाता है.

इनहेरिटेंस

सीधे तौर पर पता चलने वाली सब-क्लास:
  nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
  nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
  nl::SecurityerGroup::Devicelayer:Weave::Weave:Devicelayer::अंदरूनी::GroupKeyStoreImpl
  nl::Weave::डिवाइसnl::Weave::Profiles::Security::AppKeys::DummyGroupKeyStore

सुरक्षित एट्रिब्यूट

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

DeleteGroupKey

virtual WEAVE_ERROR DeleteGroupKey(
  uint32_t keyId
)=0

DeleteGroupKeysOfAType

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
)

ऐप्लिकेशन कुंजी का इस्तेमाल करता है.

तीन तरह की ऐप्लिकेशन कुंजियां काम करती हैं: मौजूदा ऐप्लिकेशन कुंजी, रोटेटिंग ऐप्लिकेशन कुंजी, और स्टैटिक ऐप्लिकेशन कुंजी. मौजूदा ऐप्लिकेशन कुंजी का अनुरोध किए जाने पर, फ़ंक्शन हर epoch कुंजी के शुरू होने के समय वाले पैरामीटर और मौजूदा सिस्टम के समय के आधार पर, मौजूदा epoch कुंजी को ढूंढता है और उसका इस्तेमाल करता है.

ब्यौरा
पैरामीटर
[in,out] keyId
अनुरोध किए गए कुंजी आईडी का रेफ़रंस. जब मौजूदा ऐप्लिकेशन कुंजी का अनुरोध किया जाता है, तो इस फ़ील्ड को अपडेट किया जाता है. ऐसा नए टाइप (ऐप्लिकेशन कुंजी को बदलने वाली) और ऐप्लिकेशन कुंजी जनरेट करने के लिए इस्तेमाल किए गए असल epoch कुंजी आईडी को दिखाने के लिए किया जाता है.
[in] keySalt
ऐप्लिकेशन कुंजी सॉल्ट की वैल्यू वाले बफ़र का पॉइंटर.
[in] saltLen
ऐप्लिकेशन की सॉल्ट की लंबाई.
[in] keyDiversifier
ऐप्लिकेशन कुंजी की अलग-अलग तरह की वैल्यू देने वाले बफ़र का पॉइंटर.
[in] diversifierLen
ऐप्लिकेशन कुंजी डाइवर्सिफ़ायर की लंबाई.
[out] appKey
बफ़र के लिए पॉइंटर जहां डिराइव्ड की लिखी जाएगी.
[in] keyBufSize
दिए गए कुंजी बफ़र की लंबाई.
[in] keyLen
अनुरोध की गई मुख्य सामग्री की लंबाई.
[out] appGroupGlobalId
जुड़ी हुई कुंजी का ऐप्लिकेशन ग्रुप ग्लोबल आईडी.
रिटर्न वैल्यू
WEAVE_NO_ERROR
सफलता पर.
WEAVE_ERROR_BUFFER_TOO_SMALL
अगर दिया गया कुंजी बफ़र साइज़ काफ़ी न हो.
WEAVE_ERROR_INVALID_KEY_ID
अगर अनुरोध की गई कुंजी का आईडी अमान्य है.
WEAVE_ERROR_INVALID_ARGUMENT
अगर प्लैटफ़ॉर्म कुंजी स्टोर, अमान्य कुंजी पैरामीटर दिखाता है या कुंजी आइडेंटिफ़ायर की वैल्यू अमान्य है, तो.
other
प्लैटफ़ॉर्म कुंजी स्टोर एपीआई से, प्लैटफ़ॉर्म से जुड़ी अन्य गड़बड़ियां दिखाई गई हैं.

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
)

मौजूदा कुंजी आईडी दिखाता है.

यह फ़ंक्शन, सिस्टम के मौजूदा समय और हर epoch कुंजी के शुरू होने के समय के पैरामीटर के आधार पर, मौजूदा epoch कुंजी ढूंढता है. अगर सिस्टम के लिए, समय की जानकारी मान्य और सटीक नहीं है, तो पिछली बार इस्तेमाल किए गए epoch पासकोड का आईडी दिखाया जाता है.

ब्यौरा
पैरामीटर
[in] keyId
ऐप्लिकेशन कुंजी आईडी.
[out] curKeyId
ऐप्लिकेशन का मौजूदा कुंजी आईडी.
रिटर्न वैल्यू
WEAVE_NO_ERROR
सफलता पर.
WEAVE_ERROR_INVALID_KEY_ID
अगर इनपुट कुंजी आईडी में कोई अमान्य वैल्यू डाली गई थी.
WEAVE_ERROR_KEY_NOT_FOUND
अगर प्लैटफ़ॉर्म कुंजी स्टोर में epoch कुंजियां नहीं मिलती हैं.
other
प्लैटफ़ॉर्म कुंजी स्टोर एपीआई से, प्लैटफ़ॉर्म से जुड़ी अन्य गड़बड़ियां दिखाई गई हैं.

GetCurrentUTCTime

virtual WEAVE_ERROR GetCurrentUTCTime(
  uint32_t & utcTime
)

वर्तमान प्लैटफ़ॉर्म यूटीसी समय को सेकंड में पाएं.

ब्यौरा
पैरामीटर
[out] utcTime
समय की वैल्यू का रेफ़रंस.
रिटर्न वैल्यू
WEAVE_NO_ERROR
सफलता पर.
#WEAVE_SYSTEM_ERROR_NOT_SUPPORTED
अगर प्लैटफ़ॉर्म, रीयल टाइम क्लॉक के साथ काम नहीं करता है.
#WEAVE_SYSTEM_ERROR_REAL_TIME_NOT_SYNCED
अगर सिस्टम की रीयल टाइम घड़ी सही समय स्रोत से सिंक नहीं है.
other
अन्य Weave या प्लैटफ़ॉर्म गड़बड़ी कोड.

GetGroupKey

WEAVE_ERROR GetGroupKey(
  uint32_t keyId,
  WeaveGroupKey & groupKey
)

ऐप्लिकेशन ग्रुप कुंजी पाएं.

यह फ़ंक्शन, ऐप्लिकेशन ग्रुप कुंजियों का पता लगाता है या उन्हें वापस लाता है. इस फ़ंक्शन के साथ काम करने वाली कुंजी के टाइप हैं: फ़ैब्रिक सीक्रेट, रूट कुंजी, epoch कुंजी, ग्रुप मास्टर कुंजी, और इंटरमीडिएट कुंजी.

ब्यौरा
पैरामीटर
[in] keyId
ग्रुप कुंजी आईडी.
[out] groupKey
ग्रुप के मुख्य ऑब्जेक्ट का रेफ़रंस.
रिटर्न वैल्यू
WEAVE_NO_ERROR
सफलता पर.
WEAVE_ERROR_INVALID_KEY_ID
अगर अनुरोध की गई कुंजी का आईडी अमान्य है.
WEAVE_ERROR_INVALID_ARGUMENT
अगर प्लैटफ़ॉर्म कुंजी स्टोर अमान्य कुंजी पैरामीटर दिखाता है.
other
प्लैटफ़ॉर्म कुंजी स्टोर एपीआई से, प्लैटफ़ॉर्म से जुड़ी अन्य गड़बड़ियां दिखाई गई हैं.

RetrieveGroupKey

virtual WEAVE_ERROR RetrieveGroupKey(
  uint32_t keyId,
  WeaveGroupKey & key
)=0

StoreGroupKey

virtual WEAVE_ERROR StoreGroupKey(
  const WeaveGroupKey & key
)=0

सुरक्षित किए गए फ़ंक्शन

शुरू करें

void Init(
  void
)

लोकल ग्रुप की स्टोर पैरामीटर शुरू करें.

OnEpochKeysChange

void OnEpochKeysChange(
  void
)

मौजूदा कुंजी आईडी दिखाता है.

ऐप्लिकेशन epoch कुंजियों के सेट में कोई भी बदलाव (मिटाएं या स्टोर करें) होने पर, epoch बटन से जुड़े मेंबर वैरिएबल को डिफ़ॉल्ट वैल्यू पर सेट करता है. इस तरीके को कॉल करने के लिए, उस सब-क्लास की ज़िम्मेदारी है जो StoreGroupKey(), DeleteGroupKey(), और DeleteGroupKeysOfAType() फ़ंक्शन को लागू करता है.

RetrieveLastUsedEpochKeyId

virtual WEAVE_ERROR RetrieveLastUsedEpochKeyId(
  void
)=0

StoreLastUsedEpochKeyId

virtual WEAVE_ERROR StoreLastUsedEpochKeyId(
  void
)=0