class ara::crypto::cryp::WriteableKeySlot

Die Schnittstelle ara::crypto::cryp::WriteableKeySlot dient in AUTOSAR Adaptive als schreibbare Abstraktion für Schlüsselspeicherorte in einem Crypto-Provider. Instanzen können weder kopiert noch verschoben werden ([SWS_CRYPT_50170], [SWS_CRYPT_50168]), sondern werden über den Smart-Pointer-Typ Sptr referenziert [SWS_CRYPT_50172]. Über die threadsichere Methode Clear() wird der Inhalt des Schlüsselplatzes bereinigt, wobei im Fehlerfall wie kBusyResource oder kUnsupported eine Rollback-Semantik greift [SWS_CRYPT_30405].

mehr ›

Kontext

Die Schnittstelle ara::crypto::cryp::WriteableKeySlot definiert innerhalb der AUTOSAR Adaptive Platform einen schreibbaren Speicherplatz für kryptografische Schlüssel im Kontext eines Crypto-Providers. Sie leitet sich direkt von der Basisschnittstelle KeySlot ab und stellt eine standardisierte Abstraktion dar, um verwaltete Schlüsselplätze gezielt zu bereinigen und deren Lebenszyklus zu steuern. Als wesentliche Interaktionspartner fungieren Anwendungen des Krypto-Stacks als Konsumenten sowie der konkrete Crypto-Provider, welcher die Bindung an den physischen oder logischen Schlüsselspeicher verwaltet. Die Erzeugung konkreter Instanzen dürfte dabei vermittels übergeordneter Fabrik- oder Provider-Methoden erfolgen, da die Schnittstelle als reine abstrakte Basisklasse fungiert. Frage Q-5c3b13bb35c3ff53 (offen)

Lebenszyklus

Das Ressourcen- und Besitzmodell von ara::crypto::cryp::WriteableKeySlot verhindert strikt das Duplizieren von Schlüsselreferenzen über Wertsemantik. Zu diesem Zweck sind sowohl der Copy-Konstruktor [SWS_CRYPT_50170] als auch der Move-Konstruktor [SWS_CRYPT_50171] explizit gelöscht (=delete). Gleichermaßen unterbinden die gelöschten Deklarationen des Copy-Zuweisungsoperators [SWS_CRYPT_50168] und des Move-Zuweisungsoperators [SWS_CRYPT_50169] jegliche nachträgliche Zuweisung.

Die referenzielle Weitergabe und geteilte Verwaltung erfolgt stattdessen über den definierten Smart-Pointer-Typalias Sptr, welcher als std::shared_ptr<WriteableKeySlot> ausgeprägt ist [SWS_CRYPT_50172]. Die Zerstörung der Instanz wird durch einen virtuellen Standard-Destruktor abgesichert, der als ausnahmesicher (exception safe) spezifiziert ist und keine Ausnahmen emittiert (noexcept=default) [SWS_CRYPT_50167]. Dies erlaubt die sichere polymorphe Freigabe über Zeiger auf die Schnittstelle. Zustandsbezogen kann ein Slot belegt oder leer sein. Das Belegen des Slots dürfte über separate Schnittstellen des Crypto-Providers stattfinden, während das Leeren über die threadsichere Methode Clear() realisiert wird [SWS_CRYPT_30405]. Frage Q-72dfcb17eb3e2d25 (offen)

Zustandsdiagramm: Zustandsübergänge des Schlüsselinhalts durch Clear() und Fehlerbehandlung. Quellen: [SWS_CRYPT_30405]

Nutzungspfad

Der zentrale Nutzungspfad konzentriert sich auf das kontrollierte Zurücksetzen bzw. Löschen des gespeicherten Schlüsselmaterials:

• Referenzierung: Der Aufrufer greift über einen gemeinsam genutzten Zeiger des Typs WriteableKeySlot::Sptr auf die Instanz zu [SWS_CRYPT_50172].
• Löschaufruf: Durch den Aufruf der rein virtuellen Methode Clear() wird der Löschvorgang für den aktuellen Inhalt des Schlüsselplatzes angestoßen [SWS_CRYPT_30405]. Da die Methode threadsicher ist, kann der Aufruf auch in nebenläufigen Kontexten erfolgen [SWS_CRYPT_30405].
• Ergebnisüberprüfung: Die Operation liefert ein ara::core::Result<void> zurück [SWS_CRYPT_30405]. War der Schlüsselplatz bereits zuvor leer oder wurde der Inhalt fehlerfrei entfernt, repräsentiert das Ergebnis einen erfolgreichen Zustand mit leerem Wert [SWS_CRYPT_30405].

Fehlerszenarien

Die Methode Clear() ist als ausnahmesicher und noexcept deklariert; Fehlersituationen werden nach dem Fehlermodell von AUTOSAR Adaptive über ara::core::Result transportiert [SWS_CRYPT_30405]. Mögliche Fehlercodes umfassen:

• ara::crypto::CryptoErrc::kUnsupported: Tritt auf, wenn die konkrete Ausprägung des Schlüsselplatzes kein Löschen unterstützt [SWS_CRYPT_30405]. Für diesen Fall garantiert die Schnittstelle eine Rollback-Semantik, sodass der Zustand unverändert bleibt [SWS_CRYPT_30405].
• ara::crypto::CryptoErrc::kBusyResource: Wird zurückgegeben, falls die Löschoperation temporär nicht durchgeführt werden kann [SWS_CRYPT_30405]. Dies dürfte typischerweise durch konkurrierende Zugriffe auf hardwaregebundene Speicherressourcen hervorgerufen werden. Frage (offen) Auch hier stellt eine Rollback-Semantik sicher, dass keine partiellen Änderungen verbleiben [SWS_CRYPT_30405].