classe ara::crypto::cryp::PublicKey

A interface ara::crypto::cryp::PublicKey representa um objeto de chave pública assimétrica geral no módulo crypto e deriva de CryptoObject. Para fins de referência e repasse, a classe disponibiliza o alias de tipo Sptr como std::shared_ptr<PublicKey>, que é incluído por meio do cabeçalho "ara/crypto/cryp/cryobj/public_key.h" [SWS_CRYPT_22701]. Interpretação: as aplicações devem repassar instâncias de PublicKey::Sptr [SWS_CRYPT_22701] a classes de contexto criptográfico para verificação assimétrica ou criptografia. Pergunta (aberta) A vida útil e a liberação da chave pública são totalmente controladas pelo contador de referências do smart pointer compartilhado.

mais ›

Contexto

A classe ara::crypto::cryp::PublicKey define a interface geral para chaves públicas assimétricas (General Asymmetric Public Key interface) dentro do módulo crypto da AUTOSAR Adaptive Platform. De acordo com sua declaração sintática, a classe herda publicamente de CryptoObject. Nessa função, ela atua como tipo base e contrato de interface unificado para todas as estruturas de chave pública assimétrica empregadas em operações criptográficas. Como chave pública, um objeto dessa classe representa a parte matematicamente aberta de um par de chaves assimétricas, destinada a propósitos de verificação ou criptografia e sem parâmetros confidenciais de chave privada. O acesso à definição da interface ocorre por meio do arquivo de cabeçalho #include "ara/crypto/cryp/cryobj/public_key.h" de acordo com [SWS_CRYPT_22701]. Interpretação: como PublicKey deriva diretamente de CryptoObject, a interface deve compartilhar propriedades e convenções comuns para objetos criptográficos da plataforma, enquanto disponibiliza simultaneamente a abstração específica de uma chave assimétrica. Pergunta Q-83979c7ba039e328 (aberta)

Ciclo de vida

Para o gerenciamento e o repasse de instâncias, a classe disponibiliza o alias de tipo Sptr, definido como std::shared_ptr<PublicKey> [SWS_CRYPT_22701]. A propriedade de uma chave pública baseia-se, portanto, em propriedade compartilhada (shared ownership). Isso permite que diferentes componentes do sistema e chamadores façam referência paralela à mesma instância de chave, sem que um proprietário exclusivo tenha de ser obrigatoriamente definido. O ciclo de vida de uma instância de chave concreta é controlado por meio do contador de referências do smart pointer padrão. Assim que a última referência é liberada e o contador atinge zero, ocorre a destruição controlada do objeto. Interpretação: a disponibilização explícita do alias Sptr [SWS_CRYPT_22701] deve indicar que instâncias de PublicKey são normalmente criadas por meio de fábricas ou rotinas de carregamento do módulo criptográfico e passadas diretamente como shared pointer aos usuários, em vez de serem gerenciadas como ponteiros brutos ou objetos de valor. Quanto à concorrência, o referenciamento por meio de std::shared_ptr permite o repasse do ponteiro entre threads, sendo que modificações paralelas tipicamente não ocorrem em uma chave puramente pública, visto que esta atua primordialmente como parâmetro de referência imutável. Pergunta Q-0cdb961ab357bc3b (aberta)

Caminho de utilização

Um caminho de uso típico para ara::crypto::cryp::PublicKey começa com a inclusão do arquivo de cabeçalho correspondente "ara/crypto/cryp/cryobj/public_key.h" [SWS_CRYPT_22701]. Em seguida, a aplicação obtém uma referência ao objeto de chave na forma do smart pointer tipado ara::crypto::cryp::PublicKey::Sptr [SWS_CRYPT_22701]. Esse ponteiro representa o objeto de chave assimétrica pronto para uso. Interpretação: a instância obtida de Sptr [SWS_CRYPT_22701] deve ser passada em etapas posteriores a classes de contexto criptográfico, por exemplo, para verificar assinaturas digitais ou criptografar dados assimetricamente. Pergunta Q-b4800044ca9f058a (aberta) Após a conclusão das operações criptográficas de verificação ou cálculo, o objeto de chave permanece sob propriedade compartilhada para futuros processos de verificação ou é liberado automaticamente assim que o escopo do Sptr local for encerrado. Devido ao encapsulamento como interface abstrata, os chamadores não precisam conhecer os detalhes internos do algoritmo da chave, interagindo por meio da interface unificada de PublicKey.