DEENESPTFRRUARHIKOZHNL

class ara::crypto::cryp::KeyDerivationFunctionCtx

[SWS_CRYPT_21500] Upstream: RS_CRYPTO_02103

class KeyDerivationFunctionCtx :               public CryptoContext {...};

Key Derivation Function interface.

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

User GuideKI-GENERIERT

Leitet symmetrische Schlüssel aus Basisschlüsseln und konfigurierbaren Kontextparametern sicher ab.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 0339805a1afd Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Leitet symmetrische Schlüssel aus Basisschlüsseln und konfigurierbaren Kontextparametern sicher ab.

Die Schnittstelle ara::crypto::cryp::KeyDerivationFunctionCtx dient der Ableitung neuer symmetrischer Schlüssel aus vorhandenem Schlüsselmaterial und konfigurierbaren Kontextparametern wie Salts oder Zählern [SWS_CRYPT_21515]. Vor der Schlüsselgenerierung mittels DeriveKey muss der Kontext über SetKey mit einem Schlüssel oder KeySlot initialisiert und optional über SetParameter konfiguriert werden [SWS_CRYPT_21525]. Als wesentliche Sicherheitsbedingung darf die Ableitung nur erfolgen, wenn das Quellschlüsselmaterial explizit für KDF-Operationen autorisiert ist und die geforderten Verwendungsflags des Zielschlüssels kompatibel sind.

Kontext

Die Klasse ara::crypto::cryp::KeyDerivationFunctionCtx stellt die Schnittstelle für Schlüsselableitungsfunktionen (Key Derivation Functions, KDF) im Kryptomodul von AUTOSAR Adaptive bereit. Ihre Hauptaufgabe besteht darin, aus vorgegebenem Schlüsselmaterial und konfigurierbaren Kontextparametern neue symmetrische Schlüssel abzuleiten [SWS_CRYPT_21515].

Typische Interaktionspartner sind aufrufende Anwendungsdienste, das zugrunde liegende Quellmaterial in Gestalt eines SymmetricKey [SWS_CRYPT_21525] oder eines KeySlot [SWS_CRYPT_50010] sowie das Ergebnis der Ableitung in Form eines neuen SymmetricKey::Sptr [SWS_CRYPT_21515]. Zusätzliche kryptografische Parameter können als Speicherregionen, Ganzzahlen oder Hilfsschlüssel übergeben werden [SWS_CRYPT_50007] [SWS_CRYPT_50008] [SWS_CRYPT_50009].

Lebenszyklus

Die Lebensdauer und der Besitz von Instanzen werden über den typisierten Smart-Pointer ara::crypto::cryp::KeyDerivationFunctionCtx::Sptr gesteuert [SWS_CRYPT_21501]. Die Erzeugung einer konkreten Implementierungsinstanz dürfte über eine spezialisierte Factory oder den zuständigen CryptoProvider erfolgen, da die Klasse eine rein virtuelle Schnittstelle definiert. Frage Q-8ba3d498c9921ab1 (offen)

Ein neu erzeugter Kontext befindet sich zunächst in einem unvollständigen Zustand. Erst nach erfolgreicher Zuweisung eines Schlüssels über SetKey [SWS_CRYPT_21525] [SWS_CRYPT_50010] und dem Setzen erforderlicher KDF-Parameter über SetParameter [SWS_CRYPT_50007] [SWS_CRYPT_50008] [SWS_CRYPT_50009] ist der Kontext bereit für die Berechnung. Hinsichtlich der Nebenläufigkeit sind die Schnittstellenmethoden thread-safe und exceptionsicher deklariert ([SWS_CRYPT_21515], [SWS_CRYPT_21525], [SWS_CRYPT_50007]).

Nutzungspfad

Die typische Aufrufreihenfolge zur Schlüsselableitung umfasst drei aufeinanderfolgende Phasen:

  1. Basisschlüssel zuweisen: Über SetKey wird das Ausgangsschlüsselmaterial konfiguriert. Hierbei kann entweder ein existierendes Schlüsselobjekt (SymmetricKey::Sptr) [SWS_CRYPT_21525] oder ein persistenter Schlüsselspeicherplatz (KeySlot::Sptr) [SWS_CRYPT_50010] übergeben werden.
  2. Kontextparameter konfigurieren: KDF-spezifische Werte wie Salt, Initialisierungsvektoren oder Iterationszähler werden über SetParameter definiert. Unterstützt werden Speicherpuffer (ReadOnlyMemRegion) [SWS_CRYPT_50007], 64-Bit-Ganzzahlen (std::uint64_t) [SWS_CRYPT_50008] und zusätzliche symmetrische Schlüssel (SymmetricKey::Sptr) [SWS_CRYPT_50009].
  3. Zielschlüssel ableiten: Der Aufruf von DeriveKey führt die kryptografische Berechnung aus [SWS_CRYPT_21515]. Die Methode erwartet die Zielalgorithmuskennung (AlgId) sowie die erlaubten Nutzungsflags (AllowedUsageFlags) und liefert im Erfolgsfall einen SymmetricKey::Sptr zurück.
Ablauf der Schlüsselableitung mit KeyDerivationFunctionCtxAnwendungKeyDerivationFunctionCtxSymmetricKeySetKey(key)Result<void>SetParameter("salt", saltValue)Result<void>DeriveKey(targetAlgId, allowedUsage)Erzeuge abgeleiteten SchlüsselResult<SymmetricKey::Sptr>

Sequenzdiagramm: Typische Aufrufreihenfolge zur Ableitung eines symmetrischen Schlüssels über KeyDerivationFunctionCtx. Quellen: [SWS_CRYPT_21525], [SWS_CRYPT_50007], [SWS_CRYPT_21515].

Fehlerszenarien

Die Schnittstellenmethoden signalisieren Fehlerfälle über ara::core::Result unter Verwendung definierter Fehlercodes:

  • Unvollständige Initialisierung: Wird DeriveKey ohne ausreichende Konfiguration aufgerufen, schlägt der Aufruf mit ara::crypto::CryptoErrc::kUninitializedContext fehl [SWS_CRYPT_21515]. Ist ein zugewiesener KeySlot zum Ausführungszeitpunkt leer, wird ara::crypto::CryptoErrc::kEmptyKeySlot gemeldet [SWS_CRYPT_21515].
  • Verletzung von Nutzungsrechten: Der Quellschlüssel muss die Operation kAllowKeyDerivation gestatten, andernfalls wird ara::crypto::CryptoErrc::kUsageViolation ausgelöst ([SWS_CRYPT_21525], [SWS_CRYPT_21515], [SWS_CRYPT_50009]). Beinhaltet das Ziel kAllowPlaintextExport, muss der Quellschlüssel zusätzlich kAllowDerivedPlaintextExport aufweisen, sonst resultiert ebenfalls kUsageViolation [SWS_CRYPT_21515].
  • Inkompatibilität und ungültige Argumente: Ein nicht unterstützter Zielalgorithmus liefert UnknownIdentifier, und zueinander inkompatible Nutzungsflags erzeugen ara::crypto::CryptoErrc::kIncompatibleArguments [SWS_CRYPT_21515]. Für den Kontext unpassende Schlüsselobjekte oder KeySlots quittiert SetKey mit ara::crypto::CryptoErrc::kIncompatibleObject ([SWS_CRYPT_21525], [SWS_CRYPT_50010]). Ungültige Parameterwerte führen zu ara::crypto::CryptoErrc::kInvalidArgument ([SWS_CRYPT_50007], [SWS_CRYPT_50008]).
  • Nicht unterstützte Schnittstellenfunktionen: Unterstützt eine konkrete Implementierung ausschließlich KeySlot oder ausschließlich SymmetricKey, führt der jeweils andere SetKey-Aufruf zu ara::crypto::CryptoErrc::kUnsupported ([SWS_CRYPT_21525], [SWS_CRYPT_50010]). Unbekannte Parameternamen bei SetParameter erzeugen ebenfalls kUnsupported ([SWS_CRYPT_50007], [SWS_CRYPT_50008], [SWS_CRYPT_50009]).
  • Ressourcenkonflikte: Ist eine für die Berechnung erforderliche Krypto-Ressource blockiert, signalisiert DeriveKey den Fehlercode ara::crypto::CryptoErrc::kBusyResource [SWS_CRYPT_21515].

Dieser Leitfaden wurde durch eine KI kuratiert. Alle fachlichen Aussagen stützen sich ausschließlich auf die Spezifikation von AUTOSAR Adaptive (Release R25-11).

Mitgliederkarte

Methoden

3
DeriveKeySetKeySetParameter

Typaliase

1
Sptr

Klassendiagramm

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

G nara__crypto__cryp__KeyDerivationFunctionCtx485 KeyDerivationFunctionCtx + DeriveKey() + SetKey() + SetParameter() nara__crypto__cryp__CryptoContext85 CryptoContext nara__crypto__cryp__KeyDerivationFunctionCtx485->nara__crypto__cryp__CryptoContext85

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Methoden

DeriveKey function

Derive a symmetric key from the provided key material and provided context configuration, e.g., salt, context, IV, iteration count.

virtual ara::core::Result< SymmetricKey::Sptr > DeriveKey (AlgId targetAlgId, AllowedUsageFlags allowedUsage) const noexcept=0;
SetKey function 2

Configure the context to use the provided key.

Überladungen SetKey 2
virtual ara::core::Result< void > SetKey (SymmetricKey::Sptr key) noexcept=0; SWS_CRYPT_21525
virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0; SWS_CRYPT_50010
SetParameter function 3

Set a parameter of the KDF identified by parameterName.

Überladungen SetParameter 3
virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, ReadOnlyMemRegion value) noexcept=0; SWS_CRYPT_50007
virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, std::uint64_t value) noexcept=0; SWS_CRYPT_50008
virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, SymmetricKey::Sptr value) noexcept=0; SWS_CRYPT_50009

Typaliase

Sptr type alias

Smart pointer of the interface.

using Sptr = std::shared_ptr<KeyDerivationFunctionCtx>;

Dokumentation der Methoden

function DeriveKey [SWS_CRYPT_21515] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111, RS_CRYPTO_02115

virtual ara::core::Result< SymmetricKey::Sptr > DeriveKey (AlgId targetAlgId, AllowedUsageFlags allowedUsage) const noexcept=0;

Derive a symmetric key from the provided key material and provided context configuration, e.g., salt, context, IV, iteration count.

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

Die Methode DeriveKey der Klasse ara::crypto::cryp::KeyDerivationFunctionCtx leitet synchron einen neuen symmetrischen Schlüssel aus dem vorhandenen Schlüsselmaterial sowie den im Kontext hinterlegten Parametern wie Salt, Initialisierungsvektor (IV) oder Iterationszähler ab [SWS_CRYPT_21515].

Verwendung

Beim Aufruf werden der Bezeichner des gewünschten Kryptoalgorithmus über targetAlgId sowie die erlaubten Nutzungsflags über allowedUsage übergeben [SWS_CRYPT_21515]. Als Rückgabewert liefert die Funktion synchron ein ara::core::Result<SymmetricKey::Sptr>, das bei erfolgreicher Ausführung einen Smart Pointer auf das erzeugte symmetrische Schlüsselobjekt bereitstellt [SWS_CRYPT_21515].

Fehlerbehandlung

Schlägt die Schlüsselerzeugung fehl, garantiert die Funktion Rollback-Semantik und gibt einen entsprechenden Fehlercode im ara::core::Result zurück [SWS_CRYPT_21515]:

  • UnknownIdentifier: Wird gemeldet, falls der übergebene Wert für targetAlgId nicht unterstützt wird [SWS_CRYPT_21515].
  • ara::crypto::CryptoErrc::kIncompatibleArguments: Tritt auf, wenn die in allowedUsage festgelegten Nutzungsflags nicht mit dem Zielalgorithmus kompatibel sind [SWS_CRYPT_21515].
  • ara::crypto::CryptoErrc::kUninitializedContext: Der Kontext wurde vor der Schlüsselableitung nicht hinreichend initialisiert [SWS_CRYPT_21515].
  • ara::crypto::CryptoErrc::kBusyResource: Eine für die Schlüsselableitung erforderliche Ressource ist belegt [SWS_CRYPT_21515].
  • ara::crypto::CryptoErrc::kEmptyKeySlot: Ein für die Operation konfigurierter KeySlot ist gegenwärtig leer [SWS_CRYPT_21515].
  • ara::crypto::CryptoErrc::kUsageViolation: Tritt auf, wenn die Nutzungsberechtigung des Quellschlüssels kAllowKeyDerivation nicht enthält oder wenn das Ziel kAllowPlaintextExport fordert, die Quelle jedoch kein kAllowDerivedPlaintextExport gestattet [SWS_CRYPT_21515].

Nebenläufigkeit und Ausführungskontext

Die Methode ist als noexcept spezifiziert, bietet Ausnahmesicherheit (exception safe) und ist thread-safe für den gleichzeitigen Aufruf ausgelegt [SWS_CRYPT_21515].

Dieser Nutzungshinweis wurde automatisch generiert und basiert ausschließlich auf den Spezifikationsdaten von AUTOSAR R25-11.

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

Parameter (in)

ParameterBeschreibung
targetAlgIdthe identifier of the target symmetric crypto algorithm
allowedUsagethe flags that define a list of allowed usages in which the target key can be used.

Rückgabewert

TypBeschreibung
ara::core::Result<SymmetricKey::Sptr >result containing a shared pointer to the created symmetric key object or an error

Fehler

FehlercodeBeschreibung
UnknownIdentifierif targetAlgId has an unsupported value
ara::crypto::CryptoErrc::kIncompatibleArgumentsrollback_semantics if the allowedUsage of the derived key is incompatible with the targetAlgId.
ara::crypto::CryptoErrc::kUninitializedContextrollback_semantics if the context has not been sufficiently initialized
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the source key does not include kAllowKey Derivation
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowedUsage of the target key includes kAllowPlaintext Export but the allowed usage of the source key does not include k AllowDerivedPlaintextExport

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

Record
AUTOSAR/AP/record/SWS_CRYPT_21515
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21515@rel:R25-11#4792442a
Content hash
4792442a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21515
Status: valid/unmigrated Version: rel:R25-11#9b38f620 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_21515@rel:R25-11#9b38f620
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#4792442a2026-09-30
  • R19-11rel:R19-11#d747dcdf2026-10-14
  • R20-11rel:R20-11#20ca9f5b2026-10-14
  • R21-11rel:R21-11#4e7c875e2026-10-14
  • R22-11rel:R22-11#1edafd582026-10-14
  • R23-11rel:R23-11#09e184cc2026-10-14
  • R24-11rel:R24-11#f4962bb42026-10-14
  • R25-11rel:R25-11#9b38f6202026-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_21525] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (SymmetricKey::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: 3738ec7c9403 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die Methode SetKey dient der Konfiguration eines KeyDerivationFunctionCtx mit dem als key bereitgestellten symmetrischen Schlüsselmaterial [SWS_CRYPT_21525]. Die Funktion wird synchron ausgeführt und signalisiert den Ausgang der Operation über den Rückgabetyp ara::core::Result<void> [SWS_CRYPT_21525].

Nebenläufigkeit und Ausführungssicherheit

Die Schnittstelle ist mit dem Spezifizierer noexcept versehen und als exception-safe eingestuft [SWS_CRYPT_21525]. Zudem ist die Ausführung als thread-safe spezifiziert, sodass der Aufruf auch in nebenläufigen Umgebungen sicher erfolgen kann [SWS_CRYPT_21525].

Fehlerbehandlung

Im Fehlerfall wird kein leerer Erfolgsstatus, sondern ein entsprechender Fehlercode zurückgegeben, wobei für alle Fehlerfälle eine Rollback-Semantik definiert ist [SWS_CRYPT_21525]:

  • ara::crypto::CryptoErrc::kIncompatibleObject: Das übergebene Schlüsselobjekt ist mit dem symmetrischen Kontext inkompatibel [SWS_CRYPT_21525].
  • ara::crypto::CryptoErrc::kUsageViolation: Die für den Schlüssel zulässige Verwendung beinhaltet nicht die Berechtigung kAllowKey Derivation [SWS_CRYPT_21525].
  • ara::crypto::CryptoErrc::kUnsupported: Der konkrete Kontext unterstützt ausschließlich die Zuweisung über einen KeySlot [SWS_CRYPT_21525].

Zusammenspiel

Sofern die zugrunde liegende Kontext-Implementierung die direkte Zuweisung eines SymmetricKey::Sptr nicht unterstützt oder der Schlüssel stattdessen erst zum Zeitpunkt der Schlüsselableitung aus einem Speicherplatz bezogen werden soll, steht die alternative Überladung von SetKey mit einem KeySlot::Sptr zur Verfügung [SWS_CRYPT_50010].

Dieser Nutzungshinweis wurde automatisiert auf Basis der AUTOSAR-Spezifikation R25-11 generiert.

Implementer's Guide folgt (Komplexität I2)

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

Parameter (in)

ParameterBeschreibung
keythe source key-material

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 symmetric key context
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowKey Derivation
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_21525
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21525@rel:R25-11#a05f5b63
Content hash
a05f5b63
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21525
Status: valid/unmigrated Version: rel:R25-11#eca8e8d8 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_21525@rel:R25-11#eca8e8d8
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#a05f5b632026-09-30
  • R20-11rel:R20-11#33ea902d2026-10-14
  • R21-11rel:R21-11#46a880c32026-10-14
  • R22-11rel:R22-11#fed116fd2026-10-14
  • R23-11rel:R23-11#3143ac902026-10-14
  • R24-11rel:R24-11#db6fdd502026-10-14
  • R25-11rel:R25-11#eca8e8d82026-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_50010] 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 derivation is performed.

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

Die virtuelle Methode SetKey konfiguriert den Kontext KeyDerivationFunctionCtx für die Verwendung eines Schlüssels, der in einem übergebenen KeySlot gespeichert ist, sobald die Schlüsselableitung durchgeführt wird [SWS_CRYPT_50010]. Als Parameter nimmt die Funktion einen Smart-Pointer KeySlot::Sptr entgegen, welcher einen Slot mit einem symmetrischen Schlüssel referenziert [SWS_CRYPT_50010].

Der Aufruf erfolgt synchron und ist als exceptionsicher (exception safe) sowie nicht-werfend (noexcept) spezifiziert [SWS_CRYPT_50010]. Die Funktion liefert ein ara::core::Result<void> zurück, das im Erfolgsfall leer ist oder im Fehlerfall einen entsprechenden Fehlercode kapselt [SWS_CRYPT_50010]. Tritt ein Fehler auf, wird der vorherige Zustand über eine Rollback-Semantik gewahrt [SWS_CRYPT_50010]:

  • ara::crypto::CryptoErrc::kIncompatibleObject: Wird zurückgegeben, wenn der bereitgestellte keySlot mit dem aktuellen Kontext inkompatibel ist [SWS_CRYPT_50010].
  • ara::crypto::CryptoErrc::kUnsupported: Tritt auf, wenn der konkrete Kontext ausschließlich das Setzen eines SymmetricKey unterstützt [SWS_CRYPT_50010].

Für den gleichzeitigen Zugriff aus mehreren Threads ist die Methode als thread-sicher (thread-safe) ausgewiesen [SWS_CRYPT_50010]. Hinsichtlich des Zusammenspiels dient die Operation als Alternative zur Überladung von SetKey mit einem SymmetricKey::Sptr, welche das Schlüsselmaterial direkt anstelle einer Slot-Referenz entgegennimmt [SWS_CRYPT_21525].

Dieser Nutzungshinweis wurde automatisiert anhand der AUTOSAR-Spezifikation erstellt.

Implementer's Guide folgt (Komplexität I2)

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

Parameter (in)

ParameterBeschreibung
keySlota keyslot containing a symmetric 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 SymmetricKey

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50010
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50010@rel:R25-11#8eb8c6c4
Content hash
8eb8c6c4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50010
Status: valid/unmigrated Version: rel:R25-11#8eb8c6c4 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_50010@rel:R25-11#8eb8c6c4
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_50007] 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 KDF identified by parameterName.

Header-Datei#include "ara/crypto/cryp/key_derivation_function_ctx.h"
Scopeclass ara::crypto::cryp::KeyDerivationFunctionCtx
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_50007
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50007@rel:R25-11#4c314faf
Content hash
4c314faf
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50007
Status: valid/unmigrated Version: rel:R25-11#4c314faf 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_50007@rel:R25-11#4c314faf
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_50008] 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 KDF identified by parameterName.

Header-Datei#include "ara/crypto/cryp/key_derivation_function_ctx.h"
Scopeclass ara::crypto::cryp::KeyDerivationFunctionCtx
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_50008
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50008@rel:R25-11#26b90c19
Content hash
26b90c19
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50008
Status: valid/unmigrated Version: rel:R25-11#26b90c19 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_50008@rel:R25-11#26b90c19
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_50009] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

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

Set a parameter of the KDF identified by parameterName.

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

Parameter (in)

ParameterBeschreibung
parameterNamean identifier of the parameter
valueSymmetricKey being used as the input 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::kIncompatibleObjectrollback_semantics if the provided key is incompatible with this context
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowKey Derivation

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50009
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50009@rel:R25-11#92b1f35c
Content hash
92b1f35c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50009
Status: valid/unmigrated Version: rel:R25-11#92b1f35c 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_50009@rel:R25-11#92b1f35c
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_21501] Upstream: RS_CRYPTO_02103

using Sptr = std::shared_ptr<KeyDerivationFunctionCtx>;

Smart pointer of the interface.

Header-Datei#include "ara/crypto/cryp/key_derivation_function_ctx.h"
Scopeclass ara::crypto::cryp::KeyDerivationFunctionCtx
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_21501
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21501@rel:R25-11#4fb24cfc
Content hash
4fb24cfc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21501
Status: valid/unmigrated Version: rel:R25-11#6ebb94e3 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_21501@rel:R25-11#6ebb94e3
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#4fb24cfc2026-09-30
  • R19-11rel:R19-11#e5d0fc6d2026-10-14
  • R20-11rel:R20-11#c13472492026-10-14
  • R21-11rel:R21-11#c13472492026-10-14
  • R22-11rel:R22-11#461242d92026-10-14
  • R23-11rel:R23-11#aa4dc94a2026-10-14
  • R24-11rel:R24-11#aa4dc94a2026-10-14
  • R25-11rel:R25-11#6ebb94e32026-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