nl :: Tecer:: Plataforma:: Segurança

Este namespace inclui todas as interfaces dentro Weave para o Weave Segurança Gerenciador de memória Monitor.

Resumo

As funções neste namespace devem ser implementadas por plataformas que usam o Weave, de acordo com as necessidades / restrições do ambiente específico.

Enumerações
`BlockSetParamFields { kBlockSetSizeMask = 0x07, kBlockSetSizeShift = 0, kBlockSetSizeValueShift = 7, kBlockSetCountMask = 0x18, kBlockSetCountShift = 3, kBlockSetBufferIndexMask = 0x60, kBlockSetBufferIndexShift = 5, kBlockSetIsLongTermMask = 0x80, kBlockSetIsLongTermShift = 7 }`	enum Localização dos campos de parâmetros do conjunto de blocos em um formato codificado de 8 bits.
BlockSetParams { kNumberOfNetworkBuffers = 2, kNumberOfBlockSets = 4, kNetworkBuffer0BlockAllocationMask = 0x07, kNetworkBuffer1BlockAllocationMask = 0x18, kBlockSet1Size = 1, kBlockSet1Count = 1, kBlockSet1BufferIndex = 0, kBlockSet1isLongTerm = 1, kBlockSet2Size = 4, kBlockSet2Count = 1, kBlockSet2BufferIndex = 0, kBlockSet2isLongTerm = 1, kBlockSet3Size = 4, kBlockSet3Count = 1, kBlockSet3BufferIndex = 0, kBlockSet3isLongTerm = 0, kBlockSet4Size = 5, kBlockSet4Count = 2, kBlockSet4BufferIndex = 1, kBlockSet4isLongTerm = 0, kTotalMemorySize = (kBlockSet1Size * kBlockSet1Count + kBlockSet2Size * kBlockSet2Count + kBlockSet3Size * kBlockSet3Count + kBlockSet4Size * kBlockSet4Count) << kBlockSetSizeValueShift, kMaxBlockSize = 600, kMinBufferSize = 1240 }	enum Define os parâmetros do conjunto de blocos.

Enumerações

BlockSetParamFields {
 kBlockSetSizeMask = 0x07,
 kBlockSetSizeShift = 0,
 kBlockSetSizeValueShift = 7,
 kBlockSetCountMask = 0x18,
 kBlockSetCountShift = 3,
 kBlockSetBufferIndexMask = 0x60,
 kBlockSetBufferIndexShift = 5,
 kBlockSetIsLongTermMask = 0x80,
 kBlockSetIsLongTermShift = 7
 }

enum

Localização dos campos de parâmetros do conjunto de blocos em um formato codificado de 8 bits.

BlockSetParams {
 kNumberOfNetworkBuffers = 2,
 kNumberOfBlockSets = 4,
 kNetworkBuffer0BlockAllocationMask = 0x07,
 kNetworkBuffer1BlockAllocationMask = 0x18,
 kBlockSet1Size = 1,
 kBlockSet1Count = 1,
 kBlockSet1BufferIndex = 0,
 kBlockSet1isLongTerm = 1,
 kBlockSet2Size = 4,
 kBlockSet2Count = 1,
 kBlockSet2BufferIndex = 0,
 kBlockSet2isLongTerm = 1,
 kBlockSet3Size = 4,
 kBlockSet3Count = 1,
 kBlockSet3BufferIndex = 0,
 kBlockSet3isLongTerm = 0,
 kBlockSet4Size = 5,
 kBlockSet4Count = 2,
 kBlockSet4BufferIndex = 1,
 kBlockSet4isLongTerm = 0,
 kTotalMemorySize = (kBlockSet1Size * kBlockSet1Count + kBlockSet2Size * kBlockSet2Count + kBlockSet3Size * kBlockSet3Count + kBlockSet4Size * kBlockSet4Count) << kBlockSetSizeValueShift,
 kMaxBlockSize = 600,
 kMinBufferSize = 1240
 }

enum

Define os parâmetros do conjunto de blocos.

Typedefs
`BlockMark_t`	typedef `uint8_t` O tipo usado para marcar qual bloco está atualmente alocado / não alocado.
`BlockSetParams_t`	typedef `uint8_t` Este tipo é usado para codificar informações do conjunto de blocos.

Variáveis
sBlockSetParams = { ((kBlockSet1Size << kBlockSetSizeShift) & kBlockSetSizeMask) \| ((kBlockSet1Count << kBlockSetCountShift) & kBlockSetCountMask) \| ((kBlockSet1BufferIndex << kBlockSetBufferIndexShift) & kBlockSetBufferIndexMask) \| ((kBlockSet1isLongTerm << kBlockSetIsLongTermShift) & kBlockSetIsLongTermMask), ((kBlockSet2Size << kBlockSetSizeShift) & kBlockSetSizeMask) \| ((kBlockSet2Count << kBlockSetCountShift) & kBlockSetCountMask) \| ((kBlockSet2BufferIndex << kBlockSetBufferIndexShift) & kBlockSetBufferIndexMask) \| ((kBlockSet2isLongTerm << kBlockSetIsLongTermShift) & kBlockSetIsLongTermMask), ((kBlockSet3Size << kBlockSetSizeShift) & kBlockSetSizeMask) \| ((kBlockSet3Count << kBlockSetCountShift) & kBlockSetCountMask) \| ((kBlockSet3BufferIndex << kBlockSetBufferIndexShift) & kBlockSetBufferIndexMask) \| ((kBlockSet3isLongTerm << kBlockSetIsLongTermShift) & kBlockSetIsLongTermMask), ((kBlockSet4Size << kBlockSetSizeShift) & kBlockSetSizeMask) \| ((kBlockSet4Count << kBlockSetCountShift) & kBlockSetCountMask) \| ((kBlockSet4BufferIndex << kBlockSetBufferIndexShift) & kBlockSetBufferIndexMask) \| ((kBlockSet4isLongTerm << kBlockSetIsLongTermShift) & kBlockSetIsLongTermMask), }[kNumberOfBlockSets]	`const BlockSetParams_t` Parâmetros de conjuntos de blocos codificados.
`sBufferAllocationMask = { kNetworkBuffer0BlockAllocationMask, kNetworkBuffer1BlockAllocationMask, }[kNumberOfNetworkBuffers]`	`const BlockMark_t` Conjunto de máscaras de bloco de buffer.
`sMemBlocksAllocated = 0`	`BlockMark_t` Indica qual bloco está alocado / não alocado.
`sMemBufs = { NULL }[kNumberOfNetworkBuffers]`	`void *` Ponteiros para buffers de memória inicializados com NULL.
`sNetworkBuffersUsed = true`	`bool` Um booleano que indica se (verdadeiro) ou não (falso) os buffers de rede são usados pelo Simple Allocator.

Funções
`DecodeBlockSetParams ( BlockSetParams_t blockSetParams, uint16_t & blockSize, uint8_t & blockCount, uint8_t & blockBufferIndex, bool & blockIsLongTerm)`	`void`
`GetSecureRandomData (uint8_t *buf, uint16_t len)`	`WEAVE_ERROR` Esta função é chamada pela camada Weave para gerar dados aleatórios.
`InitSecureRandomDataSource ( nl::Weave::Crypto::EntropyFunct entropyFunct, uint16_t entropyLen, const uint8_t *personalizationData, uint16_t perDataLen)`	`WEAVE_ERROR` Esta função é chamada pela camada Weave para inicializar a fonte de dados aleatória.
`MemoryAlloc (size_t size)`	`void *` Esta função é chamada pela camada Weave para alocar um bloco de memória de bytes de "tamanho".
`MemoryAlloc (size_t size, bool isLongTermAlloc)`	`void *` Esta função é chamada pela camada Weave para alocar um bloco de memória de bytes de "tamanho".
`MemoryFree (void *p)`	`void` Esta função é chamada pela camada Weave para liberar um bloco de memória alocado pela função MemeoryAlloc ().
`MemoryInit (void *buf, size_t bufSize)`	`WEAVE_ERROR` Esta função é chamada pela camada Weave para a memória e os recursos necessários para a funcionalidade adequada do Weave initialize Segurança alocador de memória Manager.
`MemoryShutdown (void)`	`void` Esta função é chamada pela camada Weave para libera todos os recursos que foram alocados pelo MemoryInit () função.
`OnTimeConsumingCryptoDone (void)`	`void` Esta função é chamada para notificar o aplicativo quando uma operação criptográfica demorada acaba de ser concluída.
`OnTimeConsumingCryptoStart (void)`	`void` Essa função é chamada para notificar o aplicativo quando uma operação criptográfica demorada está prestes a começar.

Aulas
nl :: Weave :: Platform :: Segurança :: AES128BlockCipher
nl :: Weave :: Platform :: Segurança :: AES128BlockCipherDec
nl :: Weave :: Platform :: Segurança :: AES128BlockCipherEnc
nl :: Weave :: Platform :: Segurança :: AES256BlockCipher
nl :: Weave :: Platform :: Segurança :: AES256BlockCipherDec
nl :: Weave :: Platform :: Segurança :: AES256BlockCipherEnc
nl :: Weave :: Platform :: Segurança :: SHA1
nl :: Weave :: Platform :: Segurança :: SHA256

Enumerações

BlockSetParamFields

 BlockSetParamFields

Localização dos campos de parâmetros do conjunto de blocos em um formato codificado de 8 bits.

Propriedades
`kBlockSetBufferIndexMask`	Máscara de campo de índice de buffer.
`kBlockSetBufferIndexShift`	Mudança de campo de índice de buffer.
`kBlockSetCountMask`	Máscara de campo de contagem.
`kBlockSetCountShift`	Mudança de campo de contagem.
`kBlockSetIsLongTermMask`	Digite máscara de campo.
`kBlockSetIsLongTermShift`	Digite deslocamento de campo.
`kBlockSetSizeMask`	Máscara de campo de tamanho.
`kBlockSetSizeShift`	Mudança de campo de tamanho.
`kBlockSetSizeValueShift`	Mudança de decodificação do campo de tamanho (multiplique por 128).

BlockSetParams

 BlockSetParams

Define os parâmetros do conjunto de blocos.

Propriedades
`kBlockSet1BufferIndex`	O índice de buffer # 1 definido é 0.
`kBlockSet1Count`	A contagem de blocos do conjunto # 1 é 1.
`kBlockSet1Size`	O tamanho do conjunto # 1 é 128 bytes.
`kBlockSet1isLongTerm`	O tipo de conjunto # 1 é de longo prazo.
`kBlockSet2BufferIndex`	Definir o índice de buffer # 2 é 0.
`kBlockSet2Count`	A contagem de blocos do conjunto # 2 é 1.
`kBlockSet2Size`	O tamanho do conjunto # 2 é 512 bytes.
`kBlockSet2isLongTerm`	O tipo de conjunto # 2 é de longo prazo.
`kBlockSet3BufferIndex`	O índice de buffer definido # 3 é 0.
`kBlockSet3Count`	A contagem de blocos do conjunto # 3 é 1.
`kBlockSet3Size`	O tamanho do conjunto # 3 é 512 bytes.
`kBlockSet3isLongTerm`	O tipo de conjunto # 3 é de curto prazo.
`kBlockSet4BufferIndex`	O índice de buffer # 4 definido é 1.
`kBlockSet4Count`	A contagem de blocos do conjunto # 4 é 2.
`kBlockSet4Size`	O tamanho do conjunto # 4 é de 640 bytes.
`kBlockSet4isLongTerm`	O tipo de conjunto # 4 é de curto prazo.
`kMaxBlockSize`	Tamanho máximo do bloco suportado pelo Simple Allocator.
`kMinBufferSize`	Tamanho mínimo do buffer de rede necessário para suportar casos de uso do Simple Allocator. Este parâmetro é derivado dos tamanhos de dois blocos de memória (640 + 600) alocados no buffer de rede # 1.
`kNetworkBuffer0BlockAllocationMask`	Esta máscara identifica todos os blocos de memória alocados do buffer de rede # 0.
`kNetworkBuffer1BlockAllocationMask`	Esta máscara identifica todos os blocos de memória alocados do buffer de rede # 1.
`kNumberOfBlockSets`	Número de conjuntos de blocos usados pelo Simple Allocator.
`kNumberOfNetworkBuffers`	Número de buffers de rede usados pelo Simple Allocator.
`kTotalMemorySize`	Memória total usada pelo Simple Allocator.

