classe ara::crypto::CryptoException

A classe ara::crypto::CryptoException atua na AUTOSAR Adaptive Platform como exceção especializada para sinalizar erros criptográficos para aplicações chamadoras. Ela deriva de ara::core::Exception e é explicitamente instanciada com um ara::core::ErrorCode em operações com falha [SWS_CRYPT_19906]. Devido à especificação como noexcept e thread-safe, a geração confiável de exceções é garantida mesmo em ambientes concorrentes, sem erros secundários [SWS_CRYPT_19906]. As aplicações devem proteger as chamadas criptográficas adequadamente para evitar exceções não tratadas e interrupções do programa.

mais ›

Contexto

A classe ara::crypto::CryptoException define o tipo central de exceção para estados de erro dentro do módulo criptográfico da AUTOSAR Adaptive Platform. Como especialização da classe de exceção padrão ara::core::Exception, ela estabelece uma ponte entre o retorno baseado em código de erro, usado primariamente na plataforma, e os mecanismos clássicos de tratamento de exceções C++. Ela é aplicada em arquiteturas de sistemas nas quais operações criptográficas falham e esse estado de erro precisa ser propagado pela pilha de chamadas como uma exceção. Os parceiros de interação primários incluem módulos de função e serviços criptográficos, que disparam exceções em caso de erros imprevistos ou verificações explícitas, bem como componentes de aplicação superiores que iniciam processos criptográficos, como criptografia, verificação de assinatura ou gerenciamento de chaves, e interceptam eventuais erros. Por estar ancorada no conceito comum de domínio de erro da plataforma, ara::crypto::CryptoException assegura que erros criptográficos sejam relatados de forma consistente e tipada à lógica da aplicação.

Ciclo de vida

A criação de um objeto de ara::crypto::CryptoException ocorre de forma determinística por meio da passagem de um código de erro do tipo ara::core::ErrorCode para o construtor [SWS_CRYPT_19906]. Esse construtor é declarado como explicit para impedir conversões implícitas de tipo a partir de códigos de erro e possui a especificação noexcept [SWS_CRYPT_19906]. Esta última garante que nenhuma outra exceção possa ser disparada durante a própria construção da exceção, o que aumenta substancialmente a segurança operacional e contra exceções do subsistema criptográfico. De acordo com a especificação, a implementação é classificada como thread-safe [SWS_CRYPT_19906], de modo que instâncias possam ser instanciadas e processadas de forma confiável também em ambientes de execução concorrentes. Em relação à propriedade, a exceção é tipicamente lançada by-value e capturada no bloco de captura como referência constante. Como a classe não gerencia recursos dinâmicos além do código de erro, seu ciclo de vida termina regularmente ao sair do bloco catch de tratamento (interpretação). Pergunta (aberta)

Caminho de utilização

O caminho de uso regular começa dentro de uma operação criptográfica quando surge uma condição de erro que não pode ser resolvida localmente. O módulo identifica a causa do erro com base no domínio de erro criptográfico do arquivo de cabeçalho ara/crypto/common/crypto_error_domain.h e gera um ara::core::ErrorCode correspondente [SWS_CRYPT_19906]. Em seguida, uma instância de ara::crypto::CryptoException é instanciada com esse código de erro [SWS_CRYPT_19906] e sinalizada por meio de uma instrução throw. No lado da aplicação, o componente chamador captura a exceção de forma direcionada por meio de catch (const ara::crypto::CryptoException& e). Como alternativa, a hierarquia de herança também permite a captura polimórfica como ara::core::Exception genérica. Ao consultar o ara::core::ErrorCode contido, a aplicação pode analisar em seguida a causa específica do erro criptográfico e adotar contramedidas adequadas.

Diagrama de sequência: fluxo típico de tratamento de erros e disparo de exceções em operações criptográficas. Fontes: [SWS_CRYPT_19906]

Cenários de erro

Como ara::crypto::CryptoException representa em si o veículo para a sinalização de erros, o foco principal em cenários de erro recai sobre a robustez da geração da exceção. Ao assegurar a segurança de exceção e de threads, bem como a garantia noexcept do construtor, evita-se a ocorrência de exceções secundárias durante um tratamento de erro já ativo [SWS_CRYPT_19906]. Um potencial cenário de erro na lógica da aplicação consiste no fato de um ara::core::ErrorCode passado encapsular domínios de erro inesperados ou não criptográficos; presume-se que a exceção processe o código de erro de forma neutra mesmo assim e o transporte inalterado para o tratador (interpretação). Outro risco em nível de sistema é a omissão da captura da exceção, o que levaria à chamada de std::terminate no ambiente de execução C++. Portanto, componentes chamadores que utilizam APIs sem retorno baseado em códigos de erro precisam proteger chamadas criptográficas sistematicamente com blocos catch correspondentes. Pergunta Q-0bb3376f547ce024 (aberta)