classe ara::crypto::cryp::PrivateKey

A interface ara::crypto::cryp::PrivateKey define a interface geral para chaves privadas assimétricas no AUTOSAR Adaptive e é gerenciada primariamente por meio do alias de ponteiro compartilhado PrivateKey::Sptr [SWS_CRYPT_22501]. Sua função central GetPublicKey() permite obter a chave pública correspondente como PublicKey::Sptr para disponibilizá-la a operações criptográficas parceiras [SWS_CRYPT_22511]. Essa obtenção é especificada como thread-safe, bem como segura contra exceções sem códigos de erro padronizados, sendo que eventuais erros provavelmente devem ser sinalizados de forma específica da implementação por meio do tipo de retorno ara::core::Result (interpretação). Pergunta (aberta)

mais ›

Contexto

A interface ara::crypto::cryp::PrivateKey atua na AUTOSAR Adaptive Platform como uma interface generalizada para chaves privadas assimétricas dentro do módulo crypto. Ela é declarada no arquivo de cabeçalho ara/crypto/cryp/cryobj/private_key.h e deriva diretamente da interface base CryptoObject. Como componente central do sistema de criptografia assimétrica, PrivateKey encapsula o material de chave confidencial, necessário para operações criptográficas como a geração de assinaturas digitais ou processos de decifração assimétrica.

Entre os parceiros de interação primários estão, além da classe base CryptoObject, especialmente a interface correspondente de chave pública PublicKey, bem como serviços criptográficos consumidores e rotinas de aplicação. Enquanto a chave privada deve sempre ser mantida em segredo, a interface possibilita a disponibilização direta da chave pública associada por meio da função-membro GetPublicKey() [SWS_CRYPT_22511]. Dessa forma, realiza-se uma relação fixa relacionada ao tipo entre a chave privada e sua contraparte matemática.

Diagrama de contexto: incorporação de PrivateKey no modelo de objetos criptográficos e relação com a PublicKey correspondente. Fontes: [SWS_CRYPT_22501], [SWS_CRYPT_22511]

Ciclo de vida

O gerenciamento e a passagem de instâncias da interface PrivateKey ocorrem por meio do smart pointer tipado PrivateKey::Sptr, definido como alias de tipo para std::shared_ptr<PrivateKey> [SWS_CRYPT_22501]. Esse shared pointer assegura propriedade compartilhada e gerenciamento automático de recursos por contagem de referências, de modo que o material de chave protegido é liberado assim que a última referência expira.

Como PrivateKey representa uma interface abstrata com métodos puramente virtuais como GetPublicKey() [SWS_CRYPT_22511], as aplicações não podem instanciar a classe diretamente. A criação e disponibilização de instâncias concretas de PrivateKey::Sptr presumivelmente devem ocorrer por meio de fábricas especializadas, componentes de gerenciamento de chaves ou provedores criptográficos do sistema Adaptive (interpretação). Pergunta Q-f0f9fe2258fac168 (aberta) A interface em si não define estados discretos internos ou transições de estado.

Em relação à concorrência, a interface especifica explicitamente segurança de threads (thread-safe) para a função-membro central GetPublicKey() [SWS_CRYPT_22511]. Isso permite a múltiplos fluxos de execução o acesso simultâneo de leitura, livre de sincronização, à mesma instância de chave para a obtenção da chave pública correspondente.

Caminho de utilização

O caminho de uso típico de PrivateKey compreende o recebimento da chave privada e a subsequente extração da chave pública correspondente para fins de validação, registro ou comunicação:

1. Obtenção da chave: O componente de software consumidor recebe uma instância válida de uma chave privada assimétrica na forma de um PrivateKey::Sptr [SWS_CRYPT_22501].
2. Consulta da chave parceira: Quando a chave pública correspondente é necessária para um fluxo de trabalho posterior, o componente chama a função-membro GetPublicKey() na instância [SWS_CRYPT_22511].
3. Processamento do resultado: A chamada retorna um ara::core::Result<PublicKey::Sptr> [SWS_CRYPT_22511]. A aplicação verifica o objeto de resultado quanto ao sucesso e, em caso de execução bem-sucedida, desempacota o ponteiro PublicKey::Sptr.
4. Reutilização: A chave pública obtida pode ser subsequentemente transmitida a parceiros de comunicação externos ou repassada a rotinas de verificação locais. A derivação da chave pública internamente deve ocorrer, presumivelmente, de forma direta a partir dos parâmetros matemáticos de chave da chave privada (interpretação). Pergunta Q-464000dc5d638649 (aberta)

Cenários de erro

Para uma integração livre de erros, as propriedades de erro e as condições de contorno de GetPublicKey() são determinantes:

• Erros padronizados: De acordo com a especificação, a função GetPublicKey() não define códigos de erro padronizados [SWS_CRYPT_22511].
• Canal de erro: Embora nenhum erro padronizado esteja definido, o tipo de retorno ara::core::Result transporta falhas potenciais. Caso ocorra um erro durante a derivação interna de chave ou na criação de objeto, o objeto de resultado provavelmente deve conter códigos de erro específicos da implementação provenientes dos drivers criptográficos subjacentes (interpretação). Pergunta Q-4af6390594d9c5e1 (aberta)
• Segurança contra exceções: A função é explicitamente classificada como segura contra exceções (exception safe) e acompanhada pelo identificador noexcept [SWS_CRYPT_22511]. Os chamadores, portanto, não precisam capturar exceções de C++.
• Pré- e pós-condições: A pré-condição para a chamada bem-sucedida é uma instância válida e não liberada de PrivateKey. Como pós-condição, a interface garante, em caso de sucesso, o retorno de um PublicKey::Sptr que corresponde matematicamente com exatidão à chave privada [SWS_CRYPT_22511].