클래스 ara::diag::ClientAuthenticationHandle

[SWS_DM_01145] Upstream: RS_Diag_04251

class ClientAuthenticationHandle final {...};

Definition of the ClientAuthenticationHandle which is returned to the application when an AuthenticationState is set by the application.

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Forwarding-Header	#include "ara/diag/diag_fwd.h"
Scope	namespace ara::diag

사용자 가이드AI 생성

진단 클라이언트의 동적 진단 권한, 세션 타이머 및 인증 철회를 관리합니다.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: ceee534cb2db 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

진단 클라이언트의 동적 진단 권한, 세션 타이머 및 인증 철회를 관리합니다.

ara::diag::ClientAuthenticationHandle 클래스는 애플리케이션이 진단 클라이언트의 활성 인증 세션을 관리하는 데 사용됩니다[SWS_DM_01206]. 애플리케이션은 이 핸들을 통해 동적 액세스 목록을 구성하고 클라이언트의 비활성 타이머를 갱신합니다[SWS_DM_01213]. 이 객체는 복사 기능 없이 엄격한 이동 시맨틱을 따르며, 진단 관리를 사용할 수 없는 경우 DiagErrc::kServiceNotAvailable을 통해 오류를 보고합니다. Revoke 호출을 통해 부여된 역할 및 추가 권한을 언제든지 제어된 방식으로 철회할 수 있습니다.

컨텍스트

API 클래스 ara::diag::ClientAuthenticationHandle은 헤더 파일 ara/diag/client_authentication_handle.h에 정의되어 있습니다[SWS_DM_01145]. 이 클래스는 클라이언트가 성공적으로 인증되었거나 클라이언트의 기본 역할이 일시적으로 재정의되었을 때 Diagnostic Server 인스턴스에 의해 진단 애플리케이션에 제공되는 중앙 제어 객체 역할을 합니다AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 “ClientAuthenticationHandle”.

시스템 시작 시 클라이언트는 사전 구성된 기본 역할을 가진 채 기본적으로 kDeAuthenticated 상태에 있습니다[SWS_DM_01205], [SWS_DM_01204]. 애플리케이션이 ara::diag::ClientAuthentication::Authenticate을 호출하면 Diagnostic Server는 클라이언트를 kAuthenticated 상태로 전환하고 ara::diag::ClientAuthenticationHandle를 반환합니다[SWS_DM_01206]. 마찬가지로 역할을 일시적으로 조정하기 위해 ara::diag::ClientAuthentication::OverrideDefaultRoles을 호출할 때도 이러한 핸들이 생성됩니다[SWS_DM_01209]. 애플리케이션은 핸들을 통해 인증 상태와 동적 액세스 목록(DynamicAccessList)을 제어하며, 이 목록은 인증된 클라이언트에게 진단 익스트랙트 이외의 진단 리소스에 대한 추가 접근 권한을 부여합니다AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 “ClientAuthenticationHandle”.

컨텍스트 다이어그램: 애플리케이션, ClientAuthenticationHandle 및 Diagnostic Server의 상호작용. 출처: [SWS_DM_01206], [SWS_DM_01209], AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 “ClientAuthenticationHandle”

수명 주기

ara::diag::ClientAuthenticationHandle의 인스턴스화는 일반적으로 Authenticate [SWS_DM_01206] 또는 OverrideDefaultRoles [SWS_DM_01209] 과정에서 Diagnostic Server의 팩토리 메서드에 의해 수행됩니다. 또한 이 클래스는 매개변수가 없는 기본 생성자를 제공합니다[SWS_DM_01146]. 이렇게 생성된 객체는 이동 할당을 통해 활성 핸들이 전달될 때까지 바인딩되지 않은 플레이스홀더 역할을 할 것으로 추정됩니다. 질문 Q-74f44c072616cce9 (열림)

소유권과 관련하여 이 클래스는 엄격한 이동 시맨틱을 구현합니다. 이동 생성자 [SWS_DM_01148] 및 이동 할당 연산자 [SWS_DM_01149]은 noexcept = default로 정의됩니다. 복사 생성자 [SWS_DM_01150] 및 복사 할당 연산자 [SWS_DM_01151]가 삭제(=delete)되었으므로 복사는 완전히 금지됩니다. 인스턴스 해제는 소멸자 ~ClientAuthenticationHandle()을 통해 이루어집니다[SWS_DM_01147].

동시성과 관련하여 기본 생성자는 스레드 안전(thread-safe)으로 명시되어 있습니다[SWS_DM_01146]. 반면 소멸자 [SWS_DM_01147] 및 상태를 변경하는 모든 메서드 호출은 스레드 안전하지 않은 것(not thread-safe)으로 표시되어 있습니다[SWS_DM_01152], [SWS_DM_01153], [SWS_DM_01154], [SWS_DM_01155]. 따라서 동일한 핸들에 대한 동시 접근에는 애플리케이션 측 동기화가 필요합니다.

사용 경로

런타임의 일반적인 흐름에는 동적 권한 구성, 권한 부여 유지 관리 및 제어된 종료가 포함됩니다:

핸들 획득: 애플리케이션은 ara::diag::ClientAuthentication에 대한 인증을 시작하고 핸들 인스턴스를 수신합니다[SWS_DM_01206].
액세스 목록 설정 또는 확장: 애플리케이션은 Set 메서드를 통해 진단 대화의 동적 액세스 목록을 완전히 교체합니다[SWS_DM_01153], [SWS_DM_01213]. 또는 Append을 통해 기존 액세스 목록에 추가 진단 패턴을 추가합니다[SWS_DM_01152], AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.4 “DynamicAccessList Creation and Update”.
활동 갱신: 기본 세션에서 비활성 상태가 지속되면 비활성 타임아웃 경과 후 kDeAuthenticated 상태로 자동 폴백될 위험이 있습니다[SWS_DM_01210]. 애플리케이션은 Refresh를 호출하여 Authenticate 또는 OverrideDefaultRoles에 의해 시작된 타이머를 연장합니다[SWS_DM_01155], AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 “ClientAuthenticationHandle”.
권한 철회: 애플리케이션은 Revoke을 사용하여 클라이언트를 명시적으로 인증 해제하고, 연관된 DynamicAccessList을 삭제하며, 재정의된 기본 역할을 재설정합니다[SWS_DM_01154].

시퀀스 다이어그램: 핸들을 통한 인증, 권한 관리 및 철회 절차. 출처: [SWS_DM_01206], [SWS_DM_01153], [SWS_DM_01155], [SWS_DM_01154]

오류 시나리오

작동 메서드인 Set [SWS_DM_01153], Append [SWS_DM_01152], Refresh [SWS_DM_01155] 및 Revoke [SWS_DM_01154]은 각각 ara::core::Result<void>을 반환하며 noexcept 및 예외 안전(exception safe)으로 선언되어 있습니다.

Diagnostic Manager의 필수 기능을 현재 사용할 수 없어 통신이나 실행이 실패하는 경우, 호출은 오류 코드 DiagErrc::kServiceNotAvailable을 반환합니다[SWS_DM_01152], [SWS_DM_01153], [SWS_DM_01154], [SWS_DM_01155]. 이 경우 롤백 시맨틱이 적용되므로 클라이언트의 인증 상태나 액세스 목록에 불일치하는 부분적 변경 사항이 남지 않습니다.

AUTOSAR Adaptive R25-11 진단 인터페이스 사양을 기반으로 합니다.

멤버 맵

클래스 다이어그램

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

상세 보기

개요에서 항목을 선택하세요.

이 릴리스에 대한 요소 데이터가 없습니다

생성자 및 소멸자

ClientAuthenticationHandle 함수 3

Constructor of ClientAuthenticationHandle.

오버로드 ClientAuthenticationHandle 3

ClientAuthenticationHandle () noexcept; SWS_DM_01146

ClientAuthenticationHandle (ClientAuthenticationHandle &&other) noexcept=default; SWS_DM_01148

ClientAuthenticationHandle (ClientAuthenticationHandle const &other)=delete; SWS_DM_01150

~ClientAuthenticationHandle 함수

Destructor of ClientAuthenticationHandle.

~ClientAuthenticationHandle () noexcept;

메서드

Append 함수

This function is used by the application to append a DynamicAccessList to the already existing DynamicAccessList of a Diagnostic Conversation.

ara::core::Result< void > Append (DiagnosticServiceDynamicAccessList dynamicAccessList) noexcept;

Refresh 함수

This function is used by the application to refresh the timer that was started by Authenticate or OverrideDefaultRoles. If both Methods were previously called, both timers are refreshed.

ara::core::Result< void > Refresh () noexcept;

Revoke 함수

This function is used by the application to de-authenticate a client, and also to clear the Dynamic AccessList and any overridden defaults.

ara::core::Result< void > Revoke () noexcept;

Set 함수

This function is used by the application to set/replace a DynamicAccessList of a Diagnostic Conversation.

ara::core::Result< void > Set (DiagnosticServiceDynamicAccessList dynamicAccessList) noexcept;

연산자

operator= 함수 2

Move assignment operator of ClientAuthenticationHandle.

오버로드 = 2

auto operator= (ClientAuthenticationHandle &&other) & noexcept -> ClientAuthenticationHandle & =default; SWS_DM_01149

auto operator= (ClientAuthenticationHandle const &other) -> Client AuthenticationHandle &=delete; SWS_DM_01151

항목을 클릭하면 관계가 표시됩니다.

메서드 문서

함수 Append [SWS_DM_01152] Upstream: RS_Diag_04251

ara::core::Result< void > Append (DiagnosticServiceDynamicAccessList dynamicAccessList) noexcept;

This function is used by the application to append a DynamicAccessList to the already existing DynamicAccessList of a Diagnostic Conversation.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: ecc404bb2530 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::diag::ClientAuthenticationHandle 클래스의 메서드 Append은(는) 애플리케이션이 활성 진단 대화의 이미 존재하는 DynamicAccessList에 동적 접근 목록(dynamicAccessList)을 추가하는 데 사용됩니다 [SWS_DM_01152]. 이 인터페이스는 헤더 ara/diag/client_authentication_handle.h을(를) 통해 제공됩니다 AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.3.1 “Append”.

호출은 동기식으로 실행되며 noexcept(으)로 지정됩니다 [SWS_DM_01152]. 입력 매개변수로 함수는 DiagnosticServiceDynamicAccessList을(를) 받습니다. 반환 타입 ara::core::Result<void>은(는) 성공적인 완료를 알리거나, 오류 발생 시 오류 코드 DiagErrc::kServiceNotAvailable을(를) 전달합니다 [SWS_DM_01152]. 후자는 Diagnostic Management의 필수 기능을 현재 사용할 수 없음을 나타냅니다. 이 오류 사례에는 롤백 의미론이 적용되므로 접근 목록의 이전 상태가 유지됩니다 [SWS_DM_01152].

동시성과 관련하여 이 작업은 예외 안전(exception safe)한 것으로 간주되지만, 명시적으로 스레드 안전하지 않음(not thread-safe)으로 분류됩니다 [SWS_DM_01152]. 따라서 동일한 핸들 객체에 병렬로 접근하는 경우 호출 애플리케이션에 의한 외부 동기화가 필요할 것으로 보입니다. 질문 Q-f0da9a0538a86a16 (열림)

이 사용 지침은 자동으로 생성되었으며 전적으로 AUTOSAR R25-11의 사양 데이터에 기반합니다.

구현자 가이드 준비 중 (복잡도 I1)

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Parameter (in)

Parameter	Beschreibung
dynamicAccessList	The DynamicAccessList to be appended in the client.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Returns nothing or an error.

Fehler

Fehlercode	Beschreibung
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01152
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01152@rel:R25-11#5f757189
Content hash: 5f757189
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01152

Status: valid/unmigrated Version: rel:R25-11#760cf1a2 Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01152@rel:R25-11#760cf1a2

Recorded Revisions (6):

R25-11rel:R25-11#5fbe369d2026-09-30
R21-11rel:R21-11#fe6687392026-10-14
R22-11rel:R22-11#4d5753f62026-10-14
R23-11rel:R23-11#85d630192026-10-14
R24-11rel:R24-11#e44623a72026-10-14
R25-11rel:R25-11#760cf1a22026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 ClientAuthenticationHandle [SWS_DM_01146] Upstream: RS_Diag_04251

ClientAuthenticationHandle () noexcept;

Constructor of ClientAuthenticationHandle.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 970d47856338 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

동기식 기본 생성자 [SWS_DM_01146]은(는) 클래스 ara::diag::ClientAuthenticationHandle의 인스턴스를 생성합니다. 호출은 전달 매개변수를 받지 않으며 반환값을 갖지 않습니다. 이 함수는 noexcept(으)로 선언되어 있고 스레드 안전(thread-safe) 및 예외 안전으로 명시되어 있어 [SWS_DM_01146], 생성 시 오류 코드나 예외가 발생하지 않습니다.

생성된 객체의 전달 및 수명 주기에는 다음 제한 사항이 적용됩니다:

복사 생성과 복사 대입은 명시적으로 삭제되었습니다([SWS_DM_01150], [SWS_DM_01151]).
이동 생성자 [SWS_DM_01148] 및 이동 대입 연산자 [SWS_DM_01149]이(가) 지원됩니다.
Set [SWS_DM_01153], Append [SWS_DM_01152], Revoke [SWS_DM_01154]와 같은 모든 인스턴스 메서드 및 소멸자 [SWS_DM_01147]은(는) 스레드 안전하지 않은 것(not thread-safe)으로 정의되어 있습니다.

전체 시스템에서 Diagnostic Server는 클라이언트에 바인딩된 활성 핸들을 일반적으로 Authenticate [SWS_DM_01142] 또는 OverrideDefaultRoles [SWS_DM_01141]을(를) 통해 제공합니다(AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 “ClientAuthenticationHandle”). 따라서 기본 생성자를 통해 생성된 인스턴스는 바인딩되지 않은 플레이스홀더 역할을 하며, 후속 이동 대입 [SWS_DM_01149]을(를) 거친 후에야 비로소 접근 제어 목록을 제어하기 위한 유효한 핸들을 수용할 것으로 추정됩니다. 질문 Q-ce182402bd1d4072 (열림)

이 텍스트는 AUTOSAR 사양 R25-11을 기반으로 AI에 의해 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I2)

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01146
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01146@rel:R25-11#4eb57936
Content hash: 4eb57936
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01146

Status: valid/unmigrated Version: rel:R25-11#e53f888a Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01146@rel:R25-11#e53f888a

Recorded Revisions (6):

R25-11rel:R25-11#343d84612026-09-30
R21-11rel:R21-11#382fc8b12026-10-14
R22-11rel:R22-11#1b1476a42026-10-14
R23-11rel:R23-11#ae2414252026-10-14
R24-11rel:R24-11#2fa9197f2026-10-14
R25-11rel:R25-11#e53f888a2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 ClientAuthenticationHandle [SWS_DM_01148] Upstream: RS_Diag_04251

ClientAuthenticationHandle (ClientAuthenticationHandle &&other) noexcept=default;

Move constructor of ClientAuthenticationHandle.

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle
Exception-Sicherheit	exception safe

Parameter (in)

Parameter	Beschreibung
other	Object to move-construct from

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01148
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01148@rel:R25-11#4119df35
Content hash: 4119df35
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01148

Status: valid/unmigrated Version: rel:R25-11#61fab40f Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01148@rel:R25-11#61fab40f

Recorded Revisions (6):

R25-11rel:R25-11#398da6ac2026-09-30
R21-11rel:R21-11#4ded0cd12026-10-14
R22-11rel:R22-11#6906c58f2026-10-14
R23-11rel:R23-11#9b4b55cb2026-10-14
R24-11rel:R24-11#ce30ca042026-10-14
R25-11rel:R25-11#61fab40f2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 ClientAuthenticationHandle [SWS_DM_01150] Upstream: RS_Diag_04251

ClientAuthenticationHandle (ClientAuthenticationHandle const &other)=delete;

Copy constructor of ClientAuthenticationHandle cannot be used.

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01150
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01150@rel:R25-11#57839a34
Content hash: 57839a34
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01150

Status: valid/unmigrated Version: rel:R25-11#5c00c5f2 Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01150@rel:R25-11#5c00c5f2

Recorded Revisions (6):

R25-11rel:R25-11#b2ba2b412026-09-30
R21-11rel:R21-11#be3428ad2026-10-14
R22-11rel:R22-11#7ad065b42026-10-14
R23-11rel:R23-11#f8cce9ac2026-10-14
R24-11rel:R24-11#5c00c5f22026-10-14
R25-11rel:R25-11#5c00c5f22026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 Refresh [SWS_DM_01155] Upstream: RS_Diag_04251

ara::core::Result< void > Refresh () noexcept;

This function is used by the application to refresh the timer that was started by Authenticate or OverrideDefaultRoles. If both Methods were previously called, both timers are refreshed.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 8c9744884d32 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::diag::ClientAuthenticationHandle 클래스의 Refresh 메서드(헤더 파일 #include "ara/diag/client_authentication_handle.h")는 애플리케이션이 활성 인증 또는 역할 타이머를 연장하는 데 사용됩니다(AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.3.2 “Refresh”). 이 메서드는 이전에 Authenticate 또는 OverrideDefaultRoles에 의해 시작된 타이머를 리셋합니다. 이전에 두 메서드가 모두 호출된 경우, 호출을 통해 두 타이머가 동시에 갱신됩니다 [SWS_DM_01155].

동기식 호출(해석: 비동기 Future 없는 직접 반환)은 애플리케이션이 Authenticate 또는 OverrideDefaultRoles의 성공적인 완료 후 Diagnostic Server로부터 수신한 ClientAuthenticationHandle의 기존 인스턴스에서 매개변수 없이 수행됩니다(AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 “ClientAuthenticationHandle”). 질문 Q-b07e81ff4629ada7 (열림) 이 함수는 noexcept로 선언되어 예외 안전(exception safe)하지만, 스레드 안전하지 않은 것(not thread-safe)으로 지정되어 있습니다 [SWS_DM_01155]. 따라서 동일한 인스턴스에 대한 동시 호출은 호출자에 의해 동기화되어야 합니다.

작업이 실패하면 함수는 ara::core::Result<void>을 통해 오류 코드 DiagErrc::kServiceNotAvailable을 반환합니다 [SWS_DM_01155]. 이는 Diagnostic Management(DM)의 필수 기능을 현재 사용할 수 없기 때문에 호출을 실행할 수 없었음을 롤백 시맨틱을 통해 나타냅니다 [SWS_DM_01155].

이 사용 지침은 AUTOSAR R25-11 사양을 바탕으로 자동 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I2)

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Returns nothing or an error.

Fehler

Fehlercode	Beschreibung
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01155
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01155@rel:R25-11#61e68aa0
Content hash: 61e68aa0
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01155

Status: valid/unmigrated Version: rel:R25-11#336ea0d5 Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01155@rel:R25-11#336ea0d5

Recorded Revisions (6):

R25-11rel:R25-11#b5659ac02026-09-30
R21-11rel:R21-11#f05c61ca2026-10-14
R22-11rel:R22-11#2739c0e72026-10-14
R23-11rel:R23-11#ebcd83152026-10-14
R24-11rel:R24-11#aa896f602026-10-14
R25-11rel:R25-11#336ea0d52026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 Revoke [SWS_DM_01154] Upstream: RS_Diag_04251

ara::core::Result< void > Revoke () noexcept;

This function is used by the application to de-authenticate a client, and also to clear the Dynamic AccessList and any overridden defaults.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 97421a5ce76e 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::diag::ClientAuthenticationHandle 클래스(SWS Diagnostics §8.6.1.1.3.3 “Revoke”)의 동기 메서드 Revoke은(는) 애플리케이션이 이전에 인증된 진단 클라이언트를 인증 해제하고 해당 동적 접근 목록(DynamicAccessList) 및 오버라이드된 기본 역할을 완전히 폐기하는 데 사용됩니다([SWS_DM_01154], [SWS_DM_01216]).

이 함수에는 전달 매개변수가 없으며 ara::core::Result<void>을(를) 반환합니다([SWS_DM_01154]). 성공 시 클라이언트의 인증 상태가 종료됩니다. 호출 시점에 Diagnostic Manager의 필수 기능을 사용할 수 없는 경우 작업은 실패하고 롤백 의미론과 함께 오류 DiagErrc::kServiceNotAvailable을(를) 반환합니다([SWS_DM_01154]).

동시성과 관련하여 이 인터페이스는 예외 안전(exception safe)하지만 스레드 안전하지 않음(not thread-safe)으로 지정되어 있습니다([SWS_DM_01154]). 해석: 따라서 여러 스레드에서 동일한 핸들 인스턴스에 동시 접근하는 경우 호출 애플리케이션이 외부 동기화를 보장해야 할 것으로 보입니다. 질문 Q-8781261c9a2f5f8e (열림)

전체 흐름에서 ClientAuthenticationHandle 인스턴스는 성공적인 인증 후 또는 기본 역할 오버라이드 후 진단 서버 인스턴스에 의해 애플리케이션에 제공됩니다(SWS Diagnostics §7.3.2.3.3 “ClientAuthenticationHandle”). 활성 핸들은 철회 외에도 DynamicAccessList의 대체([SWS_DM_01213]) 또는 확장([SWS_DM_01215])을 허용하는 반면, Revoke은(는) 클라이언트의 이러한 권한을 최종적으로 종료합니다.

이 텍스트는 AUTOSAR Adaptive R25-11 명세를 기반으로 AI에 의해 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I1)

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Returns nothing or an error.

Fehler

Fehlercode	Beschreibung
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01154
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01154@rel:R25-11#019b8a5c
Content hash: 019b8a5c
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01154

Status: valid/unmigrated Version: rel:R25-11#d654e83e Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01154@rel:R25-11#d654e83e

Recorded Revisions (6):

R25-11rel:R25-11#0fc0c68f2026-09-30
R21-11rel:R21-11#341b16582026-10-14
R22-11rel:R22-11#b81da6112026-10-14
R23-11rel:R23-11#4f5f61352026-10-14
R24-11rel:R24-11#6d88b2f82026-10-14
R25-11rel:R25-11#d654e83e2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 Set [SWS_DM_01153] Upstream: RS_Diag_04251

ara::core::Result< void > Set (DiagnosticServiceDynamicAccessList dynamicAccessList) noexcept;

This function is used by the application to set/replace a DynamicAccessList of a Diagnostic Conversation.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 8ef0a8bd09d8 출처

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

ara::diag::ClientAuthenticationHandle 클래스([SWS_DM_01153])의 동기 메서드 Set은(는) 애플리케이션이 Diagnostic Server에서 진단 대화 또는 인증된 클라이언트에 대한 동적 접근 목록(DynamicAccessList)을 설정하거나 완전히 대체하는 데 사용됩니다([SWS_DM_01213]). Diagnostic Manager는 인증된 각 클라이언트에 대해 이러한 DynamicAccessList을(를) 유지 관리하며, 이는 Diagnostic Extract에 구성된 설정을 넘어 클라이언트에 진단 리소스에 대한 추가 접근 권한을 부여할 수 있습니다(AUTOSAR_AP_SWS_Diagnostics §7.3.2.3.3 “ClientAuthenticationHandle”).

사용 시 다음 측면이 중요합니다:

호출 컨텍스트 및 매개변수: 이 함수는 ara::diag::ClientAuthenticationHandle 인스턴스에서 호출됩니다(#include "ara/diag/client_authentication_handle.h"에 선언됨). 이러한 핸들 인스턴스는 이전에 ara::diag::ClientAuthentication::Authenticate ([SWS_DM_01206]) 또는 ara::diag::ClientAuthentication::OverrideDefaultRoles ([SWS_DM_01209])이(가) 성공적으로 완료되었을 때 애플리케이션에 제공됩니다. 유일한 전달 매개변수로 새 접근 목록을 정의하는 DiagnosticServiceDynamicAccessList 타입의 dynamicAccessList이(가) 전달됩니다([SWS_DM_01153]).
반환값 및 오류 처리: 이 메서드는 noexcept(으)로 지정되며 ara::core::Result<void>을(를) 반환합니다. 롤백 의미론으로 동작합니다: 필수 DM 기능을 현재 사용할 수 없어 호출을 실행할 수 없는 경우, 호출은 오류 코드 DiagErrc::kServiceNotAvailable(으)로 실패합니다([SWS_DM_01153]). 예외 처리와 관련하여 이 메서드는 예외 안전(exception safe)으로 분류됩니다.
동시성: 이 작업은 명시적으로 스레드 안전하지 않음(not thread-safe)으로 정의되어 있습니다([SWS_DM_01153]). 여러 스레드에서 동일한 핸들 인스턴스에 대한 호출이 동시에 이루어지는 경우, 필요한 동기화는 애플리케이션의 책임입니다.

이 사용 지침은 AUTOSAR 사양을 기반으로 자동 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I1)

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Parameter (in)

Parameter	Beschreibung
dynamicAccessList	The new DynamicAccessList to be set in the client.

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Returns nothing or an error.

Fehler

Fehlercode	Beschreibung
DiagErrc::kServiceNotAvailable	rollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01153
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01153@rel:R25-11#66701a7d
Content hash: 66701a7d
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01153

Status: valid/unmigrated Version: rel:R25-11#6e0f3d93 Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01153@rel:R25-11#6e0f3d93

Recorded Revisions (6):

R25-11rel:R25-11#850c01d82026-09-30
R21-11rel:R21-11#4dff11b12026-10-14
R22-11rel:R22-11#5a0f43622026-10-14
R23-11rel:R23-11#768f7ce22026-10-14
R24-11rel:R24-11#bac10bed2026-10-14
R25-11rel:R25-11#6e0f3d932026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 operator= [SWS_DM_01149] Upstream: RS_Diag_04251

auto operator= (ClientAuthenticationHandle &&other) & noexcept -> ClientAuthenticationHandle & =default;

Move assignment operator of ClientAuthenticationHandle.

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle
Exception-Sicherheit	exception safe

Parameter (in)

Parameter	Beschreibung
other	Object to move-assign from.

Rückgabewert

Typ	Beschreibung
ClientAuthenticationHandle	ClientAuthenticationHandle& Reference to self.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01149
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01149@rel:R25-11#3a7eda5d
Content hash: 3a7eda5d
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01149

Status: valid/unmigrated Version: rel:R25-11#6d429c60 Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01149@rel:R25-11#6d429c60

Recorded Revisions (6):

R25-11rel:R25-11#825bafd02026-09-30
R21-11rel:R21-11#6b6602162026-10-14
R22-11rel:R22-11#7c114d032026-10-14
R23-11rel:R23-11#f26ac2222026-10-14
R24-11rel:R24-11#13552b832026-10-14
R25-11rel:R25-11#6d429c602026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 operator= [SWS_DM_01151] Upstream: RS_Diag_04251

auto operator= (ClientAuthenticationHandle const &other) -> Client AuthenticationHandle &=delete;

Copy assignment operator of CancellationHandler cannot be used.

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01151
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01151@rel:R25-11#e11cfb69
Content hash: e11cfb69
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01151

Status: valid/unmigrated Version: rel:R25-11#41e0cc7a Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01151@rel:R25-11#41e0cc7a

Recorded Revisions (6):

R25-11rel:R25-11#e7f217352026-09-30
R21-11rel:R21-11#e234b1652026-10-14
R22-11rel:R22-11#8556e28c2026-10-14
R23-11rel:R23-11#114f1c5c2026-10-14
R24-11rel:R24-11#41e0cc7a2026-10-14
R25-11rel:R25-11#41e0cc7a2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 ~ClientAuthenticationHandle [SWS_DM_01147] Upstream: RS_Diag_04251

~ClientAuthenticationHandle () noexcept;

Destructor of ClientAuthenticationHandle.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 284dd06f8411 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용법 및 의미론

함수 ~ClientAuthenticationHandle()은(는) ara::diag::ClientAuthenticationHandle 클래스의 소멸자이며 헤더 파일 ara/diag/client_authentication_handle.h을(를) 통해 선언됩니다([SWS_DM_01147], AUTOSAR_AP_SWS_Diagnostics §8.6.1.1.1.3 “Destructor”). 매개변수를 받지 않으며 반환값을 제공하지 않습니다. 호출은 일반적으로 객체의 수명이 종료될 때 암시적으로 수행됩니다. 해석: 이때 핸들에 의해 내부적으로 바인딩된 모든 클라이언트 인증 리소스가 해제될 것으로 보입니다. 질문 Q-ea8f47232fd9951f (열림)

오류 처리 및 예외 안전성

이 소멸자는 noexcept(으)로 선언되어 있으며 명시적으로 exception safe로 지정되어 있습니다([SWS_DM_01147]). 따라서 객체 소멸 중에는 C++ 예외가 발생하지 않으며 특정 오류 코드가 반환되지 않으므로 정리 작업이 오류 없이 완료됨이 보장됩니다.

동시성 및 제약사항

ClientAuthenticationHandle의 소멸은 사양에 따라 not thread-safe로 분류됩니다([SWS_DM_01147]). 호출 애플리케이션은 소멸자가 실행되는 동안 다른 스레드가 동일한 인스턴스에 병렬로 접근하지 않도록 보장해야 합니다.

이 텍스트는 AUTOSAR Adaptive R25-11 명세를 기반으로 AI에 의해 생성되었습니다.

구현자 가이드 준비 중 (복잡도 I1)

Header-Datei	#include "ara/diag/client_authentication_handle.h"
Scope	class ara::diag::ClientAuthenticationHandle
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_DM_01147
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01147@rel:R25-11#92559aaf
Content hash: 92559aaf
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01147

Status: valid/unmigrated Version: rel:R25-11#b9cd7178 Versionshistorie & Revisions (1 transition, 6 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_DM_01147@rel:R25-11#b9cd7178

Recorded Revisions (6):

R25-11rel:R25-11#f9cc0a482026-09-30
R21-11rel:R21-11#3b91d66c2026-10-14
R22-11rel:R22-11#cca9279f2026-10-14
R23-11rel:R23-11#4de7c36f2026-10-14
R24-11rel:R24-11#0092ff1b2026-10-14
R25-11rel:R25-11#b9cd71782026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

클래스 ara::diag::ClientAuthenticationHandle

사용자 가이드AI 생성

컨텍스트

수명 주기

사용 경로

오류 시나리오

멤버 맵

생성자 및 소멸자

메서드

연산자

클래스 다이어그램

상세 보기

생성자 및 소멸자

메서드

연산자

메서드 문서

함수 Append [SWS_DM_01152] Upstream: RS_Diag_04251

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 ClientAuthenticationHandle [SWS_DM_01146] Upstream: RS_Diag_04251

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 ClientAuthenticationHandle [SWS_DM_01148] Upstream: RS_Diag_04251

Parameter (in)

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 ClientAuthenticationHandle [SWS_DM_01150] Upstream: RS_Diag_04251

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 Refresh [SWS_DM_01155] Upstream: RS_Diag_04251

Rückgabewert

Fehler

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 Revoke [SWS_DM_01154] Upstream: RS_Diag_04251

Rückgabewert

Fehler

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 Set [SWS_DM_01153] Upstream: RS_Diag_04251

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 operator= [SWS_DM_01149] Upstream: RS_Diag_04251

Parameter (in)

Rückgabewert

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 operator= [SWS_DM_01151] Upstream: RS_Diag_04251

Recorded Revisions (6):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 ~ClientAuthenticationHandle [SWS_DM_01147] Upstream: RS_Diag_04251

사용법 및 의미론

오류 처리 및 예외 안전성

동시성 및 제약사항

Recorded Revisions (6):

Requirement Text as-of this release: