AWS CloudHSM KeyStore Java-Klasse für Client SDK 5 - AWS CloudHSM
Wählen Sie den SchlüsselspeicherInitialisieren Sie den AWS CloudHSM KeyStoreVerwenden Sie unseren AWS CloudHSM KeyStore Client 5 AWS CloudHSM SDK

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS CloudHSM KeyStore Java-Klasse für Client SDK 5

Die AWS CloudHSM KeyStore Klasse stellt einen PKCS12 Schlüsselspeicher für spezielle Zwecke bereit. Dieser Schlüsselspeicher kann Zertifikate zusammen mit Ihren Schlüsseldaten speichern und sie mit den in AWS CloudHSM gespeicherten Schlüsseldaten korrelieren. Die AWS CloudHSM KeyStore Klasse implementiert das KeyStore Service Provider Interface (SPI) der Java Cryptography Extension (). JCE Weitere Informationen zur Verwendung finden Sie KeyStore unter Class KeyStore.

Anmerkung

Da es sich bei Zertifikaten um öffentliche Informationen handelt und um die Speicherkapazität für kryptografische Schlüssel zu maximieren, AWS CloudHSM wird das Speichern von Zertifikaten auf HSMs nicht unterstützt.

Wählen Sie den entsprechenden Schlüsselspeicher für AWS CloudHSM Client 5 SDK

Der Anbieter AWS CloudHSM Java Cryptographic Extension (JCE) bietet eine Cloud für spezielle Zwecke. AWS HSM KeyStore Die AWS CloudHSM KeyStore Klasse unterstützt das Auslagern von Schlüsseloperationen in den lokalen Speicher von Zertifikaten HSM und zertifikatsbasierte Operationen.

Laden Sie die Spezial-Cloud wie folgt: HSM KeyStore 

KeyStore ks = KeyStore.getInstance("CloudHSM")

Initialisieren Sie den Client 5 AWS CloudHSM KeyStore SDK

Melden Sie sich genauso AWS CloudHSM KeyStore an, wie Sie sich beim JCE Anbieter anmelden. Sie können entweder Umgebungsvariablen oder die Systemeigenschaftendatei verwenden. Sie sollten sich anmelden, bevor Sie die Cloud nutzen HSM KeyStore. Ein Beispiel für die Anmeldung bei und HSM über den JCE Anbieter finden Sie unter Anmelden bei einem HSM.

Falls gewünscht, können Sie ein Passwort angeben, um die lokale PKCS12 Datei zu verschlüsseln, die Schlüsselspeicherdaten enthält. Wenn Sie den AWS CloudHSM Keystore erstellen, legen Sie das Passwort fest und geben es an, wenn Sie die Methoden load, set und get verwenden.

Instanziieren Sie ein neues HSM KeyStore Cloud-Objekt wie folgt:

ks.load(null, null);

Schreiben Sie Schlüsselspeicherdaten mit der store-Methode in eine Datei. Von da an können Sie den vorhandenen Schlüsselspeicher mit der load-Methode mit der Quelldatei und dem Passwort wie folgt laden: 

ks.load(inputStream, password);

Verwenden Sie unseren AWS CloudHSM KeyStore Client 5 AWS CloudHSM SDK

AWS CloudHSM KeyStore entspricht der JCE KeyStoreKlassenspezifikation und bietet die folgenden Funktionen.

  • load

    Lädt den Schlüsselspeicher aus dem angegebenen Eingabe-Stream. Wenn beim Speichern des Schlüsselspeichers ein Passwort festgelegt wurde, muss dasselbe Passwort angegeben werden, damit das Laden erfolgreich ist. Setzen Sie beide Parameter auf null, um einen neuen leeren Schlüsselspeicher zu initialisieren.

    KeyStore ks = KeyStore.getInstance("CloudHSM");
ks.load(inputStream, password);

  • aliases

    Gibt eine Aufzählung der Aliasnamen aller Einträge in der angegebenen Schlüsselspeicherinstanz zurück. Zu den Ergebnissen gehören Objekte, die lokal in der PKCS12 Datei gespeichert sind, und Objekte, die sich in der Datei befindenHSM.

    Beispiel-Code:

    KeyStore ks = KeyStore.getInstance("CloudHSM");
for(Enumeration<String> entry = ks.aliases(); entry.hasMoreElements();) {    
    String label = entry.nextElement();    
    System.out.println(label);
}

  • containsalias

    Gibt „true“ zurück, wenn der Schlüsselspeicher Zugriff auf mindestens ein Objekt mit dem angegebenen Alias hat. Der Schlüsselspeicher überprüft Objekte, die lokal in der PKCS12 Datei gespeichert sind, und Objekte, die sich auf der befindenHSM.

  • deleteEntry

    Löscht einen Zertifikatseintrag aus der lokalen PKCS12 Datei. Das Löschen von Schlüsseldaten, die in einem gespeichert sind, HSM wird mit dem AWS CloudHSM KeyStore nicht unterstützt. Sie können Schlüssel mit der destroy-Methode der Destroyable-Schnittstelle löschen.

    ((Destroyable) key).destroy();

  • getCertificate

    Gibt das Zertifikat zurück, das einem Alias zugeordnet ist, falls verfügbar. Wenn der Alias nicht existiert oder auf ein Objekt verweist, das kein Zertifikat ist, kehrt die Funktion zurückNULL. 

    KeyStore ks = KeyStore.getInstance("CloudHSM");
Certificate cert = ks.getCertificate(alias);

  • getCertificateAlias

    Gibt den Namen (Alias) des ersten Schlüsselspeichereintrags zurück, dessen Daten mit dem angegebenen Zertifikat übereinstimmen. 

    KeyStore ks = KeyStore.getInstance("CloudHSM");
String alias = ks.getCertificateAlias(cert);

  • getCertificateChain

    Gibt die Zertifikatkette zurück, die dem angegebenen Alias zugeordnet ist. Wenn der Alias nicht existiert oder auf ein Objekt verweist, das kein Zertifikat ist, kehrt die Funktion zurückNULL.

  • getCreationDate

    Gibt das Erstellungsdatum des durch den angegebenen Alias identifizierten Eintrags zurück. Wenn kein Erstellungsdatum verfügbar ist, gibt die Funktion das Datum zurück, an dem das Zertifikat gültig wurde.

  • getKey

    GetKey wird an die übergeben HSM und gibt ein Schlüsselobjekt zurück, das dem angegebenen Label entspricht. Da es getKey direkt das abfragtHSM, kann es für jeden Schlüssel auf dem verwendet werden, HSM unabhängig davon, ob er von der generiert wurde KeyStore. 

    Key key = ks.getKey(keyLabel, null);

  • isCertificateEntry

    Überprüft, ob der Eintrag mit dem angegebenen Alias einen Zertifikateintrag darstellt.

  • isKeyEntry

    Überprüft, ob der Eintrag mit dem angegebenen Alias einen Schlüsseleintrag darstellt. Die Aktion durchsucht sowohl die PKCS12 Datei als auch den HSM nach dem Alias.

  • setCertificateEntry

    Weist dem angegebenen Alias das angegebene Zertifikat zu. Wenn der angegebene Alias bereits verwendet wird, um einen Schlüssel oder ein Zertifikat zu identifizieren, wird ein KeyStoreException ausgelöst. Sie können JCE Code verwenden, um das Schlüsselobjekt abzurufen, und dann die KeyStore SetKeyEntry Methode verwenden, um das Zertifikat dem Schlüssel zuzuordnen.

  • setKeyEntry mit byte[]-Schlüssel

    Dies API wird derzeit von Client SDK 5 nicht unterstützt.

  • setKeyEntry mit Key-Objekt

    Weist den angegebenen Schlüssel dem angegebenen Alias zu und speichert ihn in der. HSM Falls der Schlüssel noch nicht in dem existiertHSM, wird er HSM als extrahierbarer Sitzungsschlüssel in den importiert.

    Wenn das Key-Objekt vom Typ PrivateKey ist, muss es von einer entsprechenden Zertifikatkette begleitet werden.

    Wenn der Alias bereits vorhanden ist, wird ein SetKeyEntry- Aufruf ausgelöst, und KeyStoreException verhindert, dass der Schlüssel überschrieben wird. Wenn der Schlüssel überschrieben werden muss, verwenden Sie KMU oder JCE für diesen Zweck.

  • engineSize

    Gibt die Anzahl der Einträge im Schlüsselspeicher zurück.

  • store

    Speichert den Schlüsselspeicher für den angegebenen Ausgabestrom als PKCS12 Datei und sichert ihn mit dem angegebenen Passwort. Darüber hinaus bleiben alle geladenen Schlüssel (die über setKey-Aufrufe gesetzt werden) bestehen.