Cipher Klasse

Definition

Namespace:: Javax.Crypto

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit.

[Android.Runtime.Register("javax/crypto/Cipher", DoNotGenerateAcw=true)]
public class Cipher : Java.Lang.Object

[<Android.Runtime.Register("javax/crypto/Cipher", DoNotGenerateAcw=true)>]
type Cipher = class
    inherit Object

Vererbung: Object

JavaObject

Object
Cipher

Abgeleitet: Javax.Crypto.NullCipher

Attribute: RegisterAttribute

Hinweise

Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. Es bildet den Kern des Java Cryptographic Extension (JCE)-Frameworks.

Um ein Cipher-Objekt zu erstellen, ruft die Anwendung die Cipher-Methode getInstance auf und übergibt den Namen der angeforderten Transformation an sie. Optional kann der Name eines Anbieters angegeben werden.

Eine Transformation ist eine Zeichenfolge, die den Vorgang (oder die Gruppe von Vorgängen) beschreibt, die für die angegebene Eingabe ausgeführt werden sollen, um eine Ausgabe zu erzeugen. Eine Transformation enthält immer den Namen eines kryptografischen Algorithmus (z. B. DES) und kann von einem Feedbackmodus- und Abstandsschema gefolgt werden.

Eine Transformation ist der Form:

<ul><li>"algorithm/mode/padding" oder

<li>"algorithm" </ul>

(In letzterem Fall werden anbieterspezifische Standardwerte für das Modus- und Abstandsschema verwendet). Beispielsweise ist folgendes eine gültige Transformation:

{@code
                Cipher c = Cipher.getInstance("DES/CBC/PKCS5Padding");
            }

Mithilfe von Modi wie CFB und OFB, Blockchiffre können Daten in Einheiten verschlüsselt werden, die kleiner als die tatsächliche Blockgröße der Chiffre sind. Wenn Sie einen solchen Modus anfordern, können Sie optional die Anzahl der Bits angeben, die gleichzeitig verarbeitet werden sollen, indem Sie diese Nummer an den Modusnamen anfügen, wie in den Transformationen "DES/CFB8/NoPadding" und "DES/OFB32/PKCS5Padding" dargestellt. Wenn keine solche Nummer angegeben wird, wird ein anbieterspezifischer Standardwert verwendet. (Der SunJCE-Anbieter verwendet z. B. eine Standardeinstellung von 64 Bit für DES.) So können Blockchiffre mithilfe eines 8-Bit-Modus wie CFB8 oder OFB8 in Byte-orientierte Datenstromchiffre umgewandelt werden.

Modi wie authentifizierte Verschlüsselung mit zugeordneten Daten (AEAD) bieten Authentizitätsüberprüfungen sowohl für vertrauliche Daten als auch für zusätzliche zugeordnete Daten (Additional Associated Data, AAD), die nicht verschlüsselt sind. (Weitere Informationen zu AEAD- und AEAD-Algorithmen wie GCM/CCM finden Sie unter RFC 5116 .) Sowohl vertrauliche als auch AAD-Daten können beim Berechnen des Authentifizierungstags verwendet werden (ähnlich einem Mac). Dieses Tag wird während der Verschlüsselung an den Chiffretext angefügt und bei der Entschlüsselung überprüft.

AEAD-Modi, z. B. GCM/CCM, führen alle AAD-Echtheitsberechnungen aus, bevor Sie die Verschlüsselungsauthentitätsberechnungen starten. Um zu vermeiden, dass Implementierungen intern die Verschlüsselung zwischenspeichern müssen, müssen alle AAD-Daten GCM/CCM-Implementierungen (über die updateAAD Methoden) vor der Chiffretext verarbeitet werden (über die update Und doFinal Methoden).

Beachten Sie, dass der GCM-Modus eine Eindeutigkeitsanforderung für IVs hat, die in der Verschlüsselung mit einem bestimmten Schlüssel verwendet werden. Wenn IVs für die GCM-Verschlüsselung wiederholt werden, unterliegen solche Verwendungen Fälschungsangriffen. Daher sollten Aufrufer nach jedem Verschlüsselungsvorgang, der den GCM-Modus verwendet, die Chiffreobjekte mit GCM-Parametern neu initialisieren, die einen anderen IV-Wert aufweisen.

