classe ara::diag::ClientAuthentication

Uso e chamada

A função ara::diag::ClientAuthentication::Authenticate é chamada por uma aplicação para comunicar à instância do Diagnostic Server a autenticação bem-sucedida de um cliente de diagnóstico [SWS_DM_01142]. Isso pode ocorrer após uma autenticação por meio das interfaces do Diagnostic Server ou por meio de mecanismos próprios da aplicação [SWS_DM_01142].

Como parâmetro de entrada, a função recebe userRoles (do tipo ara::core::Vector<DiagnosticAuthRole>). Em caso de chamada bem-sucedida, o status de autenticação da instância muda para kAuthenticated e as funções de usuário passadas são adotadas em definitivo [SWS_DM_01206]. Como valor de retorno, ela fornece um ara::core::Result<ClientAuthenticationHandle> [SWS_DM_01142]. Como um objeto Result é disponibilizado imediatamente, presume-se que o processamento ocorra de forma síncrona no contexto chamador. Pergunta Q-dae22c82694f2103 (aberta)

Tratamento de erros e simultaneidade

O método está declarado como noexcept e é considerado seguro contra exceções (exception safe) [SWS_DM_01142]. Se ocorrer um erro devido à indisponibilidade de funcionalidades fundamentais do Diagnostic Manager no momento da chamada, a operação falha com semântica de rollback e retorna DiagErrc::kServiceNotAvailable no objeto Result [SWS_DM_01142].

Em relação à concorrência, o método está expressamente especificado como not thread-safe [SWS_DM_01142]. Chamadas paralelas no mesmo objeto ClientAuthentication são, portanto, inadmissíveis e devem ser sincronizadas pela aplicação.

Zusammenspiel e ciclo de vida

O ClientAuthenticationHandle obtido permite à aplicação definir ou estender uma DynamicAccessList para o cliente autenticado [SWS_DM_01142]. Além disso, a chamada inicia ou referencia o monitoramento de inatividade do cliente: se, após uma autenticação bem-sucedida no estado de sessão padrão, nenhuma outra solicitação UDS ocorrer pela duração de authenticationTimeout, a instância do Diagnostic Server redefine automaticamente o cliente de volta para kDeAuthenticated [SWS_DM_01210]. Para prevenir este timeout, a aplicação pode atualizar o temporizador por meio do método Refresh do handle [SWS_DM_01155].

Com o método síncrono OverrideDefaultRoles da classe ara::diag::ClientAuthentication, uma aplicação pode sobrepor temporariamente as funções de autenticação padrão (defaultRoles) de um cliente de diagnóstico [SWS_DM_01141]. Os serviços de diagnóstico liberados para as funções passadas ficam disponíveis para o testador pelo período de tempo definido no parâmetro timeout [SWS_DM_01141]. O pré-requisito para isso é que o cliente esteja no estado kDeAuthenticated [SWS_DM_01209]. Interpretação: se a chamada não ocorrer no estado kDeAuthenticated, presume-se que a sobreposição de funções seja rejeitada ou permaneça sem efeito, uma vez que a especificação prescreve o comportamento exclusivamente para este estado inicial. Pergunta Q-81189f2c2fe0f301 (aberta)

Em caso de execução bem-sucedida, o método retorna uma instância de ClientAuthenticationHandle dentro de um ara::core::Result para a aplicação [SWS_DM_01141], [SWS_DM_01209]. Se a chamada não puder ser executada porque funcionalidades essenciais do Diagnostic Manager não estão disponíveis no momento, o código de erro DiagErrc::kServiceNotAvailable é retornado [SWS_DM_01141]. A função está declarada como noexcept e é segura contra exceções (exception safe) [SWS_DM_01141].

Para a concorrência e a interação com outros componentes aplicam-se as seguintes diretrizes:

• Concorrência: O método está especificado como not thread-safe [SWS_DM_01141]. Chamadas paralelas na mesma instância devem ser sincronizadas pelo lado da aplicação.
• Gerenciamento de handles: Por meio da instância retornada de ClientAuthenticationHandle, o temporizador em execução pode ser prolongado com Refresh() [SWS_DM_01155]. Além disso, o handle possibilita o gerenciamento da DynamicAccessList para recursos de diagnóstico adicionais AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle».

usar

O método [SWS_DM_01144] da classe ara::diag::ClientAuthentication serve para a aplicação registar uma função de callback do tipo ClientAuthenticationSetNotifier. Esta é chamada pela instância do Diagnostic Server assim que o estado de autenticação de um cliente se altera [SWS_DM_01144]. Isto permite à aplicação reagir imediatamente a mudanças de estado, por exemplo, quando ocorre uma transição automática para o estado kDeAuthenticated após um timeout de servidor S3 [SWS_DM_01211] ou ocorre um timeout devido a inatividade do cliente [SWS_DM_01210].

Tratamento de erros e valor de retorno

A função devolve um ara::core::Result<void> e está declarada como noexcept, bem como segura em termos de exceções (exception safe) [SWS_DM_01144]. Não estão especificados códigos de erro normalizados [SWS_DM_01144]; presumivelmente, o objeto Result fornece sempre sucesso (void) em funcionamento regular. Pergunta Q-0d7d43cc37d57944 (aberta)

Concorrência e interação

No que diz respeito à segurança entre threads, o método está especificado como «not thread-safe» [SWS_DM_01144]. As chamadas na mesma instância não devem, por conseguinte, ser realizadas de forma desprotegida a partir de threads concorrentes. Além disso, aplica-se um comportamento de sobreposição ao registo: uma nova chamada a SetNotifier substitui completamente o notificador anteriormente registado [SWS_DM_01144]. Este comportamento corresponde ao padrão de registo uniforme no Diagnostic Management, tal como definido analogamente para [SWS_DM_00615] (CancellationHandler), [SWS_DM_00745] (Indicator) e [SWS_DM_00755] (OperationCycle).

O destrutor [SWS_DM_01136] da classe ara::diag::ClientAuthentication serve para a libertação e o desmantelamento limpo de uma instância para autenticação de clientes no Diagnostic Management. A função está definida no ficheiro de cabeçalho #include "ara/diag/client_authentication.h" e é chamada de forma síncrona no fim do tempo de vida do objeto (AUTOSAR_AP_SWS_Diagnostics §8.5.1.2.1.2 «Destructor»).

Para a utilização e propriedades de execução aplicam-se as seguintes determinações:

• Chamada e parâmetros: Como destrutor, ~ClientAuthentication() não possui parâmetros de entrada nem valor de retorno.
• Segurança contra erros e exceções: A operação está especificada como noexcept e exception safe [SWS_DM_01136]; durante a destruição do objeto é garantido que não são lançadas quaisquer exceções.
• Concorrência: A chamada está expressamente classificada como not thread-safe. Consequentemente, a destruição do objeto não pode ocorrer de forma concorrente a outras chamadas de métodos da mesma instância.

O elemento implementa o requisito upstream RS_Diag_04251 (AUTOSAR_AP_SWS_Diagnostics §8.5.1.2.1.2 «Destructor»). Interpretação: antes de destruir a instância, os procedimentos ativos de autenticação ou de comunicação da aplicação deverão ter de ser terminados de forma ordenada, a fim de evitar comportamento indefinido resultante da falta de segurança de threads. Pergunta Q-cedd6f523eb2c1c3 (aberta)