class ara::crypto::cryp::PrivateKey

Die Schnittstelle ara::crypto::cryp::PrivateKey definiert das allgemeine Interface für asymmetrische private Schlüssel in AUTOSAR Adaptive und wird primär über den Shared-Pointer-Alias PrivateKey::Sptr verwaltet [SWS_CRYPT_22501]. Ihre zentrale Funktion GetPublicKey() ermöglicht es, den zugehörigen öffentlichen Schlüssel als PublicKey::Sptr abzurufen, um ihn für kryptografische Partneroperationen bereitzustellen [SWS_CRYPT_22511]. Dieser Abruf ist threadsicher sowie ausnahmesicher ohne standardisierte Fehlercodes spezifiziert, wobei eventuelle Fehler implementationsspezifisch über den Rückgabetyp ara::core::Result signalisiert werden dürften (Interpretation). Frage (offen)

mehr ›

Kontext

Die Schnittstelle ara::crypto::cryp::PrivateKey fungiert in der AUTOSAR Adaptive Platform als generalisiertes Interface für asymmetrische private Schlüssel innerhalb des Moduls crypto. Sie ist in der Header-Datei ara/crypto/cryp/cryobj/private_key.h deklariert und leitet sich direkt von der Basisschnittstelle CryptoObject ab. Als Kernkomponente des asymmetrischen Kryptografiesystems kapselt PrivateKey das vertrauliche Schlüsselmaterial, welches für kryptografische Operationen wie die Erzeugung digitaler Signaturen oder asymmetrische Entschlüsselungsverfahren benötigt wird.

Zu den primären Interaktionspartnern gehören neben der Basisklasse CryptoObject insbesondere die korrespondierende öffentliche Schlüsselschnittstelle PublicKey sowie konsumierende Krypto-Dienste und Anwendungsroutinen. Während der private Schlüssel stets geheim zu halten ist, ermöglicht die Schnittstelle über die Elementfunktion GetPublicKey() die direkte Bereitstellung des zugehörigen öffentlichen Schlüssels [SWS_CRYPT_22511]. Auf diese Weise wird eine feste typbezogene Beziehung zwischen dem privaten Schlüssel und seinem mathematischen Gegenstück realisiert.

Kontextdiagramm: Einbettung von PrivateKey im kryptografischen Objektmodell und Beziehung zum korrespondierenden PublicKey. Quellen: [SWS_CRYPT_22501], [SWS_CRYPT_22511]

Lebenszyklus

Die Verwaltung und Übergabe von Instanzen der Schnittstelle PrivateKey erfolgt über den typisierten Smart-Pointer PrivateKey::Sptr, der als Typ-Alias für std::shared_ptr<PrivateKey> definiert ist [SWS_CRYPT_22501]. Dieser Shared-Pointer gewährleistet eine geteilte Eigentümerschaft und ein automatisches Ressourcenmanagement über Referenzzählung, sodass das geschützte Schlüsselmaterial freigegeben wird, sobald die letzte Referenz erlischt.

Da PrivateKey eine abstrakte Schnittstelle mit rein virtuellen Methoden wie GetPublicKey() darstellt [SWS_CRYPT_22511], können Anwendungen die Klasse nicht direkt instanziieren. Die Erzeugung und Bereitstellung konkreter Instanzen von PrivateKey::Sptr dürfte vermutlich über spezialisierte Fabriken, Schlüsselverwaltungskomponenten oder Krypto-Provider des Adaptive-Systems erfolgen (Interpretation). Frage Q-f0f9fe2258fac168 (offen) Das Interface selbst definiert keine diskreten internen Zustände oder Zustandsübergänge.

Hinsichtlich der Nebenläufigkeit spezifiziert die Schnittstelle für die zentrale Elementfunktion GetPublicKey() explizit Thread-Sicherheit (thread-safe) [SWS_CRYPT_22511]. Dies gestattet mehreren Ausführungssträngen den nebenläufigen, synchronisationsfreien Lesezugriff auf dieselbe Schlüsselinstanz zur Gewinnung des korrespondierenden öffentlichen Schlüssels.

Nutzungspfad

Der typische Nutzungspfad von PrivateKey umfasst den Empfang des privaten Schlüssels und die anschließende Extraktion des korrespondierenden öffentlichen Schlüssels für Validierungs-, Registrierungs- oder Kommunikationszwecke:

1. Schlüsselbezug: Die konsumierende Softwarekomponente erhält eine gültige Instanz eines asymmetrischen privaten Schlüssels in Form eines PrivateKey::Sptr [SWS_CRYPT_22501].
2. Abruf des Partnerschlüssels: Wenn für einen nachgelagerten Arbeitsablauf der korrespondierende öffentliche Schlüssel benötigt wird, ruft die Komponente die Elementfunktion GetPublicKey() auf der Instanz auf [SWS_CRYPT_22511].
3. Ergebnisverarbeitung: Der Aufruf liefert ein ara::core::Result<PublicKey::Sptr> zurück [SWS_CRYPT_22511]. Die Anwendung prüft das Ergebnisobjekt auf Erfolg und entpackt bei erfolgreicher Ausführung den Zeiger PublicKey::Sptr.
4. Weiterverwendung: Der gewonnene öffentliche Schlüssel kann anschließend an externe Kommunikationspartner übermittelt oder lokalen Verifikationsroutinen übergeben werden. Die Ableitung des öffentlichen Schlüssels dürfte intern vermutlich direkt aus den mathematischen Schlüsselparametern des privaten Schlüssels erfolgen (Interpretation). Frage Q-464000dc5d638649 (offen)

Fehlerszenarien

Für eine fehlerfreie Integration sind die Fehlereigenschaften und Randbedingungen von GetPublicKey() maßgeblich:

• Standardisierte Fehler: Gemäß Spezifikation definiert die Funktion GetPublicKey() keine standardisierten Fehlercodes [SWS_CRYPT_22511].
• Fehlerkanal: Obwohl keine standardisierten Fehler festgelegt sind, transportiert der Rückgabetyp ara::core::Result potentielle Fehlschläge. Falls bei der internen Schlüsselableitung oder Objekterzeugung ein Fehler auftritt, dürfte das Ergebnisobjekt vermutlich implementationsspezifische Fehlercodes der zugrunde liegenden Krypto-Treiber enthalten (Interpretation). Frage Q-4af6390594d9c5e1 (offen)
• Ausnahmesicherheit: Die Funktion ist explizit als ausnahmesicher (exception safe) eingestuft und mit dem Bezeichner noexcept versehen [SWS_CRYPT_22511]. Aufrufer müssen daher keine C++-Ausnahmen abfangen.
• Vor- und Nachbedingungen: Vorbedingung für den erfolgreichen Aufruf ist eine valide, nicht freigegebene PrivateKey-Instanz. Als Nachbedingung garantiert die Schnittstelle im Erfolgsfall die Rückgabe eines PublicKey::Sptr, der mathematisch exakt zum privaten Schlüssel korrespondiert [SWS_CRYPT_22511].