GCMParameterSpec s = ...;
                cipher.init(..., s);

                // If the GCM parameters were generated by the provider, it can
                // be retrieved by:
                // cipher.getParameters().getParameterSpec(GCMParameterSpec.class);

                cipher.updateAAD(...);  // AAD
                cipher.update(...);     // Multi-part update
                cipher.doFinal(...);    // conclusion of operation

                // Use a different IV value for every encryption
                byte[] newIv = ...;
                s = new GCMParameterSpec(s.getTLen(), newIv);
                cipher.init(..., s);
                ...

Android bietet die folgenden Cipher Transformationen: <Table><thead><tr><th>Algorithm</th th><>Modi</th><>Paddings</th><th>Unterstützte API Levels</th><th>Notes</th></tr></thead><tbody><tr><td rowspan="3">AES</span/td td span></td span><>< style="white-space: nowrap">CBC CFB<style="white-space: nowrap">CTR CTS<style="white-space: nowrap">ECB OFB</td td><>ISO10126Padding<style="white-space: nowrap">NoPadding PKCS5Padding</td><td>1+</td td td><></td></tr><td><>GCM</td td><>NoPadding/< span/td td> style="white-space: nowrap"<10+>/td td<></td>/td<><><><> span style="white-space: nowrap"<GCM-SIV>/td td<><td>span style="white-space: nowrap"<NoPadding>/td td<><>span style="white-space: nowrap"<30+>/td<><td/td><><></tr><tr><td rowspan="3">AES_128</span/td td><>< style="white-space: nowrap">CBC ECB</td td><>NoPadding PKCS5Padding</td><><td span style="white-space: nowrap">26+</td td><></td/tr><td><><>GCM</td><td>NoPadding</td td><>26+</td td><><></tr tr><><td>GCM-SIV</td><td>NoPadding</td><td>30+</span/td><>td td</td td><><><> rowspan="3"<AES_256>/span<></td><td>< tdspan style="white-space: nowrap">CBC ECB</td><td>NoPadding PKCS5Padding</td><td>26+</td><td></><tr tr tr><><><td span style="white-space: nowrap">GCM</td td><>NoPadding</td><td>26+</td><td/td><></tr><tr><td>GCM-SIV</td><td>NoPadding</td><td>30+</td td></td></tr><td><>< rowspan="2">ARC4</td td><>ECB</td td><>NoPadding/< span/td td> style="white-space: nowrap"<10+>/td td<></td>/td<><><><> span style="white-space: nowrap"<NONE>/td<><td>span style="white-space: nowrap"<NoPadding>/td<><td>span style="white-space: nowrap"<28+>/td td<><td>/td<><></tr><tr><td>BLOWFISH</td><td>CBC CFB CTR CTS ECB<style="white-space: nowrap">OFB</td td><>ISO10126Padding NoPadding PKCS5Padding</td td><>10+</td td><td></td></tr>tr td<><ChaCha20>/span</td><>td<NONE>/span <Poly1305>/span</td><>td span style="white-space: nowrap"<NoPadding>/td td<><>span style="white-space: nowrap"<28+>/td<><><td>ChaCha mit 20 Runden, 96-Bit-Nonce und 32-Bit-Zähler, wie in RFC 7539 beschrieben.</td></tr td><><>DES</td td><>CBC CFB CTR CTS ECB<style="white-space: nowrap">OFB</td td><>ISO10126Padding NoPadding PKCS5Padding</td td><>1+</td td><></td></tr><tr><td>DESede</td><td>CBC CFB CTR CTS ECB OFB</td td><>ISO10126Padding NoPadding PKCS5Padding</td><td>1+</td><td/td><></tr><tr><td rowspan="3">RSA</td td><rowspan="3">ECB NONE</td><>NoPadding<style="white-space: nowrap">OAEPPadding /td<><td>span style="white-space: nowrap"<1+>/td td<></td><></tr><td><>span style="white-space: nowrap".< OAEPwithSHA-1andMGF1Padding/span> span style="white-space: nowrap"<OAEPwithSHA-256andMGF1Padding><>/td td<><>span style="<>< Leerraum: nowrap"10+/span>/td<><td/td>/td<></tr><td><>span style="white-space: nowrap"<OAEPwithSHA-224andMGF1Padding>br<OAEPwithSHA-384andMGF1Padding>span<style="white-space: nowrap"><OAEPwithSHA-512andMGF1Padding>/td<><td>span style="<>< Leerraum: nowrap"23+/span>/td td<></td/td><></tr></tbody></table><>

Diese Transformationen werden im Abschnitt "Chiffre" der Java Kryptografiearchitektur Standard Algorithm Name Documentation beschrieben.

In 1.4 hinzugefügt.

Java Dokumentation für javax.crypto.Cipher.

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.

Konstruktoren

Name	Beschreibung
Cipher(CipherSpi, Provider, String)	Erstellt ein Cipher -Objekt.
Cipher(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.

Felder

Name	Beschreibung
DecryptMode	Veraltet. Konstante, die zum Initialisieren der Verschlüsselung verwendet wird, um den Entschlüsselungsmodus zu initialisieren.
EncryptMode	Veraltet. Konstante, die zum Initialisieren der Verschlüsselungsmodus verwendet wird.
PrivateKey	Veraltet. Konstante, die verwendet wird, um anzugeben, dass to-be-unwrapped key ein "privater Schlüssel" ist.
PublicKey	Veraltet. Konstante, die verwendet wird, um anzugeben, dass der to-be-unwrapped key ein "öffentlicher Schlüssel" ist.
SecretKey	Veraltet. Konstante, die verwendet wird, um anzugeben, dass die to-be-unwrapped key ein "geheimer Schlüssel" ist.
UnwrapMode	Veraltet. Konstante, die zum Initialisieren der Verschlüsselung zum Entschlüsselungsmodus verwendet wird.
WrapMode	Veraltet. Konstante, die zum Initialisieren der Verschlüsselung zum Schlüsselumbruchmodus verwendet wird.

Eigenschaften

Name	Beschreibung
Algorithm	Gibt den Algorithmusnamen dieses `Cipher` Objekts zurück.
BlockSize	Gibt die Blockgröße (in Bytes) zurück.
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
ExemptionMechanism	Gibt das Ausnahmemechanismusobjekt zurück, das mit dieser Chiffre verwendet wird.
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniManagedPeerState	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
JniPeerMembers	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit.
Parameters	Gibt die parameter zurück, die mit dieser Chiffre verwendet werden.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
Provider	Gibt den Anbieter dieses `Cipher` Objekts zurück.
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Name	Beschreibung
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
Dispose()	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dispose(Boolean)	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
DisposeUnlessReferenced()	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
DoFinal()	Beendet einen mehrteiligen Verschlüsselungs- oder Entschlüsselungsvorgang, je nachdem, wie diese Verschlüsselung initialisiert wurde.
DoFinal(Byte[], Int32, Int32, Byte[], Int32)	Verschlüsselt oder entschlüsselt Daten in einem einzelteiligen Vorgang oder beendet einen mehrteiligen Vorgang.
DoFinal(Byte[], Int32, Int32, Byte[])	Verschlüsselt oder entschlüsselt Daten in einem einzelteiligen Vorgang oder beendet einen mehrteiligen Vorgang.
DoFinal(Byte[], Int32, Int32)	Verschlüsselt oder entschlüsselt Daten in einem einzelteiligen Vorgang oder beendet einen mehrteiligen Vorgang.
DoFinal(Byte[], Int32)	Beendet einen mehrteiligen Verschlüsselungs- oder Entschlüsselungsvorgang, je nachdem, wie diese Verschlüsselung initialisiert wurde.
DoFinal(Byte[])	Verschlüsselt oder entschlüsselt Daten in einem einzelteiligen Vorgang oder beendet einen mehrteiligen Vorgang.
DoFinal(ByteBuffer, ByteBuffer)	Verschlüsselt oder entschlüsselt Daten in einem einzelteiligen Vorgang oder beendet einen mehrteiligen Vorgang.
Equals(Object)	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetInstance(String, Provider)	Gibt ein `Cipher` Objekt zurück, das die angegebene Transformation implementiert.
GetInstance(String, String)	Gibt ein `Cipher` Objekt zurück, das die angegebene Transformation implementiert.
GetInstance(String)	Gibt ein `Cipher` Objekt zurück, das die angegebene Transformation implementiert.
GetIV()	Gibt den Initialisierungsvektor (IV) in einem neuen Puffer zurück.
GetMaxAllowedKeyLength(String)	Gibt die maximale Schlüssellänge für die angegebene Transformation gemäß den installierten JCE-Zuständigkeitsrichtliniendateien zurück.
GetMaxAllowedParameterSpec(String)	Gibt ein AlgorithmParameterSpec -Objekt zurück, das den maximalen Chiffreparameterwert gemäß der Richtliniendatei für die Zuständigkeit enthält.
GetOutputSize(Int32)	Gibt die Länge in Byte zurück, die ein Ausgabepuffer benötigt, um das Ergebnis des nächsten `update` Oder `doFinal` Vorgangs unter Berücksichtigung der Eingabelänge `inputLen` (in Byte) zu halten.
Init(CipherMode, Certificate, SecureRandom)	Initialisiert diese Chiffre mit dem öffentlichen Schlüssel aus dem angegebenen Zertifikat und einer Quelle der Zufälligkeit.
Init(CipherMode, Certificate)	Initialisiert diese Chiffre mit dem öffentlichen Schlüssel aus dem angegebenen Zertifikat.
Init(CipherMode, IKey, AlgorithmParameters, SecureRandom)	Initialisiert diese Chiffre mit einem Schlüssel, einer Reihe von Algorithmusparametern und einer Quelle der Zufälligkeit.
Init(CipherMode, IKey, AlgorithmParameters)	Initialisiert diese Chiffre mit einem Schlüssel und einer Reihe von Algorithmusparametern.
Init(CipherMode, IKey, IAlgorithmParameterSpec, SecureRandom)	Initialisiert diese Chiffre mit einem Schlüssel, einer Reihe von Algorithmusparametern und einer Quelle der Zufälligkeit.
Init(CipherMode, IKey, IAlgorithmParameterSpec)	Initialisiert diese Chiffre mit einem Schlüssel und einer Reihe von Algorithmusparametern.
Init(CipherMode, IKey, SecureRandom)	Initialisiert diese Chiffre mit einem Schlüssel und einer Quelle der Zufälligkeit.
Init(CipherMode, IKey)	Initialisiert diese Chiffre mit einem Schlüssel.
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
ToArray<T>()	Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object)
Unwrap(Byte[], String, KeyType)	Entpacken Sie einen zuvor umschlossenen Schlüssel.
Update(Byte[], Int32, Int32, Byte[], Int32)	Setzt einen mehrteiligen Verschlüsselungs- oder Entschlüsselungsvorgang fort (je nachdem, wie diese Verschlüsselung initialisiert wurde), die Verarbeitung eines anderen Datenteils.
Update(Byte[], Int32, Int32, Byte[])	Setzt einen mehrteiligen Verschlüsselungs- oder Entschlüsselungsvorgang fort (je nachdem, wie diese Verschlüsselung initialisiert wurde), die Verarbeitung eines anderen Datenteils.
Update(Byte[], Int32, Int32)	Setzt einen mehrteiligen Verschlüsselungs- oder Entschlüsselungsvorgang fort (je nachdem, wie diese Verschlüsselung initialisiert wurde), die Verarbeitung eines anderen Datenteils.
Update(Byte[])	Setzt einen mehrteiligen Verschlüsselungs- oder Entschlüsselungsvorgang fort (je nachdem, wie diese Verschlüsselung initialisiert wurde), die Verarbeitung eines anderen Datenteils.
Update(ByteBuffer, ByteBuffer)	Setzt einen mehrteiligen Verschlüsselungs- oder Entschlüsselungsvorgang fort (je nachdem, wie diese Verschlüsselung initialisiert wurde), die Verarbeitung eines anderen Datenteils.
UpdateAAD(Byte[], Int32, Int32)	Setzt eine mehrteilige Aktualisierung der zusätzlichen Authentifizierungsdaten (Additional Authentication Data, AAD) mithilfe einer Teilmenge des bereitgestellten Puffers fort.
UpdateAAD(Byte[])	Setzt ein mehrteiliges Update der zusätzlichen Authentifizierungsdaten (Additional Authentication Data, AAD) fort.
UpdateAAD(ByteBuffer)	Setzt ein mehrteiliges Update der zusätzlichen Authentifizierungsdaten (Additional Authentication Data, AAD) fort.
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wrap(IKey)	Umschließen einer Taste.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit. (Geerbt von JavaObject)

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Diese Klasse stellt die Funktionalität einer kryptografischen Verschlüsselung zur Verschlüsselung und Entschlüsselung bereit.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: