O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

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

Essa é uma classe abstrata.

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

A definição da classe de armazenamento de chaves do grupo do Weave.

Resumo

As funções nesta classe são chamadas para gerenciar chaves de grupos de aplicativos.

Herança

Subclasses conhecidas diretas:
nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
nl::Weave::DeviceLayer::Internal::GroupKeyStoreImpl
nl::Weave::Profiles::Security::AppKeys::DummyGroupKeyStore

Atributos protegidos
`LastUsedEpochKeyId`	`uint32_t`
`NextEpochKeyStartTime`	`uint32_t`

Funções públicas
`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` Deriva a chave do aplicativo.
`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` Retorna o ID da chave atual.
`GetCurrentUTCTime(uint32_t & utcTime)`	`virtual WEAVE_ERROR` Encontra o horário UTC atual da plataforma em segundos.
`GetGroupKey(uint32_t keyId, WeaveGroupKey & groupKey)`	`WEAVE_ERROR` Recebe a chave do grupo de aplicativos.
`RetrieveGroupKey(uint32_t keyId, WeaveGroupKey & key)=0`	`virtual WEAVE_ERROR`
`StoreGroupKey(const WeaveGroupKey & key)=0`	`virtual WEAVE_ERROR`

Funções protegidas
`Init(void)`	`void` Inicialize os parâmetros do repositório de chaves do grupo local.
`OnEpochKeysChange(void)`	`void` Retorna o ID da chave atual.
`RetrieveLastUsedEpochKeyId(void)=0`	`virtual WEAVE_ERROR`
`StoreLastUsedEpochKeyId(void)=0`	`virtual WEAVE_ERROR`

Atributos protegidos

LastUsedEpochKeyId

uint32_t LastUsedEpochKeyId

NextEpochKeyStartTime

uint32_t NextEpochKeyStartTime

Funções públicas

Limpar

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
)

Deriva a chave do aplicativo.

Há suporte para três tipos de chaves de aplicativo: a atual, a rotativa e a estática. Quando a chave de aplicativo atual é solicitada, a função encontra e usa a chave da época atual com base no horário atual do sistema e no parâmetro do horário de início de cada chave do período.

Detalhes

Parâmetros

`[in,out] keyId`	Uma referência ao ID da chave solicitado. Quando a chave de aplicativo atual é solicitada, esse campo é atualizado para refletir o novo tipo (chave de aplicativo em rotação) e o ID de chave de época real usado para gerar a chave de aplicativo.
`[in] keySalt`	Um ponteiro para um buffer com o valor de sal da chave do aplicativo.
`[in] saltLen`	O comprimento do sal da chave do aplicativo.
`[in] keyDiversifier`	Um ponteiro para um buffer com o valor do diversificador da chave de aplicativo.
`[in] diversifierLen`	O comprimento do diversificador da chave de aplicativo.
`[out] appKey`	Um ponteiro para um buffer em que a chave derivada será gravada.
`[in] keyBufSize`	O comprimento do buffer de chave fornecido.
`[in] keyLen`	O comprimento do material da chave solicitado.
`[out] appGroupGlobalId`	O ID global do grupo de aplicativos da chave associada.

Valores de retorno

`WEAVE_NO_ERROR`	Se a operação for bem-sucedida.
`WEAVE_ERROR_BUFFER_TOO_SMALL`	Se o tamanho do buffer de chave fornecido não for suficiente.
`WEAVE_ERROR_INVALID_KEY_ID`	Se a chave solicitada tiver um ID inválido.
`WEAVE_ERROR_INVALID_ARGUMENT`	Se o repositório de chaves da plataforma retornar parâmetros de chave inválidos ou o identificador de chave tiver um valor inválido.
`other`	Outros erros específicos da plataforma retornados pelas APIs de armazenamento de chaves da plataforma.

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
)

Retorna o ID da chave atual.

Encontra a chave da época atual com base no horário atual do sistema e no parâmetro do horário de início de cada chave do período. Se o sistema não tiver um horário válido e preciso, o ID da chave da última época usada será retornado.

Detalhes

Parâmetros

`[in] keyId`	O ID da chave do aplicativo.
`[out] curKeyId`	O ID da chave atual do aplicativo.

Valores de retorno

`WEAVE_NO_ERROR`	Se a operação for bem-sucedida.
`WEAVE_ERROR_INVALID_KEY_ID`	Se o ID da chave de entrada tiver um valor inválido.
`WEAVE_ERROR_KEY_NOT_FOUND`	Se as chaves de época não forem encontradas no armazenamento de chaves da plataforma.
`other`	Outros erros específicos da plataforma retornados pelas APIs de armazenamento de chaves da plataforma.

GetCurrentUTCTime

virtual WEAVE_ERROR GetCurrentUTCTime(
  uint32_t & utcTime
)

Encontra o horário UTC atual da plataforma em segundos.

Detalhes

Parâmetros

[out] utcTime

Uma referência ao valor de tempo.

Valores de retorno

`WEAVE_NO_ERROR`	Se a operação for bem-sucedida.
`#WEAVE_SYSTEM_ERROR_NOT_SUPPORTED`	Se a plataforma não tiver suporte para relógio em tempo real.
`#WEAVE_SYSTEM_ERROR_REAL_TIME_NOT_SYNCED`	Se o relógio em tempo real do sistema não estiver sincronizado com uma fonte de horário precisa.
`other`	Outros códigos de erro do Weave ou da plataforma.

GetGroupKey

WEAVE_ERROR GetGroupKey(
  uint32_t keyId,
  WeaveGroupKey & groupKey
)

Recebe a chave do grupo de aplicativos.

Essa função deriva ou recupera chaves de grupos de aplicativos. Os tipos de chave compatíveis com essa função são: secret de malha, chave raiz, chave de época, chave mestra de grupo e chave intermediária.

Detalhes

Parâmetros

`[in] keyId`	O ID da chave do grupo.
`[out] groupKey`	Uma referência ao objeto de chave de grupo.

Valores de retorno

`WEAVE_NO_ERROR`	Se a operação for bem-sucedida.
`WEAVE_ERROR_INVALID_KEY_ID`	Se a chave solicitada tiver um ID inválido.
`WEAVE_ERROR_INVALID_ARGUMENT`	Se o repositório de chaves da plataforma retornar parâmetros de chave inválidos.
`other`	Outros erros específicos da plataforma retornados pelas APIs de armazenamento de chaves da plataforma.

RetrieveGroupKey

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

StoreGroupKey

virtual WEAVE_ERROR StoreGroupKey(
  const WeaveGroupKey & key
)=0

Funções protegidas

Init

void Init(
  void
)

Inicialize os parâmetros do repositório de chaves do grupo local.

OnEpochKeysChange

void OnEpochKeysChange(
  void
)

Retorna o ID da chave atual.

Define as variáveis de membro associadas a chaves de época para os valores padrão quando alguma alteração (exclusão ou armazenamento) acontece no conjunto de chaves de época do aplicativo. É responsabilidade da subclasse que implementa as funções StoreGroupKey(), DeleteGroupKey() e DeleteGroupKeysOfAType() chamar esse método.

RetrieveLastUsedEpochKeyId

virtual WEAVE_ERROR RetrieveLastUsedEpochKeyId(
  void
)=0

StoreLastUsedEpochKeyId

virtual WEAVE_ERROR StoreLastUsedEpochKeyId(
  void
)=0