Questa pagina è stata tradotta dall'API Cloud Translation.

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

Questa è una classe astratta.

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

La definizione della classe di archivio chiavi del gruppo Weave.

Riepilogo

Le funzioni in questa classe sono chiamate per gestire le chiavi dei gruppi di applicazioni.

Eredità

Sottoclassi note dirette:
nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
nl::Weave::Device Layer::Internal::0GroupKeyStore Impl{/1
nl::Weave::Profiles::Security::AppKeys::DummyGroupKeyStore

Attributi protetti
`LastUsedEpochKeyId`	`uint32_t`
`NextEpochKeyStartTime`	`uint32_t`

Funzioni pubbliche
`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)`	`WEAVE_ERROR` Ricava la chiave applicazione.
`EnumerateGroupKeys(uint32_t keyType, uint32_t *keyIds, uint8_t keyIdsArraySize, uint8_t & keyCount)=0`	`virtual WEAVE_ERROR`
`GetCurrentAppKeyId(uint32_t keyId, uint32_t & curKeyId)`	`WEAVE_ERROR` Restituisce l'ID chiave corrente.
`GetCurrentUTCTime(uint32_t & utcTime)`	`virtual WEAVE_ERROR` Ottieni l'ora UTC attuale della piattaforma in secondi.
`GetGroupKey(uint32_t keyId, WeaveGroupKey & groupKey)`	`WEAVE_ERROR` Ottieni chiave del gruppo di applicazioni.
`RetrieveGroupKey(uint32_t keyId, WeaveGroupKey & key)=0`	`virtual WEAVE_ERROR`
`StoreGroupKey(const WeaveGroupKey & key)=0`	`virtual WEAVE_ERROR`

Funzioni protette
`Init(void)`	`void` Inizializza i parametri dell'archivio chiavi del gruppo locale.
`OnEpochKeysChange(void)`	`void` Restituisce l'ID chiave corrente.
`RetrieveLastUsedEpochKeyId(void)=0`	`virtual WEAVE_ERROR`
`StoreLastUsedEpochKeyId(void)=0`	`virtual WEAVE_ERROR`

Attributi protetti

LastUsedEpochKeyId

uint32_t LastUsedEpochKeyId

NextEpochKeyStartTime

uint32_t NextEpochKeyStartTime

Funzioni pubbliche

Cancella

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
)

Ricava la chiave applicazione.

Sono supportati tre tipi di chiavi applicazione: chiave applicazione corrente, chiave applicazione a rotazione e chiave applicazione statica. Quando viene richiesta la chiave applicazione corrente, la funzione trova e utilizza la chiave epoch corrente in base all'ora di sistema corrente e al parametro dell'ora di inizio di ciascuna chiave epoch.

Dettagli

Parametri

`[in,out] keyId`	Un riferimento all'ID chiave richiesto. Quando viene richiesta la chiave applicazione corrente, questo campo viene aggiornato per riflettere il nuovo tipo (chiave applicazione in rotazione) e l'ID effettivo della chiave epoca che è stato utilizzato per generare la chiave applicazione.
`[in] keySalt`	Un puntatore a un buffer con valore salt della chiave dell'applicazione.
`[in] saltLen`	La lunghezza del sale della chiave di applicazione.
`[in] keyDiversifier`	Un puntatore a un buffer con un valore diversificatore della chiave di applicazione.
`[in] diversifierLen`	La durata del diversificatore della chiave applicazione.
`[out] appKey`	Un puntatore a un buffer in cui verrà scritta la chiave derivata.
`[in] keyBufSize`	La lunghezza del buffer della chiave fornito.
`[in] keyLen`	La lunghezza del materiale della chiave richiesto.
`[out] appGroupGlobalId`	L'ID globale del gruppo di applicazioni della chiave associata.

Valori restituiti

`WEAVE_NO_ERROR`	In caso di successo.
`WEAVE_ERROR_BUFFER_TOO_SMALL`	Se la dimensione del buffer della chiave fornita non è sufficiente.
`WEAVE_ERROR_INVALID_KEY_ID`	Se la chiave richiesta ha un ID chiave non valido.
`WEAVE_ERROR_INVALID_ARGUMENT`	Se l'archivio chiavi della piattaforma restituisce parametri chiave non validi o un identificatore chiave con valore non valido.
`other`	Altri errori specifici della piattaforma restituiti dalle API dell'archivio chiavi della piattaforma.

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
)

Restituisce l'ID chiave corrente.

Trova la chiave dell'epoca corrente in base all'ora del sistema corrente e al parametro dell'ora di inizio di ogni chiave dell'epoca. Se il sistema non dispone di un'ora valida e precisa, viene restituito l'ID della chiave epoch dell'ultimo utilizzo.

Dettagli

Parametri

`[in] keyId`	L'ID della chiave applicazione.
`[out] curKeyId`	L'ID della chiave corrente dell'applicazione.

Valori restituiti

`WEAVE_NO_ERROR`	In caso di successo.
`WEAVE_ERROR_INVALID_KEY_ID`	Se l'ID della chiave di input presenta un valore non valido.
`WEAVE_ERROR_KEY_NOT_FOUND`	Se non si trovano chiavi epoch nell'archivio chiavi della piattaforma.
`other`	Altri errori specifici della piattaforma restituiti dalle API dell'archivio chiavi della piattaforma.

GetCurrentUTCTime

virtual WEAVE_ERROR GetCurrentUTCTime(
  uint32_t & utcTime
)

Ottieni l'ora UTC attuale della piattaforma in secondi.

Dettagli

Parametri

[out] utcTime

Un riferimento al valore dell'ora.

Valori restituiti

`WEAVE_NO_ERROR`	In caso di successo.
`#WEAVE_SYSTEM_ERROR_NOT_SUPPORTED`	Se la piattaforma non supporta un orologio in tempo reale.
`#WEAVE_SYSTEM_ERROR_REAL_TIME_NOT_SYNCED`	Se l'orologio in tempo reale del sistema non è sincronizzato con una fonte di tempo accurata.
`other`	Altri codici di errore Weave o relativi alla piattaforma.

GetGroupKey

WEAVE_ERROR GetGroupKey(
  uint32_t keyId,
  WeaveGroupKey & groupKey
)

Ottieni chiave del gruppo di applicazioni.

Questa funzione ricava o recupera le chiavi del gruppo di applicazioni. I tipi di chiavi supportati da questa funzione sono: secret fabric, chiave root, chiave epoch, chiave master di gruppo e chiave intermedia.

Dettagli

Parametri

`[in] keyId`	L'ID della chiave del gruppo.
`[out] groupKey`	Un riferimento all'oggetto chiave di gruppo.

Valori restituiti

`WEAVE_NO_ERROR`	In caso di successo.
`WEAVE_ERROR_INVALID_KEY_ID`	Se la chiave richiesta ha un ID chiave non valido.
`WEAVE_ERROR_INVALID_ARGUMENT`	Se l'archivio chiavi della piattaforma restituisce parametri chiave non validi.
`other`	Altri errori specifici della piattaforma restituiti dalle API dell'archivio chiavi della piattaforma.

RetrieveGroupKey

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

StoreGroupKey

virtual WEAVE_ERROR StoreGroupKey(
  const WeaveGroupKey & key
)=0

Funzioni protette

Inizia

void Init(
  void
)

Inizializza i parametri dell'archivio chiavi del gruppo locale.

OnEpochKeysChange

void OnEpochKeysChange(
  void
)

Restituisce l'ID chiave corrente.

Imposta le variabili dei membri associate alle chiavi epoch sui valori predefiniti quando si verifica qualsiasi modifica (eliminazione o archiviazione) al set di chiavi epoch dell'applicazione. È responsabilità della sottoclasse che implementa le funzioni StoreGroupKey(), DeleteGroupKey() ed DeleteGroupKeysOfAType() chiamare questo metodo.

RetrieveLastUsedEpochKeyId

virtual WEAVE_ERROR RetrieveLastUsedEpochKeyId(
  void
)=0

StoreLastUsedEpochKeyId

virtual WEAVE_ERROR StoreLastUsedEpochKeyId(
  void
)=0