class ara::crypto::CryptoException

Die Klasse ara::crypto::CryptoException fungiert in der AUTOSAR Adaptive Platform als spezialisierte Ausnahme zur Signalisierung kryptografischer Fehler an aufrufende Anwendungen. Sie leitet sich von ara::core::Exception ab und wird bei fehlgeschlagenen Operationen explizit mit einem ara::core::ErrorCode instanziiert [SWS_CRYPT_19906]. Durch die Spezifikation als noexcept und threadsicher ist eine verlässliche Ausnahmeerzeugung auch in nebenläufigen Umgebungen ohne Folgefehler garantiert [SWS_CRYPT_19906]. Anwendungen müssen kryptografische Aufrufe entsprechend absichern, um unbehandelte Ausnahmen und Programmabbrüche zu vermeiden.

mehr ›

Kontext

Die Klasse ara::crypto::CryptoException definiert den zentralen Ausnahmetyp für Fehlerzustände innerhalb des Krypto-Moduls der AUTOSAR Adaptive Platform. Als Spezialisierung der Standard-Ausnahmeklasse ara::core::Exception schlägt sie die Brücke zwischen der in der Plattform primär genutzten fehlercodebasierten Rückgabe und klassischen C++-Ausnahmebehandlungsmechanismen. Sie kommt in Systemarchitekturen zum Einsatz, in denen kryptografische Operationen fehlschlagen und dieser Fehlerzustand über den Aufrufstapel hinweg als Ausnahme propagiert werden muss. Zu den primären Interaktionspartnern zählen kryptografische Funktionsmodule und Dienste, welche bei unvorhergesehenen Fehlern oder expliziten Prüfungen Ausnahmen auslösen, sowie übergeordnete Anwendungskomponenten, die kryptografische Vorgänge wie Verschlüsselung, Signaturprüfung oder Schlüsselverwaltung anstoßen und eventuelle Fehler abfangen. Durch die Verankerung im gemeinsamen Fehlerdomänenkonzept der Plattform stellt ara::crypto::CryptoException sicher, dass kryptografische Fehler konsistent und typisiert an die Anwendungslogik gemeldet werden.

Lebenszyklus

Die Erzeugung eines Objekts von ara::crypto::CryptoException erfolgt deterministisch durch Übergabe eines Fehlercodes vom Typ ara::core::ErrorCode an den Konstruktor [SWS_CRYPT_19906]. Dieser Konstruktor ist als explicit deklariert, um implizite Typkonvertierungen aus Fehlercodes zu unterbinden, und besitzt die Spezifikation noexcept [SWS_CRYPT_19906]. Letzteres garantiert, dass bei der Konstruktion der Ausnahme selbst keine weiteren Ausnahmen ausgelöst werden können, was die Ausnahme- und Betriebssicherheit des Krypto-Subsystems wesentlich erhöht. Gemäß der Spezifikation ist die Implementierung als thread-safe eingestuft [SWS_CRYPT_19906], sodass Instanzen auch in nebenläufigen Ausführungsumgebungen zuverlässig instanziiert und verarbeitet werden können. Hinsichtlich der Besitzverhältnisse wird die Ausnahme typischerweise by-value geworfen und im abfangenden Block als konstante Referenz gebunden. Da die Klasse keine dynamischen Ressourcen über den Fehlercode hinaus verwaltet, endet ihr Lebenszyklus regulär mit dem Verlassen des behandelnden catch-Blocks (Interpretation). Frage (offen)

Nutzungspfad

Der reguläre Nutzungspfad beginnt innerhalb einer kryptografischen Operation, wenn eine Fehlerbedingung auftritt, die nicht lokal aufgelöst werden kann. Das Modul identifiziert die Fehlerursache anhand der kryptografischen Fehlerdomäne aus der Header-Datei ara/crypto/common/crypto_error_domain.h und erzeugt einen entsprechenden ara::core::ErrorCode [SWS_CRYPT_19906]. Im Anschluss wird eine Instanz von ara::crypto::CryptoException mit diesem Fehlercode instanziiert [SWS_CRYPT_19906] und mittels einer throw-Anweisung signalisiert. Auf Anwendungsseite fängt die aufrufende Komponente die Ausnahme gezielt über catch (const ara::crypto::CryptoException& e) ab. Alternativ erlaubt die Vererbungshierarchie auch das polymorphe Fangen als generische ara::core::Exception. Durch Abfrage des enthaltenen ara::core::ErrorCode kann die Anwendung im Anschluss die spezifische kryptografische Fehlerursache analysieren und geeignete Gegenmaßnahmen ergreifen.

Sequenzdiagramm: Typischer Ablauf der Fehlerbehandlung und Ausnahmeauslösung bei kryptografischen Operationen. Quellen: [SWS_CRYPT_19906]

Fehlerszenarien

Da ara::crypto::CryptoException selbst das Vehikel zur Fehlersignalisierung darstellt, liegt das Hauptaugenmerk bei Fehlerszenarien auf der Robustheit der Ausnahmeerzeugung. Durch die Zusicherung der Ausnahme- und Thread-Sicherheit sowie der noexcept-Garantie des Konstruktors wird verhindert, dass während einer bereits aktiven Fehlerbehandlung sekundäre Ausnahmen auftreten [SWS_CRYPT_19906]. Ein potenzielles Fehlerszenario in der Anwendungslogik besteht darin, dass ein übergebener ara::core::ErrorCode unerwartete oder nicht-kryptografische Fehlerdomänen kapselt; vermutlich verarbeitet die Exception den Fehlercode dennoch neutral und transportiert ihn unverändert an den Behandler (Interpretation). Frage Q-0bb3376f547ce024 (offen) Ein weiteres Risiko auf Systemebene besteht im Unterlassen des Abfangens der Ausnahme, was im C++-Laufzeitumfeld zum Aufruf von std::terminate führen würde. Daher müssen aufrufende Komponenten, die APIs ohne fehlercodebasierte Rückgabe nutzen, kryptografische Aufrufe konsequent mit entsprechenden catch-Blöcken absichern.