nl:: बुना::प्रोफ़ाइलें::सुरक्षा::AppKeys::GroupKeyStoreBase

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

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

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

खास जानकारी

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

इनहेरिटेंस

मेरी

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

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

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

अंतिम उपयोग किया गया EpochKeyId

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

DevApplicationKey

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
प्लैटफ़ॉर्म के हिसाब से तय की गई दूसरी गड़बड़ियों को, प्लैटफ़ॉर्म कुंजी स्टोर एपीआई की मदद से दिखाया गया.

GetCURRENTUTC समय

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
प्लैटफ़ॉर्म के हिसाब से तय की गई दूसरी गड़बड़ियों को, प्लैटफ़ॉर्म कुंजी स्टोर एपीआई की मदद से दिखाया गया.

GetGroupKey

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

स्टोर ग्रुप की

virtual WEAVE_ERROR StoreGroupKey(
  const WeaveGroupKey & key
)=0

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

इनिट

void Init(
  void
)

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

OnEpochKeysबदलें

void OnEpochKeysChange(
  void
)

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

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

LastLastddEpochKeyId फिर से पाएं

virtual WEAVE_ERROR RetrieveLastUsedEpochKeyId(
  void
)=0

स्टोर में पिछली बार इस्तेमाल किया गया EpochKeyId

virtual WEAVE_ERROR StoreLastUsedEpochKeyId(
  void
)=0