Typedefs

BlockMark_t

uint8_t BlockMark_t

O tipo usado para marcar qual bloco está atualmente alocado / não alocado.

uint8_t - suporta até 8 blocos de memória no total uint16_t - suporta até 16 blocos de memória no total uint32_t - suporta até 32 blocos de memória no total

BlockSetParams_t

uint8_t BlockSetParams_t

Este tipo é usado para codificar informações do conjunto de blocos.

Um conjunto de blocos é um grupo de blocos de memória que possuem as mesmas propriedades (tamanho, tipo e pertencem ao mesmo buffer). O diagrama abaixo apresenta como as informações do conjunto de blocos são codificadas em um formato de 8 bits:

É de longo prazo	Índice de Bloco	Número de Blocos	Tamanho do bloco
[7]	[6: 5]	[4: 3]	[2: 0]

[2: 0] - Tamanho do bloco de memória em um conjunto. O valor do tamanho é codificado com granularidade de 128 bytes.

[2: 0]	Decodificação
000	0 bytes
001	128 bytes
010	256 bytes
...	-
111	896 bytes

[4: 3] - Número de blocos em um conjunto.

[4: 3]	Decodificação
00	4 blocos
01	1 bloco
10	2 blocos
11	3 blocos

[6: 5] - Índice de buffer de rede onde residem os blocos de memória. Observe que quando o buffer dedicado é usado, todos os blocos de memória são alocados do buffer dedicado e este parâmetro de índice é ignorado.

[6: 5]	Decodificação
00	Buffer de rede # 0
...	-
11	Buffer de rede # 3

[7] - Especifica se os blocos são para armazenamento de longo / curto prazo.

[7]	Decodificação
0	Blocos de memória de curto prazo
1	Blocos de memória de longo prazo

Variáveis

sBlockSetParams

const BlockSetParams_t sBlockSetParams[kNumberOfBlockSets] = {
    
    ((kBlockSet1Size << kBlockSetSizeShift) & kBlockSetSizeMask) | 
    ((kBlockSet1Count << kBlockSetCountShift) & kBlockSetCountMask) | 
    ((kBlockSet1BufferIndex << kBlockSetBufferIndexShift) & kBlockSetBufferIndexMask) | 
    ((kBlockSet1isLongTerm << kBlockSetIsLongTermShift) & kBlockSetIsLongTermMask),
    
    ((kBlockSet2Size << kBlockSetSizeShift) & kBlockSetSizeMask) | 
    ((kBlockSet2Count << kBlockSetCountShift) & kBlockSetCountMask) | 
    ((kBlockSet2BufferIndex << kBlockSetBufferIndexShift) & kBlockSetBufferIndexMask) | 
    ((kBlockSet2isLongTerm << kBlockSetIsLongTermShift) & kBlockSetIsLongTermMask),
    
    ((kBlockSet3Size << kBlockSetSizeShift) & kBlockSetSizeMask) | 
    ((kBlockSet3Count << kBlockSetCountShift) & kBlockSetCountMask) | 
    ((kBlockSet3BufferIndex << kBlockSetBufferIndexShift) & kBlockSetBufferIndexMask) | 
    ((kBlockSet3isLongTerm << kBlockSetIsLongTermShift) & kBlockSetIsLongTermMask),
    
    ((kBlockSet4Size << kBlockSetSizeShift) & kBlockSetSizeMask) | 
    ((kBlockSet4Count << kBlockSetCountShift) & kBlockSetCountMask) | 
    ((kBlockSet4BufferIndex << kBlockSetBufferIndexShift) & kBlockSetBufferIndexMask) | 
    ((kBlockSet4isLongTerm << kBlockSetIsLongTermShift) & kBlockSetIsLongTermMask),







}

Parâmetros de conjuntos de blocos codificados.

sBufferAllocationMask

const BlockMark_t sBufferAllocationMask[kNumberOfNetworkBuffers] = {
                                                   kNetworkBuffer0BlockAllocationMask,
                                                   kNetworkBuffer1BlockAllocationMask,




                                                                                       }

Conjunto de máscaras de bloco de buffer.

Identifica se todos os blocos no buffer e não alocados e, em seguida, o buffer pode ser relieazed.

sMemBlocksAllocated

BlockMark_t sMemBlocksAllocated = 0

Indica qual bloco está alocado / não alocado.

Inicializado em 0 - significa que todos os blocos de memória e não alocados.

sMemBufs

void * sMemBufs[kNumberOfNetworkBuffers] = { NULL }

Ponteiros para buffers de memória inicializados com NULL.

Quando buffers de rede são usados, sMemBufs [] aponta para os objetos PacketBuffer. Quando um buffer dedicado é usado, sMemBufs [0] aponta para esse buffer e outros ponteiros sMemBufs [] são ignorados.

sNetworkBuffersUsed

bool sNetworkBuffersUsed = true

Um booleano que indica se (verdadeiro) ou não (falso) os buffers de rede são usados pelo Simple Allocator.

Quando falso - dedicado tampão fornecido com MemoryInit () função é usada.

Funções

DecodeBlockSetParams

void DecodeBlockSetParams(
  BlockSetParams_t blockSetParams,
  uint16_t & blockSize,
  uint8_t & blockCount,
  uint8_t & blockBufferIndex,
  bool & blockIsLongTerm
)

GetSecureRandomData

WEAVE_ERROR GetSecureRandomData(
  uint8_t *buf,
  uint16_t len
)

Esta função é chamada pela camada Weave para gerar dados aleatórios.

Detalhes

Parâmetros

`[in] buf`	Ponteiro para um buffer de memória, onde os dados aleatórios solicitados devem ser armazenados.
`[in] len`	Especifica o tamanho dos dados aleatórios solicitados em bytes.

Valores Retornados

`WEAVE_ERROR_DRBG_ENTROPY_SOURCE_FAILED`	Se a fonte de entropia falhar em gerar entropia solicitada pelo gerador de dados aleatórios.
`WEAVE_ERROR_RANDOM_DATA_UNAVAILABLE`	Se a fonte de dados aleatória falhar em gerar dados aleatórios.
`WEAVE_ERROR_INCORRECT_STATE`	Se a fonte de dados aleatória for encontrada em um estado errado.
`WEAVE_NO_ERROR`	Com sucesso.

InitSecureRandomDataSource

WEAVE_ERROR InitSecureRandomDataSource(
  nl::Weave::Crypto::EntropyFunct entropyFunct,
  uint16_t entropyLen,
  const uint8_t *personalizationData,
  uint16_t perDataLen
)

Esta função é chamada pela camada Weave para inicializar a fonte de dados aleatória.

Esta função é específica da plataforma e pode estar vazia quando nenhuma inicialização de fonte de dados aleatória é necessária.

Detalhes

Parâmetros

`[in] entropyFunct`	Ponteiro para uma função que gera entropia para o gerador de dados aleatórios. Quando a entrada de entropia não é exigida pelo algoritmo, essa entrada pode ser NULL, que é o caso quando a versão OpenSSL do gerador de dados aleatórios é usada.
`[in] entropyLen`	Especifica o tamanho da entropia em bytes que deve ser gerado pela função de entropia quando ela é usada.
`[in] personalizationData`	Ponteiro para um buffer de memória que armazena a entrada de dados de personalização. Esta entrada de dados deve ser específica do dispositivo e ajuda a melhorar as propriedades estatísticas dos dados aleatórios.
`[in] perDataLen`	Especifica o tamanho dos dados de personalização em bytes.

Valores Retornados

`WEAVE_ERROR_INVALID_ARGUMENT`	Se um argumento inválido foi passado para esta função.
`WEAVE_NO_ERROR`	Com sucesso.

MemoryAlloc

void * MemoryAlloc(
  size_t size
)

Esta função é chamada pela camada Weave para alocar um bloco de memória de bytes de "tamanho".

Esta função é equivalente a MemoryAlloc (size, false).

Detalhes

Parâmetros

[in] size

Especifica o tamanho da memória solicitada em bytes.

Valores Retornados

`Pointer`	para um bloco de memória em caso de sucesso.
`NULL-pointer`	se a alocação de memória falhar.

MemoryAlloc

void * MemoryAlloc(
  size_t size,
  bool isLongTermAlloc
)

Esta função é chamada pela camada Weave para alocar um bloco de memória de bytes de "tamanho".

Detalhes

Parâmetros

[in] size

Especifica o tamanho da memória solicitada em bytes.

[in] isLongTermAlloc

Um booleano que indica se (verdadeiro) ou não (falso) o bloco de memória solicitado é para uso de longo prazo. Uma alocação de longo prazo é a memória que deve permanecer alocada até que a sessão segura / handshake seja concluída. Exemplos de uma alocação de longo prazo incluem blocos alocados para objetos CASE / PASE e seus dados de contexto. Uma alocação de curto prazo é uma memória necessária para realizar uma operação específica e pode ser liberada imediatamente após isso. Essa entrada ajuda a otimizar a utilização da memória em um sistema com restrição de memória. O uso deste parâmetro é arbitrário e depende do implementador da função. Por exemplo, este parâmetro é ignorado quando a Biblioteca Padrão C malloc () é usada.

Valores Retornados

`Pointer`	para um bloco de memória em caso de sucesso.
`NULL-pointer`	se a alocação de memória falhar.

MemoryFree

void MemoryFree(
  void *p
)

Esta função é chamada pela camada Weave para liberar um bloco de memória alocado pela função MemeoryAlloc ().

Detalhes

Parâmetros

[in] p

Ponteiro para um bloco de memória que deve ser liberado.

MemoryInit

WEAVE_ERROR MemoryInit(
  void *buf,
  size_t bufSize
)

Esta função é chamada pela camada Weave para a memória e os recursos necessários para a funcionalidade adequada do Weave initialize Segurança alocador de memória Manager.

Esta função é específica da plataforma e pode estar vazia em certos casos. Por exemplo, esta função não faz nada quando as funções malloc () e free () da Biblioteca Padrão C são usadas para alocação de memória.

Detalhes

Parâmetros

`[in] buf`	Um ponteiro para um buffer de memória dedicada, que deve ser usado como um pool de memória para Weave Segurança alocação de memória Manager. Esta entrada é opcional (o padrão é NULL) e não deve ser usada se um buffer de memória dedicado não for usado.
`[in] bufSize`	Tamanho de um buffer de memória dedicado. Esta entrada é opcional (o padrão é 0) e não deve ser usada se o buffer de memória dedicado não for usado. Quando um buffer de memória dedicada é usada a função verifica e gera um erro se o tamanho do buffer não é grande o suficiente para suportar Weave Segurança casos de uso Manager.

Valores Retornados

`WEAVE_ERROR_BUFFER_TOO_SMALL`	Se o tamanho do buffer de entrada dedicado não é suficiente para suportar Weave Segurança casos de uso Manager.
`WEAVE_NO_ERROR`	Com sucesso.
`other`	Um erro gerado pela função de inicialização de memória específica da plataforma.

MemoryShutdown

void MemoryShutdown(
  void
)

Esta função é chamada pela camada Weave para libera todos os recursos que foram alocados pelo MemoryInit () função.

Esta função pode ser uma chamada vazia se não houver necessidade de liberar recursos. Por exemplo, este é o caso quando as funções malloc () e free () da Biblioteca Padrão C são usadas para alocação de memória.

OnTimeConsumingCryptoDone

void OnTimeConsumingCryptoDone(
  void
)

Esta função é chamada para notificar o aplicativo quando uma operação criptográfica demorada acaba de ser concluída.

OnTimeConsumingCryptoStart

void OnTimeConsumingCryptoStart(
  void
)

Essa função é chamada para notificar o aplicativo quando uma operação criptográfica demorada está prestes a começar.

nl :: Tecer:: Plataforma:: Segurança

Resumo

Enumerações

Typedefs

Variáveis

Funções

Aulas

Enumerações

BlockSetParamFields

BlockSetParams

Typedefs

BlockMark_t

BlockSetParams_t

Variáveis

sBlockSetParams

sBufferAllocationMask

sMemBlocksAllocated

sMemBufs

sNetworkBuffersUsed

Funções

DecodeBlockSetParams

GetSecureRandomData

InitSecureRandomDataSource

MemoryAlloc

MemoryAlloc

MemoryFree

MemoryInit

MemoryShutdown

OnTimeConsumingCryptoDone

OnTimeConsumingCryptoStart