classe ara::crypto::cryp::WriteableKeySlot

A interface ara::crypto::cryp::WriteableKeySlot serve no AUTOSAR Adaptive como uma abstração gravável para locais de armazenamento de chaves em um CryptoProvider. As instâncias não podem ser copiadas nem movidas ([SWS_CRYPT_50170], [SWS_CRYPT_50168]), sendo referenciadas através do tipo de ponteiro inteligente Sptr [SWS_CRYPT_50172]. Por meio do método thread-safe Clear(), o conteúdo do slot de chave é limpo, aplicando-se uma semântica de rollback em caso de falha como kBusyResource ou kUnsupported [SWS_CRYPT_30405].

mais ›

Contexto

A interface ara::crypto::cryp::WriteableKeySlot define, no âmbito do AUTOSAR Adaptive Platform, um local de armazenamento gravável para chaves criptográficas no contexto de um CryptoProvider. Ela deriva diretamente da interface base KeySlot e representa uma abstração padronizada para limpar de forma direcionada slots de chave gerenciados e controlar o seu ciclo de vida. Aplicações da pilha criptográfica atuam como consumidores e como parceiros essenciais de interação, assim como o CryptoProvider concreto, que gerencia a vinculação ao armazenamento físico ou lógico de chaves. A criação de instâncias concretas deve ocorrer por meio de métodos de fábrica ou de provedor de nível superior, visto que a interface atua como uma classe base puramente abstrata. Pergunta Q-5c3b13bb35c3ff53 (aberta)

Ciclo de vida

O modelo de recursos e posse de ara::crypto::cryp::WriteableKeySlot impede estritamente a duplicação de referências de chave por meio de semântica de valor. Para essa finalidade, tanto o construtor de cópia [SWS_CRYPT_50170] quanto o construtor de movimentação [SWS_CRYPT_50171] foram explicitamente excluídos (=delete). Do mesmo modo, as declarações excluídas do operador de atribuição por cópia [SWS_CRYPT_50168] e do operador de atribuição por movimentação [SWS_CRYPT_50169] impedem qualquer atribuição subsequente.

O repasse referencial e o gerenciamento compartilhado ocorrem, em vez disso, através do alias de tipo de ponteiro inteligente definido Sptr, que é materializado como std::shared_ptr<WriteableKeySlot> [SWS_CRYPT_50172]. A destruição da instância é assegurada por um destrutor padrão virtual, especificado como seguro para exceções (exception safe) e que não emite exceções (noexcept=default) [SWS_CRYPT_50167]. Isso permite a liberação polimórfica segura por meio de ponteiros para a interface. Em termos de estado, um slot pode estar ocupado ou vazio. A ocupação do slot deve ocorrer por meio de interfaces separadas do CryptoProvider, enquanto o esvaziamento é implementado através do método thread-safe Clear() [SWS_CRYPT_30405]. Pergunta Q-72dfcb17eb3e2d25 (aberta)

Diagrama de estados: transições de estado do conteúdo da chave através de Clear() e tratamento de erros. Fontes: [SWS_CRYPT_30405]

Caminho de utilização

O caminho de uso central concentra-se na redefinição ou exclusão controlada do material de chave armazenado:

• Referenciação: o chamador acessa a instância por meio de um ponteiro compartilhado do tipo WriteableKeySlot::Sptr [SWS_CRYPT_50172].
• Chamada de exclusão: ao chamar o método puramente virtual Clear(), inicia-se o processo de exclusão do conteúdo atual do slot de chave [SWS_CRYPT_30405]. Como o método é thread-safe, a chamada também pode ocorrer em contextos concorrentes [SWS_CRYPT_30405].
• Verificação do resultado: a operação retorna um ara::core::Result<void> [SWS_CRYPT_30405]. Se o slot de chave já estivesse previamente vazio ou se o conteúdo tiver sido removido sem erros, o resultado representa um estado de sucesso com valor vazio [SWS_CRYPT_30405].

Cenários de erro

O método Clear() está declarado como seguro contra exceções e noexcept; as situações de erro são transportadas através de ara::core::Result de acordo com o modelo de erros da AUTOSAR Adaptive [SWS_CRYPT_30405]. Os possíveis códigos de erro incluem:

• ara::crypto::CryptoErrc::kUnsupported: Ocorre quando a variante concreta do slot de chave não suporta a eliminação [SWS_CRYPT_30405]. Para este caso, a interface garante uma semântica de rollback, de modo que o estado permanece inalterado [SWS_CRYPT_30405].
• ara::crypto::CryptoErrc::kBusyResource: É retornado caso a operação de eliminação temporariamente não possa ser executada [SWS_CRYPT_30405]. Isto deve ser tipicamente causado por acessos concorrentes a recursos de memória vinculados a hardware. Pergunta (aberta) Também aqui uma semântica de rollback assegura que não permaneçam alterações parciais [SWS_CRYPT_30405].