[docs] Import of Microsoft BCL Documentation.
[mono.git] / mcs / class / corlib / System.Security.Cryptography / TripleDESCryptoServiceProvider.cs
1 //
2 // TripleDESCryptoServiceProvider.cs: Default TripleDES implementation
3 //
4 // Author:
5 //      Sebastien Pouliot <sebastien@ximian.com>
6 //
7 // (C) 2002 Motus Technologies Inc. (http://www.motus.com)
8 // Copyright (C) 2004-2005 Novell, Inc (http://www.novell.com)
9 //
10 // Permission is hereby granted, free of charge, to any person obtaining
11 // a copy of this software and associated documentation files (the
12 // "Software"), to deal in the Software without restriction, including
13 // without limitation the rights to use, copy, modify, merge, publish,
14 // distribute, sublicense, and/or sell copies of the Software, and to
15 // permit persons to whom the Software is furnished to do so, subject to
16 // the following conditions:
17 // 
18 // The above copyright notice and this permission notice shall be
19 // included in all copies or substantial portions of the Software.
20 // 
21 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
22 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
23 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
24 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
25 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
26 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
27 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
28 //
29
30 using System.Runtime.InteropServices;
31 using Mono.Security.Cryptography;
32
33 namespace System.Security.Cryptography {
34
35         // References:
36         // a.   FIPS PUB 46-3: TripleDES
37         //      http://csrc.nist.gov/publications/fips/fips46-3/fips46-3.pdf
38         // b.   ANSI X9.52
39         //      not free :-(
40         //      http://webstore.ansi.org/ansidocstore/product.asp?sku=ANSI+X9%2E52%2D1998
41         
42         [ComVisible (true)]
43         public sealed class TripleDESCryptoServiceProvider : TripleDES {
44         
45                 public TripleDESCryptoServiceProvider ()
46                 {
47                 }
48         
49                 public override void GenerateIV () 
50                 {
51                         IVValue = KeyBuilder.IV (BlockSizeValue >> 3);
52                 }
53                 
54                 public override void GenerateKey () 
55                 {
56                         KeyValue = TripleDESTransform.GetStrongKey ();
57                 }
58                 
59                 public override ICryptoTransform CreateDecryptor (byte[] rgbKey, byte[] rgbIV) 
60                 {
61                         return new TripleDESTransform (this, false, rgbKey, rgbIV);
62                 }
63                 
64                 public override ICryptoTransform CreateEncryptor (byte[] rgbKey, byte[] rgbIV) 
65                 {
66                         return new TripleDESTransform (this, true, rgbKey, rgbIV);
67                 }
68         }
69         
70         // TripleDES is just DES-EDE
71         internal class TripleDESTransform : SymmetricTransform {
72         
73                 // for encryption
74                 private DESTransform E1;
75                 private DESTransform D2;
76                 private DESTransform E3;
77         
78                 // for decryption
79                 private DESTransform D1;
80                 private DESTransform E2;
81                 private DESTransform D3;
82                 
83                 public TripleDESTransform (TripleDES algo, bool encryption, byte[] key, byte[] iv) : base (algo, encryption, iv) 
84                 {
85                         if (key == null) {
86                                 key = GetStrongKey ();
87                         }
88                         // note: checking weak keys also checks valid key length
89                         if (TripleDES.IsWeakKey (key)) {
90                                 string msg = Locale.GetText ("This is a known weak key.");
91                                 throw new CryptographicException (msg);
92                         }
93
94                         byte[] key1 = new byte [8];
95                         byte[] key2 = new byte [8];
96                         byte[] key3 = new byte [8];
97                         DES des = DES.Create ();
98                         Buffer.BlockCopy (key, 0, key1, 0, 8);
99                         Buffer.BlockCopy (key, 8, key2, 0, 8);
100                         if (key.Length == 16)
101                                 Buffer.BlockCopy (key, 0, key3, 0, 8);
102                         else
103                                 Buffer.BlockCopy (key, 16, key3, 0, 8);
104         
105                         // note: some modes (like CFB) requires encryption when decrypting
106                         if ((encryption) || (algo.Mode == CipherMode.CFB)) {
107                                 E1 = new DESTransform (des, true, key1, iv);
108                                 D2 = new DESTransform (des, false, key2, iv);
109                                 E3 = new DESTransform (des, true, key3, iv);
110                         }
111                         else {
112                                 D1 = new DESTransform (des, false, key3, iv);
113                                 E2 = new DESTransform (des, true, key2, iv);
114                                 D3 = new DESTransform (des, false, key1, iv);
115                         }
116                 }
117         
118                 // note: this method is garanteed to be called with a valid blocksize
119                 // for both input and output
120                 protected override void ECB (byte[] input, byte[] output) 
121                 {
122                         DESTransform.Permutation (input, output, DESTransform.ipTab, false);
123                         if (encrypt) {
124                                 E1.ProcessBlock (output, output);
125                                 D2.ProcessBlock (output, output);
126                                 E3.ProcessBlock (output, output);
127                         }
128                         else {
129                                 D1.ProcessBlock (output, output);
130                                 E2.ProcessBlock (output, output);
131                                 D3.ProcessBlock (output, output);
132                         }
133                         DESTransform.Permutation (output, output, DESTransform.fpTab, true);
134                 }
135
136                 static internal byte[] GetStrongKey ()
137                 {
138                         int size = DESTransform.BLOCK_BYTE_SIZE * 3;
139                         byte[] key = KeyBuilder.Key (size);
140                         while (TripleDES.IsWeakKey (key))
141                                 key = KeyBuilder.Key (size);
142                         return key;
143                 }
144         }
145 }
146