DEENESPTFRRUARHIKOZHNL

class ara::crypto::cryp::KeyAgreementPrivateCtx

[SWS_CRYPT_21300] Upstream: RS_CRYPTO_02104

class KeyAgreementPrivateCtx :              public CryptoContext {...};

Key Agreement Private key Context interface.

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

User GuideKI-GENERIERT

Dient der Berechnung symmetrischer Zielschlüssel aus einem privaten und einem fremden öffentlichen Schlüssel.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 6c31df682424 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Dient der Berechnung symmetrischer Zielschlüssel aus einem privaten und einem fremden öffentlichen Schlüssel.

Die Schnittstelle ara::crypto::cryp::KeyAgreementPrivateCtx dient zur Ausführung kryptografischer Schlüsselvereinbarungsverfahren auf Basis eines lokalen privaten Schlüssels und des öffentlichen Schlüssels einer Gegenstelle [SWS_CRYPT_21312]. Nach Zuweisung des eigenen Schlüssels und optionaler Parameter berechnet die Methode AgreeKey ein gemeinsames Geheimnis und liefert dieses als symmetrisches Schlüsselobjekt zurück. Eine zentrale Randbedingung ist die vollständige Initialisierung vor der Ausführung, da fehlende Parameter oder fehlende Berechtigungen für kAllowKeyAgreement zum Abbruch mit entsprechenden Fehlercodes führen [SWS_CRYPT_21312]. Alle Operationen sind dabei thread-sicher ausgelegt.

Kontext

Die Schnittstelle ara::crypto::cryp::KeyAgreementPrivateCtx dient im Modul crypto der Adaptive Platform zur Ausführung asymmetrischer Schlüsselvereinbarungsverfahren (Key Agreement). Ihre zentrale Verantwortung liegt in der Berechnung eines gemeinsamen symmetrischen Schlüssels aus einem lokalen privaten Schlüssel und dem öffentlichen Schlüssel eines Kommunikationspartners [SWS_CRYPT_21312]. Als spezialisierter Kryptokontext interagiert die Klasse mit mehreren Schlüssel- und Speicherabstraktionen: Der eigene private Schlüssel kann entweder direkt als PrivateKey-Objekt [SWS_CRYPT_21313] oder referenziert über einen KeySlot [SWS_CRYPT_50053] gebunden werden. Die Gegenseite steuert ihren öffentlichen Schlüssel in Form eines PublicKey bei, während das Ergebnis als eigenständiges SymmetricKey-Objekt bereitgestellt wird [SWS_CRYPT_21312]. Ergänzend können algorithmusspezifische Konfigurationsparameter als Speicherbereich oder Ganzzahl übergeben werden [SWS_CRYPT_50051], [SWS_CRYPT_50052].

KeyAgreementContext Application Application KeyAgreementPrivateCtx KeyAgreementPrivateCtx Application->KeyAgreementPrivateCtx konfiguriert & fuehrt aus SymmetricKey SymmetricKey KeyAgreementPrivateCtx->SymmetricKey erzeugt PrivateKey PrivateKey PrivateKey->KeyAgreementPrivateCtx eigener privater Schluessel KeySlot KeySlot KeySlot->KeyAgreementPrivateCtx Schluesselplatz PublicKey PublicKey PublicKey->KeyAgreementPrivateCtx Gegenstellen-Schluessel

Kontextdiagramm: Zusammenspiel von KeyAgreementPrivateCtx mit Schlüsseln, Schlüsselplätzen und Ergebnisobjekt. Quellen: [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50053].

Lebenszyklus

Lebenszyklus und Besitzverhältnisse von KeyAgreementPrivateCtx basieren auf Shared Pointern; die Spezifikation stellt hierfür den Typ-Alias KeyAgreementPrivateCtx::Sptr bereit [SWS_CRYPT_21301]. Interpretation: Die Instanziierung dürfte über eine übergeordnete Factory eines CryptoProviders erfolgen, da die Klasse eine rein virtuelle Schnittstelle ohne Konstruktorspezifikation darstellt. Frage Q-22dca518675fba51 (offen) Nach der Erzeugung befindet sich die Instanz in einem nicht betriebsbereiten Grundzustand. Erst durch die Konfiguration eines privaten Schlüssels mittels SetKey [SWS_CRYPT_21313], [SWS_CRYPT_50053] und die Zuweisung aller für das gewählte Schema notwendigen Parameter [SWS_CRYPT_50051], [SWS_CRYPT_50052] wird der Kontext initialisiert.

Wird eine Schlüsselberechnung vor Abschluss dieser Konfigurationsschritte angestoßen, schlägt der Aufruf fehl [SWS_CRYPT_21312]. Bezüglich der Nebenläufigkeit sind alle Mitgliedsfunktionen als thread-sicher (thread-safe) sowie ausnahmesicher (exception safe) spezifiziert [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051], [SWS_CRYPT_50052], [SWS_CRYPT_50053]. Da die Ausführungsfunktion AgreeKey als const deklariert ist [SWS_CRYPT_21312], kann derselbe initialisierte Kontext parallel für Vereinbarungen mit verschiedenen Gegenstellen verwendet werden.

Nutzungspfad

Die praktische Verwendung gliedert sich in eine sequentielle Abfolge von Konfiguration und Berechnung:

  • Schlüsselzuweisung: Zunächst bindet die Anwendung den eigenen privaten Schlüssel an den Kontext. Dies erfolgt entweder über SetKey(PrivateKey::Sptr) [SWS_CRYPT_21313] für ein geladenes Schlüsselobjekt oder über SetKey(KeySlot::Sptr) [SWS_CRYPT_50053] für einen Schlüsselplatz, dessen Inhalt erst zum Zeitpunkt der Vereinbarung ausgewertet wird.
  • Parameterdefinition: Falls der Zielalgorithmus zusätzliche Initialisierungsdaten verlangt, werden diese per SetParameter als Puffer ReadOnlyMemRegion [SWS_CRYPT_50051] oder als 64-Bit-Ganzzahl std::uint64_t [SWS_CRYPT_50052] übergeben.
  • Schlüsselvereinbarung: Mit AgreeKey wird der kryptografische Algorithmus ausgeführt [SWS_CRYPT_21312]. Die aufrufende Komponente übergibt den öffentlichen Schlüssel der Gegenstelle (otherSideKey), den Bezeichner des gewünschten Zielalgorithmus (targetAlgId) sowie die zulässigen Verwendungsflags (allowedUsage).
  • Ergebnisübernahme: Bei erfolgreichem Abschluss liefert AgreeKey ein SymmetricKey-Objekt, das das berechnete gemeinsame Geheimnis enthält [SWS_CRYPT_21312].
Ablauf der SchlüsselvereinbarungAnwendungKeyAgreementPrivateCtxSymmetricKeyUse Case: KonfigurationSetKey(key)Result<void>optZusätzliche Parameter erforderlichSetParameter(name, value)Result<void>Use Case: SchlüsselvereinbarungAgreeKey(otherSideKey, targetAlgId, allowedUsage)Berechnung Shared SecretErzeugungResult<SymmetricKey::Sptr>

Sequenzdiagramm: Typischer Ablauf der Schlüsselvereinbarung von der Schlüsselzuteilung bis zur Erzeugung des symmetrischen Schlüssels. Quellen: [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051].

Fehlerszenarien

Methoden von KeyAgreementPrivateCtx geben Fehler über ara::core::Result zurück und gewährleisten Rollback-Semantik [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051], [SWS_CRYPT_50052], [SWS_CRYPT_50053]. Typische Fehlerszenarien umfassen:

  • CryptoErrc::kUninitializedContext: Tritt bei AgreeKey auf, falls zuvor kein Schlüssel gesetzt wurde oder erforderliche Parameter fehlen [SWS_CRYPT_21312].
  • CryptoErrc::kIncompatibleObject: Wird gemeldet, wenn ein übergebener PrivateKey oder KeySlot nicht zum Typ des Kontexts passt [SWS_CRYPT_21313], [SWS_CRYPT_50053], oder wenn der Gegenstellen-Schlüssel otherSideKey inkompatibel ist [SWS_CRYPT_21312].
  • CryptoErrc::kUsageViolation: Signaliert, dass für den privaten Schlüssel oder den Gegenstellen-Schlüssel das Recht kAllowKeyAgreement nicht erteilt wurde [SWS_CRYPT_21312], [SWS_CRYPT_21313].
  • CryptoErrc::kUnsupported: Weist darauf hin, dass die Kontext-Implementierung ausschließlich die jeweils andere SetKey-Variante unterstützt [SWS_CRYPT_21313], [SWS_CRYPT_50053], oder ein angeforderter Parametername nicht unterstützt wird [SWS_CRYPT_50051], [SWS_CRYPT_50052].
  • CryptoErrc::kInvalidArgument: Entsteht bei ungültigen Werten in SetParameter [SWS_CRYPT_50051], [SWS_CRYPT_50052] oder unzulässigen allowedUsage-Flags für den Zielschlüssel [SWS_CRYPT_21312].
  • CryptoErrc::kUnknownIdentifier: Wird ausgelöst, falls der Bezeichner targetAlgId für den Zielalgorithmus unbekannt ist [SWS_CRYPT_21312].
  • CryptoErrc::kEmptyKeySlot und CryptoErrc::kBusyResource: Werden von AgreeKey zurückgegeben, wenn der konfigurierte KeySlot zum Ausführungszeitpunkt keinen Schlüssel enthält oder eine benötigte Ressource belegt ist [SWS_CRYPT_21312].

Dieser Klassen-Leitfaden wurde durch das System autodocs auf Basis der AUTOSAR-Spezifikation R25-11 generiert.

Mitgliederkarte

Methoden

3
AgreeKeySetKeySetParameter

Typaliase

1
Sptr

Klassendiagramm

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

G nara__crypto__cryp__KeyAgreementPrivateCtx203 KeyAgreementPrivateCtx + AgreeKey() + SetKey() + SetParameter() nara__crypto__cryp__CryptoContext85 CryptoContext nara__crypto__cryp__KeyAgreementPrivateCtx203->nara__crypto__cryp__CryptoContext85

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Methoden

AgreeKey function

Produce a common symmetric key via execution of the key-agreement algorithm using a private key and a public key of another side.

virtual ara::core::Result< SymmetricKey::Sptr > AgreeKey (Public Key::Sptr otherSideKey, AlgId targetAlgId, AllowedUsageFlags allowed Usage) const noexcept=0;
SetKey function 2

Configure the context to use the provided key.

Überladungen SetKey 2
virtual ara::core::Result< void > SetKey (PrivateKey::Sptr key) noexcept=0; SWS_CRYPT_21313
virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0; SWS_CRYPT_50053
SetParameter function 2

Set a parameter of the key agreement identified by parameterName.

Überladungen SetParameter 2
virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, ReadOnlyMemRegion value) noexcept=0; SWS_CRYPT_50051
virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, std::uint64_t value) noexcept=0; SWS_CRYPT_50052

Typaliase

Sptr type alias

Smart pointer of this interface.

using Sptr = std::shared_ptr<KeyAgreementPrivateCtx>;

Dokumentation der Methoden

function AgreeKey [SWS_CRYPT_21312] Upstream: RS_CRYPTO_02115

virtual ara::core::Result< SymmetricKey::Sptr > AgreeKey (Public Key::Sptr otherSideKey, AlgId targetAlgId, AllowedUsageFlags allowed Usage) const noexcept=0;

Produce a common symmetric key via execution of the key-agreement algorithm using a private key and a public key of another side.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 32f169531b52 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Methode AgreeKey der Klasse ara::crypto::cryp::KeyAgreementPrivateCtx führt einen Schlüsselvereinbarungsalgorithmus unter Verwendung eines privaten Schlüssels und des öffentlichen Schlüssels der Gegenstelle aus, um einen gemeinsamen symmetrischen Schlüssel zu erzeugen [SWS_CRYPT_21312]. Als Parameter werden der öffentliche Schlüssel der Gegenstelle (otherSideKey), die Kennung des symmetrischen Zielalgorithmus (targetAlgId) sowie die zulässigen Verwendungsflags (allowedUsage) übergeben [SWS_CRYPT_21312]. Bei erfolgreicher Ausführung wird ein ara::core::Result mit einem SymmetricKey::Sptr zurückgegeben, welcher das berechnete gemeinsame Geheimnis enthält [SWS_CRYPT_21312]. Interpretation: Da die Rückgabe direkt als Result und nicht über einen asynchronen Future-Typ erfolgt, dürfte die Schlüsselberechnung synchron ablaufen. Frage Q-ab31a8a62bb1c583 (offen)

Die Methode ist als thread-safe sowie exception safe (noexcept) definiert [SWS_CRYPT_21312]. Im Fehlerfall greift eine Rollback-Semantik und es wird ein entsprechender Fehlercode zurückgegeben [SWS_CRYPT_21312]:

  • UninitializedContext: Der Kontext wurde noch nicht durch Bereitstellen eines Schlüssels initialisiert oder erforderliche Parameter wurden nicht vorab über SetParameter() gesetzt [SWS_CRYPT_21312].
  • CryptoErrc::kIncompatibleObject: Der öffentliche Schlüssel ist mit dem aktuellen Kontext inkompatibel [SWS_CRYPT_21312].
  • CryptoErrc::kUsageViolation: Die Nutzungsbeschränkungen des privaten oder öffentlichen Schlüssels enthalten nicht kAllowKeyAgreement [SWS_CRYPT_21312].
  • CryptoErrc::kInvalidArgument: Die übergebenen allowedUsage-Flags sind für einen symmetrischen Schlüssel ungültig [SWS_CRYPT_21312].
  • ara::crypto::CryptoErrc::kUnknownIdentifier: Der Bezeichner targetAlgId enthält einen nicht unterstützten Wert [SWS_CRYPT_21312].
  • CryptoErrc::kBusyResource oder CryptoErrc::kEmptyKeySlot: Eine benötigte Ressource ist belegt oder ein konfigurierter KeySlot ist leer [SWS_CRYPT_21312].

Dieser Text wurde durch eine KI generiert und dient der technischen Orientierung.

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe CryptoErrc::k rollback_semantics

Parameter (in)

ParameterBeschreibung
otherSideKeythe public key of the other side of the Key-Agreement
targetAlgIdidentifier of the symmetric target algorithm
allowedUsagethe allowed usage of the target key

Rückgabewert

TypBeschreibung
ara::core::Result<SymmetricKey::Sptr >a result containing either a unique pointer to the SymmetricKey object, which contains the computed shared secret produced by the Key-Agreement algorithm or an error

Fehler

FehlercodeBeschreibung
UninitializedContextif the context was not initialized by deploying a key or not all required parameters have been set via SetParameter()
CryptoErrc::kIncompatibleObjectrollback_semantics if the public key is not compatible to this context
CryptoErrc::kInvalidArgumentrollback_semantics if the allowed usage flags are invalid for a symmetric key
CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the private or public key do not include k AllowKeyAgreement
ara::crypto::CryptoErrc::kUnknownIdentifierrollback_semantics if targetAlgId has an unsupported value

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

Record
AUTOSAR/AP/record/SWS_CRYPT_21312
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21312@rel:R25-11#4f58d41f
Content hash
4f58d41f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21312
Status: valid/unmigrated Version: rel:R25-11#26c80425 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_21312@rel:R25-11#26c80425
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#4f58d41f2026-09-30
  • R19-11rel:R19-11#3975d40e2026-10-14
  • R20-11rel:R20-11#340c62732026-10-14
  • R21-11rel:R21-11#633195382026-10-14
  • R22-11rel:R22-11#418b5aab2026-10-14
  • R23-11rel:R23-11#28812de12026-10-14
  • R24-11rel:R24-11#c610b1882026-10-14
  • R25-11rel:R25-11#26c804252026-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

function SetKey [SWS_CRYPT_21313] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (PrivateKey::Sptr key) noexcept=0;

Configure the context to use the provided key.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 9ab09291ac6b Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Methode SetKey konfiguriert den privaten Schlüsselvereinbarungs-Kontext ara::crypto::cryp::KeyAgreementPrivateCtx für die Verwendung des übergebenen privaten Schlüssels [SWS_CRYPT_21313]. Der Aufruf erfolgt synchron und übergibt über den Parameter key einen Smart-Pointer (PrivateKey::Sptr) auf das Quellschlüsselobjekt [SWS_CRYPT_21313].

Im Fehlerfall liefert die Funktion ein ara::core::Result<void> mit Rollback-Semantik zurück, wobei folgende Fehlercodes spezifiziert sind [SWS_CRYPT_21313]:

  • ara::crypto::CryptoErrc::kIncompatibleObject: Das übergebene Schlüsselobjekt ist mit dem Kontext für private Schlüssel inkompatibel [SWS_CRYPT_21313].
  • ara::crypto::CryptoErrc::kUsageViolation: Die zulässige Verwendung des Schlüssels umfasst nicht kAllowKeyAgreement [SWS_CRYPT_21313].
  • ara::crypto::CryptoErrc::kUnsupported: Der spezifische Kontext unterstützt ausschließlich das Setzen über einen KeySlot [SWS_CRYPT_21313].

Hinsichtlich der Nebenläufigkeit ist die Operation als threadsicher (thread-safe) und ausnahmesicher (exception safe) spezifiziert [SWS_CRYPT_21313]. Ähnlich wie bei verwandten Kontexten der Kryptografie-Architektur – etwa zur Schlüsselentkapselung [SWS_CRYPT_21413], Signaturerstellung [SWS_CRYPT_23515] oder Schlüsselableitung [SWS_CRYPT_21525] – dient SetKey als elementarer Konfigurationsschritt, bevor kryptografische Berechnungen mit dem geladenen Schlüsselmaterial durchgeführt werden können.

Dieser Verwendungshinweis wurde automatisiert auf Basis der Spezifikationselemente generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
keythe source key object

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if the provided key object is incompatible with this private key context
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowKey Agreement
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context only supports setting a KeySlot

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

Record
AUTOSAR/AP/record/SWS_CRYPT_21313
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21313@rel:R25-11#3d54d9db
Content hash
3d54d9db
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21313
Status: valid/unmigrated Version: rel:R25-11#616d7c1f Versionshistorie & Revisions (1 transition, 7 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_21313@rel:R25-11#616d7c1f
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#3d54d9db2026-09-30
  • R20-11rel:R20-11#52811d232026-10-14
  • R21-11rel:R21-11#8def41192026-10-14
  • R22-11rel:R22-11#8a2370692026-10-14
  • R23-11rel:R23-11#817460022026-10-14
  • R24-11rel:R24-11#45330bed2026-10-14
  • R25-11rel:R25-11#616d7c1f2026-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

function SetKey [SWS_CRYPT_50053] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0;

Configure the context to use the key stored in the provided KeySlot at the time the key agreement is performed.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 747e7368bae2 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Methode SetKey konfiguriert die Instanz von ara::crypto::cryp::KeyAgreementPrivateCtx so, dass für eine nachfolgende Schlüsselvereinbarung der im übergebenen keySlot gespeicherte private Schlüssel verwendet wird [SWS_CRYPT_50053]. Der Aufruf erfolgt synchron und ist als noexcept deklariert.

Verwendung und Parameter

Als Eingabeparameter erwartet die Schnittstelle ein KeySlot::Sptr, welcher einen privaten Schlüssel enthalten muss [SWS_CRYPT_50053]. Das Schlüsselmaterial wird erst zu dem Zeitpunkt herangezogen und ausgewertet, an dem die eigentliche Schlüsselvereinbarung ausgeführt wird [SWS_CRYPT_50053]. Als Alternative zum KeySlot erlaubt der Kontext über [SWS_CRYPT_21313] die direkte Übergabe eines PrivateKey::Sptr.

Fehlerbehandlung und Nebenläufigkeit

Die Methode liefert ein ara::core::Result<void> zurück. Im Fehlerfall greift eine Rollback-Semantik für folgende Fehlercodes [SWS_CRYPT_50053]:

  • ara::crypto::CryptoErrc::kIncompatibleObject: Der übergebene keySlot ist mit dem Kontext inkompatibel [SWS_CRYPT_50053].
  • ara::crypto::CryptoErrc::kUnsupported: Die Kontextimplementierung unterstützt ausschließlich das Setzen eines Schlüssels via PrivateKey [SWS_CRYPT_50053].

Die Ausführung ist als thread-safe und exception safe spezifiziert [SWS_CRYPT_50053].

Dieser Text wurde von einer KI auf Basis der Spezifikation AUTOSAR R25-11 generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
keySlota keyslot containing a private key

Rückgabewert

TypBeschreibung
ara::core::Result< void >An empty result or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if the provided keySlot is incompatible with this context
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context only supports setting a PrivateKey

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50053
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50053@rel:R25-11#a8c300d9
Content hash
a8c300d9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50053
Status: valid/unmigrated Version: rel:R25-11#a8c300d9 Versionshistorie & Revisions (1 transition)
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_50053@rel:R25-11#a8c300d9
Point-in-Time History:
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

function SetParameter [SWS_CRYPT_50051] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, ReadOnlyMemRegion value) noexcept=0;

Set a parameter of the key agreement identified by parameterName.

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
parameterNamean identifier of the parameter
valuean input buffer containing the value of the parameter

Rückgabewert

TypBeschreibung
ara::core::Result< void >an empty result on success or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context does not support the parameter
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided parameter value is invalid

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50051
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50051@rel:R25-11#48be7eb5
Content hash
48be7eb5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50051
Status: valid/unmigrated Version: rel:R25-11#48be7eb5 Versionshistorie & Revisions (1 transition)
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_50051@rel:R25-11#48be7eb5
Point-in-Time History:
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

function SetParameter [SWS_CRYPT_50052] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, std::uint64_t value) noexcept=0;

Set a parameter of the key agreement identified by parameterName.

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
parameterNamean identifier of the parameter
valuean unsigned integer containing the value of the parameter

Rückgabewert

TypBeschreibung
ara::core::Result< void >an empty result on success or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context does not support the parameter
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided parameter value is invalid

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50052
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50052@rel:R25-11#6e0df952
Content hash
6e0df952
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50052
Status: valid/unmigrated Version: rel:R25-11#6e0df952 Versionshistorie & Revisions (1 transition)
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_50052@rel:R25-11#6e0df952
Point-in-Time History:
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

Dokumentation der Typaliase

type alias Sptr [SWS_CRYPT_21301] Upstream: RS_CRYPTO_02104

using Sptr = std::shared_ptr<KeyAgreementPrivateCtx>;

Smart pointer of this interface.

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_21301
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21301@rel:R25-11#e2ebb07f
Content hash
e2ebb07f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21301
Status: valid/unmigrated Version: rel:R25-11#c13d652e 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_21301@rel:R25-11#c13d652e
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#e2ebb07f2026-09-30
  • R19-11rel:R19-11#c18950c82026-10-14
  • R20-11rel:R20-11#65fb94fe2026-10-14
  • R21-11rel:R21-11#65fb94fe2026-10-14
  • R22-11rel:R22-11#23c185892026-10-14
  • R23-11rel:R23-11#abfd06b32026-10-14
  • R24-11rel:R24-11#abfd06b32026-10-14
  • R25-11rel:R25-11#c13d652e2026-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