clase ara::diag::ClientAuthenticationHandle

El método Append de la clase ara::diag::ClientAuthenticationHandle es utilizado por las aplicaciones para anexar una lista de acceso dinámica (dynamicAccessList) a la DynamicAccessList ya existente de una conversación de diagnóstico activa [SWS_DM_01152]. La interfaz se proporciona mediante la cabecera ara/diag/client_authentication_handle.h AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.3.1 «Append».

La llamada se ejecuta de forma síncrona y está especificada como noexcept [SWS_DM_01152]. Como parámetro de entrada, la función recibe una DiagnosticServiceDynamicAccessList. El tipo de retorno ara::core::Result<void> señala la finalización satisfactoria o, en caso de fallo, transporta el código de error DiagErrc::kServiceNotAvailable [SWS_DM_01152]. Este último indica que funciones esenciales de Diagnostic Management no están disponibles actualmente. Para este caso de fallo rige una semántica de rollback, de modo que se conserva el estado previo de la lista de acceso [SWS_DM_01152].

En relación con la concurrencia, la operación se considera segura frente a excepciones (exception safe), pero está clasificada expresamente como no segura para hilos (not thread-safe) [SWS_DM_01152]. En caso de accesos paralelos al mismo objeto handle, es probable que se requiera una sincronización externa por parte de la aplicación invocadora. Pregunta Q-f0da9a0538a86a16 (abierta)

El constructor por defecto síncrono [SWS_DM_01146] crea una instancia de la clase ara::diag::ClientAuthenticationHandle. La llamada no recibe parámetros de transferencia y no devuelve ningún valor. La función está declarada como noexcept y especificada como segura para subprocesos (thread-safe) y segura frente a excepciones [SWS_DM_01146], por lo que no se producen códigos de error ni excepciones durante la creación.

Para la transmisión y el ciclo de vida del objeto creado se aplican las siguientes restricciones:

• La construcción de copia y la asignación de copia están explícitamente eliminadas ([SWS_DM_01150], [SWS_DM_01151]).
• Se admiten el constructor de movimiento [SWS_DM_01148] y el operador de asignación de movimiento [SWS_DM_01149].
• Todos los métodos de instancia como Set [SWS_DM_01153], Append [SWS_DM_01152], Revoke [SWS_DM_01154], así como el destructor [SWS_DM_01147], están definidos como no seguros para subprocesos (not thread-safe).

En el sistema global, el Diagnostic Server proporciona de forma regular handles activos vinculados a un cliente a través de Authenticate [SWS_DM_01142] o OverrideDefaultRoles [SWS_DM_01141] (AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»). Por lo tanto, un ejemplar creado mediante el constructor por defecto debería servir como marcador de posición no vinculado que solo recibe un handle válido para controlar las listas de acceso tras una posterior asignación de movimiento [SWS_DM_01149]. Pregunta Q-ce182402bd1d4072 (abierta)

El método Refresh de la clase ara::diag::ClientAuthenticationHandle (archivo de cabecera #include "ara/diag/client_authentication_handle.h") sirve para que una aplicación prolongue temporizadores activos de autenticación o de rol (AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.3.2 «Refresh»). Restablece el temporizador iniciado previamente por Authenticate o OverrideDefaultRoles. Si antes se llamaron ambos métodos, mediante la llamada se renuevan ambos temporizadores simultáneamente [SWS_DM_01155].

La llamada síncrona (interpretación: retorno directo sin futuro asíncrono) se realiza sin parámetros sobre una instancia existente de ClientAuthenticationHandle, la cual ha recibido la aplicación desde el servidor de diagnóstico tras la finalización exitosa de Authenticate o OverrideDefaultRoles (AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»). Pregunta Q-b07e81ff4629ada7 (abierta) La función está declarada como noexcept y es segura frente a excepciones (exception safe), pero está especificada como no segura para subprocesos (not thread-safe) [SWS_DM_01155]. Por lo tanto, las llamadas concurrentes en la misma instancia deben ser sincronizadas por el invocador.

Si la operación falla, la función devuelve el código de error DiagErrc::kServiceNotAvailable mediante ara::core::Result<void> [SWS_DM_01155]. Esto indica mediante semántica de reversión que la llamada no se pudo ejecutar porque funcionalidades esenciales de Diagnostic Management (DM) no están disponibles en ese momento [SWS_DM_01155].

El método síncrono Revoke de la clase ara::diag::ClientAuthenticationHandle (SWS Diagnostics §8.6.1.1.3.3 «Revoke») sirve para que las aplicaciones desautentiquen un cliente de diagnóstico previamente autenticado y descarten por completo su lista de acceso dinámica (DynamicAccessList) y los roles estándar sobrescritos ([SWS_DM_01154], [SWS_DM_01216]).

La función carece de parámetros de transferencia y devuelve un ara::core::Result<void> ([SWS_DM_01154]). En caso de éxito, finaliza el estado de autenticación del cliente. Si una funcionalidad esencial del Diagnostic Manager no está disponible en el momento de la llamada, la operación falla y devuelve el error DiagErrc::kServiceNotAvailable con semántica de rollback ([SWS_DM_01154]).

En cuanto a la concurrencia, la interfaz está especificada como segura frente a excepciones (exception safe), pero como no segura para hilos (not thread-safe) ([SWS_DM_01154]). Interpretación: En caso de accesos concurrentes a la misma instancia de handle desde varios hilos, es probable que la aplicación invocadora deba garantizar una sincronización externa. Pregunta Q-8781261c9a2f5f8e (abierta)

En el flujo global, la instancia de ClientAuthenticationHandle se proporciona a la aplicación tras una autenticación satisfactoria o tras la sobrescritura de roles estándar por parte de la instancia de Diagnostic Server (SWS Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»). Mientras que el handle activo permite, además de la revocación, la sustitución ([SWS_DM_01213]) o ampliación ([SWS_DM_01215]) de la DynamicAccessList, Revoke pone fin de forma definitiva a estas autorizaciones del cliente.

El método síncrono Set de la clase ara::diag::ClientAuthenticationHandle ([SWS_DM_01153]) sirve para que una aplicación establezca o sustituya por completo la lista de acceso dinámica (DynamicAccessList) para una conversación de diagnóstico o para un cliente autenticado en el Diagnostic Server ([SWS_DM_01213]). El Diagnostic Manager mantiene para cada cliente autenticado una DynamicAccessList de este tipo, la cual puede conceder al cliente derechos de acceso adicionales a recursos de diagnóstico más allá de la configuración depositada en el Diagnostic Extract (AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 «ClientAuthenticationHandle»).

En su utilización son determinantes los siguientes aspectos:

• Contexto de invocación y parámetros: La función se invoca sobre una instancia de ara::diag::ClientAuthenticationHandle (declarada en #include "ara/diag/client_authentication_handle.h"). Dicha instancia de handle se proporciona a la aplicación cuando con anterioridad ha concluido con éxito bien ara::diag::ClientAuthentication::Authenticate ([SWS_DM_01206]) o bien ara::diag::ClientAuthentication::OverrideDefaultRoles ([SWS_DM_01209]). Como único parámetro de transferencia se pasa dynamicAccessList de tipo DiagnosticServiceDynamicAccessList, la cual define la nueva lista de acceso ([SWS_DM_01153]).
• Valor de retorno y tratamiento de errores: El método está especificado como noexcept y devuelve un ara::core::Result<void>. Opera con semántica de rollback: si la invocación no puede ejecutarse porque la funcionalidad esencial de DM no está disponible actualmente, la llamada falla con el código de error DiagErrc::kServiceNotAvailable ([SWS_DM_01153]). Respecto al tratamiento de excepciones, el método está catalogado como seguro frente a excepciones (exception safe).
• Concurrencia: La operación está definida explícitamente como no segura para hilos (not thread-safe) ([SWS_DM_01153]). Si se realizan llamadas concurrentes sobre la misma instancia de handle desde múltiples hilos, la sincronización necesaria recae sobre la aplicación.

Uso y semántica

La función ~ClientAuthenticationHandle() es el destructor de la clase ara::diag::ClientAuthenticationHandle y se declara a través del archivo de cabecera ara/diag/client_authentication_handle.h ([SWS_DM_01147], AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.1.3 «Destructor»). No recibe parámetros de entrada ni proporciona valor de retorno. La invocación tiene lugar habitualmente de forma implícita al finalizar la vida útil del objeto. Interpretación: Durante este proceso es de prever que se liberen todos los recursos de la autenticación de cliente vinculados internamente por el handle. Pregunta Q-ea8f47232fd9951f (abierta)

Tratamiento de errores y seguridad frente a excepciones

El destructor está declarado como noexcept y especificado explícitamente como exception safe ([SWS_DM_01147]). Por consiguiente, durante la destrucción del objeto no se lanzan excepciones de C++ ni se notifican códigos de error específicos, garantizando así que el procedimiento de limpieza concluya sin fallos.

Concurrencia y restricciones

La destrucción de un ClientAuthenticationHandle está catalogada según la especificación como not thread-safe ([SWS_DM_01147]). La aplicación invocadora debe asegurarse de que ningún otro hilo acceda en paralelo a la misma instancia mientras se ejecuta el destructor.