DEENESPTFRRUARHIKOZHNL

클래스 ara::crypto::cryp::SymmetricKey

[SWS_CRYPT_23800] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02403

class SymmetricKey :          public CryptoObject {...};

Symmetric Key interface.

Header-Datei#include "ara/crypto/cryp/cryobj/symmetric_key.h"
Forwarding-Header#include "ara/crypto/crypto_fwd.h"
Scopenamespace ara::crypto::cryp
Basisklasse(n)CryptoObject

사용자 가이드AI 생성

대칭 암호화 키를 캡슐화하고 공유 스마트 포인터를 통해 수명을 제어합니다.
AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: f71a58d7ce35 출처 열린 질문 (3)
독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

대칭 암호화 키를 캡슐화하고 공유 스마트 포인터를 통해 수명을 제어합니다.

인터페이스 ara::crypto::cryp::SymmetricKey은 AUTOSAR Adaptive에서 대칭 암호화 키를 위한 추상화로 기능하며 CryptoObject에서 기본 속성을 상속합니다. 애플리케이션과 암호화 컨텍스트는 헤더 ara/crypto/cryp/cryobj/symmetric_key.h에 따른 표준화된 스마트 포인터 유형 Sptr(std::shared_ptr<SymmetricKey>)를 통해 키 인스턴스를 주로 관리합니다[SWS_CRYPT_23801]. 해석: 인스턴스화는 키 관리의 전용 생성 루틴을 통해 수행될 것으로 추정되며, 이때 키는 암호화 또는 MAC 구성을 위해 전달됩니다. 질문 Q-f76fecc360d2d3a5 (열림) 중요한 제약 조건으로서 공유 포인터의 참조 카운팅이 수명을 결정하므로 캡슐화된 키 객체는 마지막 참조가 해제된 후에야 소멸됩니다[SWS_CRYPT_23801].

컨텍스트

클래스 ara::crypto::cryp::SymmetricKey은 AUTOSAR Adaptive Platform(Release R25-11, 모듈 crypto)에서 대칭 암호화 키를 표현하기 위한 핵심 인터페이스를 구성합니다. 암호화 하위 시스템의 기본 구성 요소로서 이 인터페이스는 대칭 암호화 절차에 필요한 모든 속성을 캡슐화합니다. 클래스는 CryptoObject에서 직접 파생되어(class SymmetricKey : public CryptoObject) Adaptive Platform의 암호화 엔티티를 위한 일관된 객체 계층 구조에 통합됩니다. 인터페이스는 헤더 파일 ara/crypto/cryp/cryobj/symmetric_key.h에서 선언됩니다[SWS_CRYPT_23801].

상호작용 대상으로는 일반적으로 암호화 실행 컨텍스트 및 키 관리 인스턴스가 나타납니다. 인터페이스는 키 자료의 생성 또는 제공과 해당 키의 운영 적용 사이의 연결 고리 역할을 합니다. 해석: 대칭 키는 차량 수준에서 기밀성과 데이터 무결성을 보호하기 위해 주로 대칭 암호화 절차(예: 블록 또는 스트림 암호) 및 메시지 인증 코드(MAC)에 사용될 것으로 추정됩니다. 질문 (열림) CryptoObject으로 캡슐화됨으로써 키 자료가 구체적인 암호화 변환과 분리된 상태를 유지하도록 보장합니다.

수명 주기

ara::crypto::cryp::SymmetricKey 인스턴스의 수명주기는 현대 C++ 메모리 관리 패턴과 밀접하게 연결되어 있습니다. [SWS_CRYPT_23801]에 따라 클래스는 using Sptr = std::shared_ptr<SymmetricKey>;으로 정의된 유형 별칭 Sptr를 제공합니다. 이 공유 스마트 포인터를 통해 인터페이스 객체의 수명주기가 참조 카운트되고 결정론적으로 제어됩니다.

해석: 인터페이스 정의에는 직접적인 원시 키 인스턴스화를 위한 퍼블릭 기본 생성자가 포함되어 있지 않으므로 실제 인스턴스의 생성 및 초기화는 암호화 스택의 특수 키 생성기, 로드 루틴 또는 키 관리 컴포넌트를 통해 수행될 것으로 추정됩니다. 질문 Q-51acf16b99d9ad1b (열림) 키 인스턴스가 Sptr으로 생성되면 여러 소프트웨어 컴포넌트 또는 암호화 컨텍스트에서 동시적 및 소유권 공유 방식으로 참조될 수 있습니다[SWS_CRYPT_23801].

기본 리소스의 해제는 마지막 활성 Sptr이 소멸되거나 재설정되는 즉시 자동으로 수행됩니다. 해석: CryptoObject의 파생은 메모리 내의 민감한 키 자료가 특별히 보호되고 객체 소멸 시 안전하게 정리(Zeroization)되어 수명 종료 후의 판독을 방지함을 시사합니다. 질문 (열림) 또한 std::shared_ptr의 사용은 참조 카운터 관리 시 스레드 안전성을 보장하는 한편, 참조되는 키 객체 자체에 대한 접근은 공유 리소스에 대한 일반적인 동기화 규칙을 따릅니다.

사용 경로

Adaptive 애플리케이션에서 ara::crypto::cryp::SymmetricKey의 일반적인 사용은 정의된 스마트 포인터에 기반한 구조화된 절차를 따릅니다[SWS_CRYPT_23801]:

  • 헤더 포함: 먼저 사용하는 소프트웨어 컴포넌트가 타입 정의 및 별칭 Sptr에 대한 접근 권한을 얻기 위해 헤더 #include "ara/crypto/cryp/cryobj/symmetric_key.h"을 포함합니다[SWS_CRYPT_23801].
  • 키 획득: 애플리케이션은 예를 들어 선행 키 프로비저닝 프로세스로부터 ara::crypto::cryp::SymmetricKey::Sptr [SWS_CRYPT_23801] 형태로 인터페이스를 가져옵니다.
  • 유효성 검사: 호출자는 실제 사용 전에 획득한 Sptr이 nullptr과 같지 않고 온전한 CryptoObject를 가리키는지 확인합니다.
  • 암호화 컨텍스트에 할당: 예정된 암호화/복호화 연산 또는 무결성 검사를 위해 담당 암호화 컨텍스트를 구성하도록 키 포인터를 해당 컨텍스트로 전달합니다.
  • 해제: 변환이 완료되거나 애플리케이션 컨텍스트가 종료되면 포인터가 폐기되며, 키의 소멸은 마지막 Sptr [SWS_CRYPT_23801]이 자동으로 삭제됨으로써 이루어집니다.

본 가이드는 AUTOSAR Adaptive Platform Release R25-11 사양을 기반으로 합니다. 기술된 내용은 참조된 사양 요소 및 이와 같이 표시된 해석에 근거합니다.

UML 클래스 다이어그램

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

G nara__crypto__cryp__SymmetricKey111 SymmetricKey nara__crypto__cryp__CryptoObject679 CryptoObject nara__crypto__cryp__SymmetricKey111->nara__crypto__cryp__CryptoObject679 nara__crypto__Serializable855 Serializable nara__crypto__cryp__CryptoObject679->nara__crypto__Serializable855

타입 별칭

Sptr 타입 별칭

Shared smart pointer of the interface.

타입 별칭 문서

타입 별칭 Sptr [SWS_CRYPT_23801] Upstream: RS_CRYPTO_02201

using Sptr = std::shared_ptr<SymmetricKey>;

Shared smart pointer of the interface.

Header-Datei#include "ara/crypto/cryp/cryobj/symmetric_key.h"
Scopeclass ara::crypto::cryp::SymmetricKey
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_23801
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_23801@rel:R25-11#63a7126b
Content hash
63a7126b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23801
Status: valid/unmigrated Version: rel:R25-11#882653b8 Versionshistorie & Revisions (1 transition, 8 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_CRYPT_23801@rel:R25-11#882653b8
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#d033faab2026-09-30
  • R19-11rel:R19-11#a0669f0d2026-10-14
  • R20-11rel:R20-11#c490e0a52026-10-14
  • R21-11rel:R21-11#c490e0a52026-10-14
  • R22-11rel:R22-11#b634ae6e2026-10-14
  • R23-11rel:R23-11#cb129b992026-10-14
  • R24-11rel:R24-11#cb129b992026-10-14
  • R25-11rel:R25-11#882653b82026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill