classe ara::crypto::x509::X509DN

A interface ara::crypto::x509::X509DN serve para o encapsulamento e a disponibilização de um X.509 Distinguished Name como uma estrutura de dados serializável dentro do módulo criptográfico. Por meio do alias Sptrc, a propriedade compartilhada e imutável das instâncias é realizada como std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. O método central ToString() formata o nome completo de acordo com a RFC 4514 e opera de forma thread-safe, bem como sem códigos de erro padronizados [SWS_CRYPT_40411]. Os chamadores recebem o resultado como ara::core::Result<ara::core::String>, o qual deve ser verificado quanto à validade antes do processamento posterior.

mais ›

Contexto

A interface abstrata ara::crypto::x509::X509DN representa, dentro do módulo crypto da AUTOSAR Adaptive Platform, um Distinguished Name (DN) de acordo com o padrão X.509. Por meio da herança de ara::crypto::Serializable, a classe está incorporada na hierarquia de tipos como uma estrutura de dados criptográficos serializável. A tarefa primária da interface consiste em encapsular em nível de software estruturas de nomes de certificados, titulares de certificados (Subjects) ou emissores de certificados (Issuers). Um papel central é assumido pela disponibilização de uma representação de texto padronizada: de acordo com [SWS_CRYPT_40411], o método ToString() exporta o Distinguished Name completo como uma cadeia de caracteres em conformidade com a especificação RFC 4514. Caso o Distinguished Name subjacente inclua atributos não padronizados, utiliza-se o respectivo Object Identifier (OID) para esses atributos [SWS_CRYPT_40411].

Ciclo de vida

Como se trata em ara::crypto::x509::X509DN de uma interface C++ abstrata com métodos puramente virtuais como ToString(), a instanciação não ocorre diretamente por desenvolvedores de aplicações. O payload não especifica nenhum construtor público; a criação de instâncias concretas provavelmente deve ocorrer por meio de componentes de nível superior ou analisadores de certificados (parsers) do subsistema criptográfico. Pergunta Q-108d7589869c7370 (aberta)

Para o acesso compartilhado e de longa duração, a interface define o especificador de tipo Sptrc como um alias para std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. O uso de um shared pointer constante enfatiza o conceito de posse e acesso: instâncias de X509DN são externamente imutáveis (immutable). Múltiplos consumidores podem compartilhar com segurança e sem estado a mesma representação de um Distinguished Name, sem custos adicionais de sincronização em acessos de leitura. Quanto à concorrência, o método central ToString() é explicitamente declarado como thread-safe [SWS_CRYPT_40411]. Chamadas paralelas por meio do mesmo shared pointer ou entre threads distintas são, portanto, permitidas sem locks externos. Além disso, a especificação assegura segurança completa contra exceções (exception safe) para essa chamada [SWS_CRYPT_40411].

Caminho de utilização

O caminho de uso típico concentra-se na leitura e no processamento posterior do Distinguished Name formatado para registro em log, autenticação ou verificação de identidade. Uma aplicação recebe normalmente um ponteiro do tipo ara::crypto::x509::X509DN::Sptrc [SWS_CRYPT_40401].

Nessa instância, o chamador executa o método ToString() [SWS_CRYPT_40411]. A chamada ocorre noexcept e retorna um ara::core::Result<ara::core::String> [SWS_CRYPT_40411]. Em caso de avaliação bem-sucedida, o objeto Result contém a cadeia de caracteres formatada de acordo com a RFC 4514, por exemplo, na forma padronizada de pares atributo-valor como CN=... ou utilizando OIDs em atributos proprietários [SWS_CRYPT_40411]. A aplicação pode subsequentemente extrair a string resultante e reutilizá-la para verificações específicas da aplicação, comparações ou logs de auditoria.

Cenários de erro

Na interação com ara::crypto::x509::X509DN, o tratamento de erros destaca-se por um design claro e minimalista. Embora ToString() utilize o tipo de retorno ara::core::Result<ara::core::String>, a especificação estabelece explicitamente que a função não define códigos de erro padronizados [SWS_CRYPT_40411]. Isso significa que, no contexto regular da especificação, não estão previstos motivos técnicos de recusa ou erros de validação para o processo de serialização.

Dado que a função também está especificada como noexcept e como exception safe [SWS_CRYPT_40411], excluem-se exceções síncronas de C++. Se, ainda assim, ocorrerem estados de erro no ara::core::Result retornado, estes deverão dever-se provavelmente a causas específicas da plataforma ou da implementação, tais como escassez de memória na alocação da cadeia de carateres de resultado. Pergunta Q-10477dd7d77e3b78 (aberta) Por conseguinte, os chamadores têm de verificar sempre, antes de desempacotar o valor, se o Result contém um valor válido ou um erro, mesmo que a AUTOSAR não defina constantes de erro específicas de domínio para o efeito.