StartAESCipher

StartAESCipher()

Syntax

Ergebnis = StartAESCipher(#Cipher, *Schlüssel, Bits, *InitialisierungsVektor, Modus)

Beschreibung

Initialisiert einen neuen AES-Verschlüsselungslauf (englisch "AES cipher stream"), wozu Daten mittels AddCipherBuffer() hinzugefügt werden können.

Parameter

#Cipher Die Nummer, welche diese neue Verschlüsselung identifiziert. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.

*Schlüssel Ein Puffer, welcher den Schlüssel für das Dekodieren enthält. Seine Größe hängt vom Parameter 'Bits' ab: 16 Bytes für 128 Bit-Verschlüsselung, 24 Bytes für 192 Bit und 32 Bytes für 256 Bit.

Bits Die Größe des für die Verschlüsselung verwendeten Schlüssels. Gültige Werte sind 128, 192 und 256.

*InitialisierungsVektor Der InitialisierungsVektor ist ein zufälliger Datenblock, welcher für das Initialisieren der Verschlüsselung verwendet wird, um ein Knacken beim Dekodieren zu verhindern (wird nur bei Verwendung des #PB_Cipher_CBC Modus benötigt). Seine Größe hängt vom Parameter 'Bits' ab: 16 Bytes für 128 Bit-Verschlüsselung, 24 Bytes für 196 Bit und 32 Bytes für 256 Bit.
Mode
Dieser Parameter kann eine Kombination eines der folgenden Werte sein:
  #PB_Cipher_Decode: Der Verschlüsselungslauf wird zum Dekodieren von Daten verwendet.
  #PB_Cipher_Encode: Der Verschlüsselungslauf wird zum Kodieren von Daten verwendet.

mit

  #PB_Cipher_CBC: Standard-Modus der Kodierung (Cipher Block Chaining). Benötigt einen '*InitialisierungsVektor'.
                  Empfohlen als sicherer gegenüber dem ECB-Modus.
  #PB_Cipher_ECB: Alternativer Modus (Electronic CodeBook). Verwendet weder einen Zufallswert noch Verkettung
                  (jeder Block wird unabhängig voneinander kodiert), was ihn sehr schwach im Vergleich zu CBC macht,
                  weshalb er nicht für ernsthafte Verschlüsselung verwendet werden sollte.

Rückgabewert

Wenn #PB_Any als Parameter #Cipher verwendet wurde, dann wird die automatisch generierte #Cipher Nummer zurückgegeben.

Anmerkungen

Neue Puffer für das Kodieren oder Dekodieren können mittels AddCipherBuffer() hinzugefügt werden. Sobald eine Verschlüsselung abgeschlossen wurde, muss FinishCipher() aufgerufen werden.

Für weitere Informationen über AES siehe AESEncoder().

Siehe auch

AddCipherBuffer(), FinishCipher(), AESEncoder(), AESDecoder()

Unterstützte OS

Alle

<- OpenCryptRandom() - Cipher Inhaltsverzeichnis - StartFingerprint() ->

#Cipher	Die Nummer, welche diese neue Verschlüsselung identifiziert. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
*Schlüssel	Ein Puffer, welcher den Schlüssel für das Dekodieren enthält. Seine Größe hängt vom Parameter 'Bits' ab: 16 Bytes für 128 Bit-Verschlüsselung, 24 Bytes für 192 Bit und 32 Bytes für 256 Bit.
Bits	Die Größe des für die Verschlüsselung verwendeten Schlüssels. Gültige Werte sind 128, 192 und 256.
*InitialisierungsVektor	Der InitialisierungsVektor ist ein zufälliger Datenblock, welcher für das Initialisieren der Verschlüsselung verwendet wird, um ein Knacken beim Dekodieren zu verhindern (wird nur bei Verwendung des #PB_Cipher_CBC Modus benötigt). Seine Größe hängt vom Parameter 'Bits' ab: 16 Bytes für 128 Bit-Verschlüsselung, 24 Bytes für 196 Bit und 32 Bytes für 256 Bit.
Mode	Dieser Parameter kann eine Kombination eines der folgenden Werte sein: #PB_Cipher_Decode: Der Verschlüsselungslauf wird zum Dekodieren von Daten verwendet. #PB_Cipher_Encode: Der Verschlüsselungslauf wird zum Kodieren von Daten verwendet. mit #PB_Cipher_CBC: Standard-Modus der Kodierung (Cipher Block Chaining). Benötigt einen '*InitialisierungsVektor'. Empfohlen als sicherer gegenüber dem ECB-Modus. #PB_Cipher_ECB: Alternativer Modus (Electronic CodeBook). Verwendet weder einen Zufallswert noch Verkettung (jeder Block wird unabhängig voneinander kodiert), was ihn sehr schwach im Vergleich zu CBC macht, weshalb er nicht für ernsthafte Verschlüsselung verwendet werden sollte.