DCPcrypt/de: what changed
Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.
Title: DCPcrypt/de
| Old | New | Line | |
|---|---|---|---|
| 1 | + | ### Allgemeines | |
| 2 | + | ||
| 3 | + | - [DCPcrypt](http://www.cityinthesky.co.uk/opensource/dcpcrypt/) ist eine Sammlung cryptographischer Komponenten für Lazarus. | |
| 4 | + | ||
| 5 | + | - Die Idee hinter DCPcrypt ist, daß es möglich sein muß, per "drop in" jegliche Algorithmen und deren Implementierung einfach gegeneinander auszutauschen, nur mit minimalen Codeänderungen. | |
| 6 | + | ||
| 7 | + | Diese Ziel vor Augen sind alle kryptographischen Komponenten von einer, aus einer Reihe von mehreren, Basisklassen abgeleitet, TDCP_cipher für Verschlüsselungsalgorithmen und TDCP_hash für Hash-algorithmen. | |
| 8 | + | ||
| 9 | + | - Seit der v2.0.4-Release, unterstützt DCPcrypt auch 64-Bit-Systeme. | |
| 10 | + | ||
| 11 | + | **Status**: Production/Stable\ | |
| 12 | + | **Letzte Version**: v2.0.4.1 | |
| 13 | + | ||
| 14 | + | ### Screenshot | |
| 15 | + | ||
| 16 | + | - <figure> | |
| 17 | + | <img src="Dcp1.png" title="Dcp1.png" /> | |
| 18 | + | <figcaption>Dcp1.png</figcaption> | |
| 19 | + | </figure> | |
| 20 | + | ||
| 21 | + | - <figure> | |
| 22 | + | <img src="Dcp2.png" title="Dcp2.png" /> | |
| 23 | + | <figcaption>Dcp2.png</figcaption> | |
| 24 | + | </figure> | |
| 25 | + | ||
| 26 | + | ### Autor | |
| 27 | + | ||
| 28 | + | - David Barton [home page](http://www.cityinthesky.co.uk) | |
| 29 | + | ||
| 30 | + | #### Beitragende | |
| 31 | + | ||
| 32 | + | - Portierung nach FPC/Lazarus von [barko](http://wiki.freepascal.org/User:Barko) - 2006 | |
| 33 | + | - [Graeme Geldenhuys](http://geldenhuys.co.uk) - 2009 (aktueller Bearbeiter) | |
| 34 | + | ||
| 35 | + | ### Lizenz (eng.) | |
| 36 | + | ||
| 37 | + | The MIT License | |
| 38 | + | ||
| 39 | + | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: | |
| 40 | + | ||
| 41 | + | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. | |
| 42 | + | ||
| 43 | + | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. | |
| 44 | + | ||
| 45 | + | ### Download | |
| 46 | + | ||
| 47 | + | Die letzte 'stable release' kann auf [Lazarus-CCR Files](http://sourceforge.net/projects/lazarus-ccr/files/DCPcrypt/) heruntergeladen werden. | |
| 48 | + | ||
| 49 | + | ### Abhängigkeiten / Systemerfordernisse | |
| 50 | + | ||
| 51 | + | Seit v2.0.4 lässt es sich mit FPC 2.4.1 (und höher) kompilieren und ist unter 32-bit & 64-bit Linux und 32-bit Windows getestet. | |
| 52 | + | ||
| 53 | + | ### Quelltext | |
| 54 | + | ||
| 55 | + | Seit März 2010, wird der DCPCrypt-Quellcode als Teil des [Lazarus-CCR Projekt](http://sourceforge.net/projects/lazarus-ccr/) auf SourceForge.net gehostet. | |
| 56 | + | ||
| 57 | + | DCPCrypt steht in einem [Git](http://git-scm.com)-Repository bereit. Um den letzten Stand des Quelltexts aus dem Archiv zu die folgenden Befehle in der Kommandozeile ausführen. | |
| 58 | + | ||
| 59 | + | ` git clone `[`git://lazarus-ccr.git.sourceforge.net/gitroot/lazarus-ccr/dcpcrypt`](git://lazarus-ccr.git.sourceforge.net/gitroot/lazarus-ccr/dcpcrypt) | |
| 60 | + | ||
| 61 | + | ` git clone http://git.code.sf.net/p/lazarus-ccr/dcpcrypt lazarus-ccr-dcpcrypt` | |
| 62 | + | ||
| 63 | + | Dannach führt man weitere Updates durch mit: | |
| 64 | + | ||
| 65 | + | ` git pull` | |
| 66 | + | ||
| 67 | + | ### Installation | |
| 68 | + | ||
| 69 | + | Seit dem v2.0.4-Release ist DCPCrypt in zwei Pakete aufgeteilt: | |
| 70 | + | ||
| 71 | + | dcpcrypt.lpk | |
| 72 | + | Dies ist ein Nur-Laufzeit-Paket und nur den GUI-unbelasteten Kern-Code. Man kann diese Packet für Konsolen-Programme und andere nicht-LCL Projekte (z.B: für fpGUI oder MSEgui basierende Projekte). | |
| 73 | + | ||
| 74 | + | dcpcrypt_laz.lpk | |
| 75 | + | Dies ist das Design-Packet das die diversen Komponenten in der Lazarus IDE registriert und in der entsprechenden Palette zur Verfügung stellt. | |
| 76 | + | ||
| 77 | + | Um DCPCrypt mit der Lazarus IDE zum ersten zu Mal benutzen: | |
| 78 | + | ||
| 79 | + | - In **Package \> Package-Datei (.lpk) öffnen**, dcpcrypt.lpk öffnen und **Kompilieren** drücken. | |
| 80 | + | - Um die DCPCrypt-Komponenten in der Lazarus-IDE Komponentenleiste zu haben, muß man noch dcpcrypt_laz.lpk öffnen (s.o.), dann **Kompilieren** drücken und dann **Nutzung... \> Installieren** auswählen und ggf. den Dialog bestätigen. Die Lazarus-IDE kompiliert sich nun selbst (mit der gewählten Komponente). | |
| 81 | + | - Warten bis der kompilieren-Vorgang beendet ist (i.d.R: beendet sich die IDE selbst), und danach die Lazarus-IDE neu starten. DCPCrypt steht nun bereit. | |
| 82 | + | ||
| 83 | + | ### Nutzung | |
| 84 | + | ||
| 85 | + | Es ist zu beachten daß ein grundsätzliches Verständniss der Prinzipien hinter der Ver-/Entschlüsselung und Schlüssel-Verwaltung die Voraussetzung für die Benutzung der in diesem Paket implementierten Chiffren ist.\ | |
| 86 | + | Eine gute Einführung zu diesem Thema bietet "Angewandte Kryptographie" \<rev\>Bruce Schneier ,[<ISBN:3-8273-7228-3>](https://de.wikipedia.org/wiki/Angewandte_Kryptographie)\</rev\>, siehe auch die NIST-Puplikation SP800-38A mit Information über die Verkettungsarten von Block-Chiffren. | |
| 87 | + | ||
| 88 | + | - Chiffren - Der Grundbaustein von DCPcrypt ist die TDCP_cipher-Komponente. | |
| 89 | + | - Blockchiffren - Die Basis aller blockchiffren ist die TDCP_blockcipher-Komponente. | |
| 90 | + | - Hashs - Die Grundlage aller hash(Prüfsummen)-Algorithmen ist die TDCP_hash-Komponente. | |
| 91 | + | ||
| 92 | + | Siehe auch die beigefügte Dokumentation. | |
| 93 | + | ||
| 94 | + | #### Verschlüsselung mit Klar(-text)schlüsseln | |
| 95 | + | ||
| 96 | + | Normalerweise wird in DCPcrypt beim verschlüsseln davon ausgegangen, daß der Schlüssel "gehasht" wird wenn er mit *.InitStr* übergeben wird.\ | |
| 97 | + | Man kann allerdings auch einen Klartext-String mit *[.Init](http://is.muni.cz/th/51468/fi_b/priloha/DCPcrypt/Docs/Ciphers.html#Init)* übergeben, z.B. so: | |
| 98 | + | ||
| 99 | + | ``` pascal | |
| 100 | + | var s:string; | |
| 101 | + | begin | |
| 102 | + | s:='1234567890ABCDEF1234567890ABCDEF'; | |
| 103 | + | DCP_3des1.Init(s[1],length(s)*8,nil); | |
| 104 | + | ``` | |
| 105 | + | ||
| 106 | + | Quelle: [Forumsbeitrag](http://lazarus.freepascal.org/index.php/topic,18108.msg101683.html#msg101683). | |
| 107 | + | ||
| 108 | + | ### Bekannte Fehler | |
| 109 | + | ||
| 110 | + | Bei der Benutzung von [[DCPrijndael]] ist darauf zu achten, daß Schlüssellängen ausserhalb des [[AES]]-standart dafür bekannt sind Schlüssel-Schemata zu erzeugen, so daß der Datenaustausch mit anderen Implementationen von Rijndael **nicht** unproblematisch ist. Nur wenige dieser Implementationen bieten überhaupt die Möglichkeit nicht-standartisierte Schlüssel- oder Blocklängen zu verarbeiten. [Brian Gladman](https://web.archive.org/web/20090201173123/http://fp.gladman.plus.com/cryptography_technology/rijndael/) and [Jeffrey Clement](https://web.archive.org/web/20110826031605/http://jclement.ca/software/pyrijndael/) bieten beispielsweise Implementationen (in C und Python) an, von denen bekannt ist, daß sie bei solchen Schlüssellängen mit [[DCPrijndael]] inkompatible Ergebnisse produzieren. Das beigefügte, kommentierte Testprogramm (unten) zeigt das zu erwartende Ergebnis: | |
| 111 | + | ||
| 112 | + | ``` pascal | |
| 113 | + | program ctst; | |
| 114 | + | {$mode objfpc}{$H+} | |
| 115 | + | uses | |
| 116 | + | {$IFDEF UNIX}{$IFDEF UseCThreads} | |
| 117 | + | cthreads, | |
| 118 | + | {$ENDIF}{$ENDIF} | |
| 119 | + | Sysutils, DCPrijndael; | |
| 120 | + | const | |
| 121 | + | InData: array[0..15] of byte = | |
| 122 | + | ($32,$43,$f6,$a8,$88,$5a,$30,$8d,$31,$31,$98,$a2,$e0,$37,$07,$34); | |
| 123 | + | Key1: array[0..19] of byte = | |
| 124 | + | ($2b,$7e,$15,$16,$28,$ae,$d2,$a6,$ab,$f7,$15,$88,$09,$cf,$4f,$3c,$76,$2e,$71,$60); | |
| 125 | + | Key2: array[0..31] of byte = | |
| 126 | + | ($2b,$7e,$15,$16,$28,$ae,$d2,$a6,$ab,$f7,$15,$88,$09,$cf,$4f,$3c,$76,$2e,$71,$60, | |
| 127 | + | $f3,$8b,$4d,$a5,$6a,$78,$4d,$90,$45,$19,$0c,$fe); | |
| 128 | + | OutData1: array[0..15] of byte = | |
| 129 | + | ($23,$1d,$84,$46,$39,$b3,$1b,$41,$22,$11,$cf,$e9,$37,$12,$b8,$80); | |
| 130 | + | OutData2: array[0..15] of byte = | |
| 131 | + | ($1a,$6e,$6c,$2c,$66,$2e,$7d,$a6,$50,$1f,$fb,$62,$bc,$9e,$93,$f3); | |
| 132 | + | var | |
| 133 | + | Cipher: TDCP_rijndael; | |
| 134 | + | Block: array[0..15] of byte; | |
| 135 | + | begin | |
| 136 | + | // lengths: block = 16 bytes, key = 20 bytes | |
| 137 | + | // key = 2b7e151628aed2a6abf7158809cf4f3c762e7160 | |
| 138 | + | // input = 3243f6a8885a308d313198a2e0370734 | |
| 139 | + | // encrypt = 231d844639b31b412211cfe93712b880 | |
| 140 | + | // decrypt = 3243f6a8885a308d313198a2e0370734 | |
| 141 | + | Cipher := TDCP_rijndael.Create(nil); | |
| 142 | + | Cipher.Init(Key1, Sizeof(Key1) * 8, nil); | |
| 143 | + | Cipher.EncryptECB(InData, Block); | |
| 144 | + | writeln('128-bit block & 160-bit key results:'); | |
| 145 | + | writeln(boolean(CompareMem(@Block, @OutData1, 16))); | |
| 146 | + | Cipher.DecryptECB(Block, Block); | |
| 147 | + | writeln(boolean(CompareMem(@Block, @InData, 16))); | |
| 148 | + | Cipher.Free; | |
| 149 | + | // lengths: block = 16 bytes, key = 32 bytes | |
| 150 | + | // key = 2b7e151628aed2a6abf7158809cf4f3c762e7160f38b4da56a784d9045190cfe | |
| 151 | + | // input = 3243f6a8885a308d313198a2e0370734 | |
| 152 | + | // encrypt = 1a6e6c2c662e7da6501ffb62bc9e93f3 | |
| 153 | + | // decrypt = 3243f6a8885a308d313198a2e0370734 | |
| 154 | + | Cipher := TDCP_rijndael.Create(nil); | |
| 155 | + | Cipher.Init(Key2, Sizeof(Key2) * 8, nil); | |
| 156 | + | Cipher.EncryptECB(InData, Block); | |
| 157 | + | writeln('128-bit block & 256-bit key results:'); | |
| 158 | + | writeln(boolean(CompareMem(@Block, @OutData2, 16))); | |
| 159 | + | Cipher.DecryptECB(Block, Block); | |
| 160 | + | writeln(boolean(CompareMem(@Block, @InData, 16))); | |
| 161 | + | Cipher.Free; | |
| 162 | + | end. | |
| 163 | + | ``` | |
| 164 | + | ||
| 165 | + | Die Ausgaben die Freepascal 2.2.0 erzeugt sind: | |
| 166 | + | ||
| 167 | + | ` 128-bit block & 160-bit key results:`\ | |
| 168 | + | ` FALSE`\ | |
| 169 | + | ` TRUE`\ | |
| 170 | + | ` 128-bit block & 256-bit key results:`\ | |
| 171 | + | ` TRUE`\ | |
| 172 | + | ` TRUE` | |
| 173 | + | ||
| 174 | + | Das bedeutet, daß bei der Benutzung von 160-bit Schlüsseln die Chiffre nur mit [[DCPrijndael]] wieder entschlüsselt werden kann, jedoch nicht mit anderen Implementationen. Andererseits funktioniert dies mit 256-bittigen Schlüsseln. Der 160-bit-Fall ist deswegen so wichtig, da SHA-1 eine genau 160-bit-Prüfsumme liefert, was die Benutzung dieser Schlüssellänge zum haschen eines Paßworts vorzüglich einfach macht, und somit auch von einigen (Hardware-)Systemen genutzt wird. | |
| 175 | + | ||
| 176 | + | ### Externe Verweise | |
| 177 | + | ||
| 178 | + | - [HMAC/PBKDF1/PBKDF2](http://keit.co/p/dcpcrypt-hmac-rfc2104/) Implementationen basierend auf DCPcrypt. | |
| 179 | + | ||
| 180 | + | ### Siehe auch... | |
| 181 | + | ||
| 182 | + | - [Bruce Schneier: Angewandte Kryptographie <ISBN:3-8273-7228-3> (Wikipedia-Eintrag)](https://de.wikipedia.org/wiki/Angewandte_Kryptographie) | |
| 183 | + | ||
| 184 | + | --- | |
| 185 | + | *From the Free Pascal wiki, page "DCPcrypt/de", as it stood on 2022-01-13 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |