KeyStore Klasse

Definition

[Android.Runtime.Register("java/security/KeyStore", DoNotGenerateAcw=true)]
public class KeyStore : Java.Lang.Object

[<Android.Runtime.Register("java/security/KeyStore", DoNotGenerateAcw=true)>]
type KeyStore = class
    inherit Object

Vererbung

Object

JavaObject

Object

KeyStore

Attribute

RegisterAttribute

Hinweise

Diese Klasse stellt eine Speichereinrichtung für kryptografische Schlüssel und Zertifikate dar.

Eine KeyStore verwaltet verschiedene Arten von Einträgen. Jeder Eintragstyp implementiert die KeyStore.Entry Schnittstelle. Es werden drei grundlegende KeyStore.Entry Implementierungen bereitgestellt:

<ul><li><b>KeyStore.PrivateKeyEntry</b>

Dieser Eintragstyp enthält eine Kryptografie PrivateKey, die optional in einem geschützten Format gespeichert ist, um unbefugten Zugriff zu verhindern. Sie wird auch von einer Zertifikatkette für den entsprechenden öffentlichen Schlüssel begleitet.

Private Schlüssel und Zertifikatketten werden von einer bestimmten Entität für die Selbstauthentifizierung verwendet. Anwendungen für diese Authentifizierung umfassen Softwareverteilungsorganisationen, die JAR-Dateien als Teil der Veröffentlichung und/oder Lizenzierungssoftware signieren.

<li><b>KeyStore.SecretKeyEntry</b>

Dieser Eintragstyp enthält eine Kryptografie SecretKey, die optional in einem geschützten Format gespeichert ist, um unbefugten Zugriff zu verhindern.

<li><b>KeyStore.TrustedCertificateEntry</b>

Dieser Eintragstyp enthält einen einzelnen öffentlichen Schlüssel Certificate , der zu einer anderen Partei gehört. Es wird als vertrauenswürdiges Zertifikat bezeichnet, da der Schlüsselspeicherbesitzer dem vertrauen, dass der öffentliche Schlüssel im Zertifikat tatsächlich zur Identität gehört, die vom Antragsteller (Besitzer) des Zertifikats identifiziert wird.

Diese Art von Eintrag kann verwendet werden, um andere Parteien zu authentifizieren. </ul>

Jeder Eintrag in einem Keystore wird durch eine "Alias"-Zeichenfolge identifiziert. Bei privaten Schlüsseln und den zugehörigen Zertifikatketten unterscheiden sich diese Zeichenfolgen zwischen den verschiedenen Methoden, in denen sich die Entität authentifizieren kann. Beispielsweise kann sich die Entität mit unterschiedlichen Zertifizierungsstellen authentifizieren oder verschiedene Algorithmen für öffentliche Schlüssel verwenden.

Ob bei Aliasen die Groß-/Kleinschreibung beachtet wird, hängt von der Implementierung ab. Um Probleme zu vermeiden, empfiehlt es sich, aliase in einem KeyStore nicht zu verwenden, die sich nur in einem Fall unterscheiden.

Gibt an, ob Keystores persistent sind und die mechanismen, die vom Keystore verwendet werden, falls er persistent ist, hier nicht angegeben werden. Dies ermöglicht die Verwendung einer Vielzahl von Techniken zum Schutz vertraulicher Schlüssel (z. B. privater oder geheimer Schlüssel). Smartcards oder andere integrierte Kryptografiemodule (SafeKeyper) sind eine Option, und einfachere Mechanismen wie Dateien können auch verwendet werden (in einer Vielzahl von Formaten).

Typische Methoden zum Anfordern eines KeyStore-Objekts sind das Angeben einer vorhandenen Keystoredatei, die sich auf den Standardtyp und die Bereitstellung eines bestimmten Keystoretyps stützt.

<ul><li>So geben Sie eine vorhandene Keystoredatei an:

// get keystore password
               char[] password = getPassword();

               // probe the keystore file and load the keystore entries
               KeyStore ks = KeyStore.getInstance(new File("keyStoreName"), password);

Das System prüft die angegebene Datei, um den Schlüsselspeichertyp zu ermitteln und eine Keystoreimplementierung mit den bereits geladenen Einträgen zurückzugeben. Wenn dieser Ansatz verwendet wird, ist es nicht erforderlich, die Methode des Keystores #load(java.io.InputStream, char[]) load aufzurufen.

<li>To rely on the default type:

KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());

Das System gibt eine Keystoreimplementierung für den Standardtyp zurück.

<li>So stellen Sie einen bestimmten Keystoretyp bereit:

KeyStore ks = KeyStore.getInstance("JKS");

Das System gibt die am häufigsten bevorzugte Implementierung des angegebenen Schlüsselspeichertyps zurück, der in der Umgebung verfügbar ist. </ul>

Bevor auf einen Keystore zugegriffen werden kann, muss er sein #load(java.io.InputStream, char[]) loaded.

KeyStore ks = KeyStore.getInstance(KeyStore.getDefaultType());

               // get user password and file input stream
               char[] password = getPassword();

               try (FileInputStream fis = new FileInputStream("keyStoreName")) {
                   ks.load(fis, password);
               }

Übergeben Sie als load Argument, null um einen leeren Keystore mit der obigen InputStream Methode zu erstellen.

Nachdem der Keystore geladen wurde, ist es möglich, vorhandene Einträge aus dem Keystore zu lesen oder neue Einträge in den Keystore zu schreiben:

KeyStore.ProtectionParameter protParam =
                   new KeyStore.PasswordProtection(password);

               // get my private key
               KeyStore.PrivateKeyEntry pkEntry = (KeyStore.PrivateKeyEntry)
                   ks.getEntry("privateKeyAlias", protParam);
               PrivateKey myPrivateKey = pkEntry.getPrivateKey();

               // save my secret key
               javax.crypto.SecretKey mySecretKey;
               KeyStore.SecretKeyEntry skEntry =
                   new KeyStore.SecretKeyEntry(mySecretKey);
               ks.setEntry("secretKeyAlias", skEntry, protParam);

               // store away the keystore
               try (FileOutputStream fos = new FileOutputStream("newKeyStoreName")) {
                   ks.store(fos, password);
               }

Beachten Sie, dass auch wenn dasselbe Kennwort zum Laden des Keystores verwendet werden kann, um den Privaten Schlüsseleintrag zu schützen, den Schlüsseleintrag zu schützen und den Schlüsselspeicher zu speichern (wie im obigen Beispielcode gezeigt), können auch verschiedene Kennwörter oder andere Schutzparameter verwendet werden.

Android stellt die folgenden KeyStore Typen bereit: <Tabelle><thead><tr><th>Algorithm</th th><>Unterstützte API Levels</th></tr></thead><tbody><tr><td>AndroidCAStore</td td><>14+</td></tr><><td>AndroidKeyStore</td td td><>18+</td></tr tr><class="deprecated" ><>td BCPKCS12</td><td>1-8</td></tr><><td>BKS</td td td><>1+</td></tr><tr><t td>BouncyCastle</td td><>1+</td></tr><><t td>PKCS12</td td><>1+</td></tr tr><class="deprecated"><td>PKCS12-DEF</td><td>1-8</td></tr></tbody></table>

Diese Typen werden im Abschnitt "KeyStore" der Java Dokumentation zum Standardalgorithmus der Kryptografiearchitektur beschrieben.

In 1.2 hinzugefügt.

Java Dokumentation für java.security.KeyStore.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.