Fornece interfaces e estruturas de dados para representação, configuração e validação de certificados X.509.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: c166465f6ba8ProcedênciaPerguntas em aberto (2)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Fornece interfaces e estruturas de dados para representação, configuração e validação de certificados X.509.
O namespace ara::crypto::x509 fornece interfaces e tipos de dados para o gerenciamento, a definição de uso e a validação de certificados X.509, bem como respostas OCSP na AUTOSAR Adaptive. Por meio do contexto de validação CertificateValidationCtx, caminhos de certificação são verificados de forma parametrizada com base em opções como CertificateValidationOptions[SWS_CRYPT_50107]. O resultado é retornado de forma estruturada por meio de valores de status como CertificateValidationStatus[SWS_CRYPT_40203], sendo que verificações de revogação online ficam inativas por padrão e devem ser explicitamente configuradas.
Contexto
O namespace ara::crypto::x509 disponibiliza as interfaces e tipos de dados centrais para o processamento e a validação de estruturas de certificados X.509 na AUTOSAR Adaptive Platform. O modelo de interface engloba a representação de certificados digitais (Certificate), solicitações de assinatura de certificado (CertSignRequest), Distinguished Names (X509DN) e respostas OCSP (OcspResponse). A instanciação e o gerenciamento desses artefatos criptográficos ocorrem tipicamente por meio da interface de provedor X509Provider (interpretação: o provedor atua como uma fábrica central para objetos X.509). Pergunta Q-449a726a75b1e78d (aberta)
Diagrama de contexto: Interação das interfaces principais para gerenciamento de certificados e validação de caminho. Fontes: [SWS_CRYPT_40101], [SWS_CRYPT_50097]
Caminho de utilização
O fluxo operacional primário no namespace consiste na verificação de caminhos de certificação por meio de CertificateValidationCtx. O comportamento de validação é parametrizado por meio de máscaras de bits do tipo CertificateValidationOptions[SWS_CRYPT_50107]. Por padrão, a verificação de caminho ocorre sem a inclusão de consultas online de status de certificados por meio da opção kOcspOff[SWS_CRYPT_50114]. Caso a validade deva ser verificada online, é possível ativar a verificação de toda a cadeia via kOcspResponseCompleteChain[SWS_CRYPT_50112] ou exclusivamente para o certificado de destino por meio de kOcspResponseTargetOnly[SWS_CRYPT_50113].
Para cenários específicos de verificação, outras opções de validação permitem sobrepor as verificações padrão: limites de validade temporal podem ser ignorados por meio de kIgnoreNotBefore[SWS_CRYPT_50108] e kIgnoreNotAfter[SWS_CRYPT_50109]. Da mesma forma, a avaliação de listas de revogação de certificados (CRL) importadas anteriormente pode ser desativada com kIgnoreCrl[SWS_CRYPT_50111], ou a sinalização de erros em extensões críticas desconhecidas pode ser suprimida via kIgnoreUnknownCriticalExtensions[SWS_CRYPT_50110]. Após a execução da validação, o contexto retorna um objeto de resultado CertificateValidationResult (interpretação: a chamada de validação incorpora o certificado de destino, as opções de verificação e respostas OCSP opcionais, encapsulando o resultado na classe de resultado). Pergunta (aberta)
Diagrama de sequência: Fluxo de uma validação de certificado por meio de contexto de verificação e avaliação do resultado. Fontes: [SWS_CRYPT_50107], [SWS_CRYPT_40203]
Cenários de erro
O resultado de uma verificação de caminho de certificação é detalhado por meio da enumeração CertificateValidationStatus[SWS_CRYPT_40203]. Uma validação bem-sucedida é sinalizada por kValid (= 0). Se a verificação falhar, valores de status específicos indicam a causa exata:
kInvalidSignature (= 1): Uma assinatura dentro do caminho de certificação não pôde ser verificada com sucesso.
kNoPathToTrustedCertificate (= 3): Não foi possível construir um caminho para um certificado raiz classificado como confiável.
kExpired (= 4): O certificado ultrapassou o período de validade (campo notAfter).
kFuture (= 5): O período de validade do certificado ainda não começou, de acordo com o campo notBefore.
kRevoked (= 6): O certificado foi revogado; esse status resulta de CRLs importadas ou de uma verificação OCSP ativa via kOcspResponseCompleteChain ou kOcspResponseTargetOnly.
kUnknownOcspStatus (= 7): Uma resposta OCSP incorporada retorna o estado “unknown” para o certificado.
kUnknownCriticalExtension (= 8): Um certificado contém uma extensão crítica desconhecida que não foi ignorada nem por kIgnoreUnknownCriticalExtensions nem por tratamento prévio de exceção.
Caso consultas de status online sejam processadas no processo de validação, a enumeração OcspResponseStatus[SWS_CRYPT_40001] sinaliza o resultado da consulta de protocolo. Além de uma confirmação de resposta bem-sucedida (kSuccessful = 0), podem ocorrer erros protocolares e do lado do servidor: requisições inválidas (kMalformedRequest = 1), erros internos do emissor (kInternalError = 2), sobrecarga temporária (kTryLater = 3), necessidade de assinatura (kSigRequired = 5) ou falta de autorização (kUnauthorized = 6).
Este guia baseia-se nas especificações da AUTOSAR Adaptive da versão R25-11 para o módulo crypto. Ele foi gerado e curado automaticamente.
KI-gestützte Gruppierung auf Basis der Records und Spezifikationsauszüge; keine Gliederung aus der AUTOSAR-Spezifikation.
Diagrama de classes
Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.
=1 The certificate path validation failed because a signature of a certificate in the path could not be verified.
kNoPathToTrustedCertificate
=3 The certificate path validation failed because no path to a trusted certificate could be found.
kExpired
=4 The certificate path validation failed because a certificate is expired according to the notAfter field.
kFuture
=5 The certificate path validation failed because a certificate is not valid yet according to the notBefore field.
kRevoked
=6 The certificate path validation failed because a certificate has been revoked through a previously imported CRL or through an OCSP response (if OCSP is enabled through kOcspResponseComplete Chain or kOcspResponseTargetOnly)
kUnknownOcspStatus
=7 The certificate path validation failed because a certificate state is ’unknown’ according to an OCSP response (if OCSP is enabled through kOcspResponseCompleteChain or kOcspResponseTarget Only).
kUnknownCriticalExtension
=8 The certificate path validation failed because a certificate contains an unknown critical extension that has not been excluded from validation using the kIgnoreUnknownCriticalExtensions flag or the IgnoreCriticalExtension() function
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · Original em alemão