classe ara::crypto::x509::OcspResponse

A interface ara::crypto::x509::OcspResponse encapsula a resposta de uma consulta OCSP para verificação do estado de certificados no AUTOSAR Adaptive. Tipicamente, os chamadores verificam primeiro o estado da resposta por meio de GetResponseStatus() [SWS_CRYPT_50130] e, em seguida, recuperam os certificados contidos através de GetCertificates() [SWS_CRYPT_50131]. O acesso ocorre de forma segura contra concorrência e exceções por meio de shared smart pointers para instâncias imutáveis (Sptrc) [SWS_CRYPT_40802].

mais ›

Contexto

A interface ara::crypto::x509::OcspResponse encapsula, no módulo crypto da AUTOSAR Adaptive Platform, os dados de uma resposta de acordo com o Online Certificate Status Protocol (OCSP). Sua responsabilidade primária consiste em disponibilizar a aplicações e funções de segurança o estado de validade e revogação de certificados X.509. Ao contrário das listas estáticas de revogação de certificados (CRLs), o OCSP permite uma consulta de estado tempestiva de certificados individuais junto a um serviço de validação.

Na arquitetura de criptografia, a interface atua como fonte de informação para componentes chamadores, como serviços de autenticação ou pilhas de protocolo TLS. Ela fornece métodos para consultar tanto o estado geral da resposta da mensagem OCSP [SWS_CRYPT_50130] quanto para ler os certificados transportados na resposta [SWS_CRYPT_50131]. Dessa forma, parceiros de comunicação podem verificar diretamente a validade de cadeias de certificados.

Ciclo de vida

Como interface puramente virtual, ara::crypto::x509::OcspResponse não define construtores públicos nem métodos de fábrica próprios. A instanciação ocorre tipicamente no nível interno da plataforma por meio dos componentes de driver e provedor da pilha de criptografia, os quais realizam o parse dos dados brutos recebidos da resposta OCSP (interpretação: instâncias concretas são criadas por provedores X.509 subjacentes). Pergunta Q-30d53aa886333cbc (aberta)

Para o repasse e gerenciamento de instâncias, a classe especifica o alias de tipo Sptrc como std::shared_ptr<const OcspResponse> [SWS_CRYPT_40802]. Por meio deste smart pointer, estabelece-se uma posse compartilhada com estrito acesso de leitura. O tempo de vida do objeto é gerenciado pela contagem de referências do shared pointer e termina automaticamente assim que a última referência for liberada.

Em relação à concorrência e tolerância a falhas, os métodos GetResponseStatus [SWS_CRYPT_50130] e GetCertificates [SWS_CRYPT_50131] são declarados como seguros contra exceções (exception safe) e thread-safe (thread-safe). Como por meio de Sptrc [SWS_CRYPT_40802] é concedido exclusivamente acesso constante, múltiplas threads podem acessar a mesma instância de resposta OCSP em paralelo e sem bloqueios externos.

Caminho de utilização

O fluxo típico para avaliação de uma resposta OCSP compreende a verificação do estado e a subsequente recuperação de certificados incorporados:

1. Consultar estado: O chamador invoca inicialmente GetResponseStatus() [SWS_CRYPT_50130]. O método retorna um ara::core::Result<OcspResponseStatus>, que indica se a resposta foi gerada com sucesso ou se ocorreu um erro de protocolo.
2. Verificar resultado: A aplicação verifica o objeto Result. Apenas quando a resposta OCSP estiver indicada como bem-sucedida é que a avaliação de outros dados úteis faz sentido.
3. Obter certificados: Em seguida, a aplicação chama GetCertificates() [SWS_CRYPT_50131]. Neste ponto, é retornado um ara::core::Result<ara::core::Vector<Certificate::Sptrc>> que encapsula todos os certificados contidos na resposta OCSP.
4. Realizar verificação: Os certificados extraídos servem presumivelmente para validar a assinatura da resposta OCSP ou a cadeia de certificados do responder (interpretação: os certificados auxiliam na verificação de autenticidade dos dados OCSP). Pergunta Q-4f4a5f1b72358a1f (aberta)

Diagrama de sequência: Fluxo típico para consulta do estado da resposta OCSP e obtenção dos certificados contidos. Fontes: [SWS_CRYPT_50130], [SWS_CRYPT_50131].

Cenários de erro

Ambos os métodos da interface utilizam ara::core::Result como tipo de retorno síncrono e contêm o identificador noexcept, o que exclui o lançamento de exceções síncronas de C++ [SWS_CRYPT_50130] [SWS_CRYPT_50131].

Para GetResponseStatus() [SWS_CRYPT_50130] e GetCertificates() [SWS_CRYPT_50131], a especificação AUTOSAR explicitamente não define códigos de erro padronizados. Possíveis causas de erro – como erros de parsing ou gargalos de memória internos da plataforma – são reportadas de forma específica da implementação por meio do objeto de erro de ara::core::Result. Aplica-se como pré-condição a existência de um ponteiro válido do tipo OcspResponse::Sptrc [SWS_CRYPT_40802], uma vez que o acesso por ponteiro nulo causaria comportamento indefinido.