Merge pull request #2998 from lateralusX/jlorenss/win-x64-full-aot-support
[mono.git] / mcs / class / Mono.Security.Win32 / README
1 NOTE: This assembly ONLY works under the Windows operating system.
2
3 All classes inside this assembly should NEVER be used directly by any 
4 application. This also means you should never link this assembly with
5 others assemblies.
6
7 In order to use theses cryptographic implementations you must change your
8 machine.config file to redirect default implementation to the one provided
9 in this assembly.
10
11 Example:        This example will replace the default RandomNumberGenerator
12                 implementation (the one used for generating keys and IV) by 
13                 one using CryptoAPI. Note that there may be multiple entries
14                 to modify for a default implementation (like 3 for RNG).
15
16 </configuration>
17
18         ... other config stuff ...
19
20         <mscorlib>
21                 <cryptographySettings>
22                         <cryptoNameMapping>
23                                 <cryptoClasses>
24                                         <cryptoClass CapiRNG="Mono.Security.Cryptography.RNGCryptoServiceProvider, Mono.Security.Win32, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756"/>
25                                 </cryptoClasses>
26                                 <nameEntry name="RandomNumberGenerator" class="CapiRNG" />
27                                 <nameEntry name="System.Security.Cryptography.RandomNumberGenerator" class="CapiRNG" />
28                                 <nameEntry name="System.Security.Cryptography.RNGCryptoServiceProvider" class="CapiRNG"/>
29                         </cryptoNameMapping>
30                 </cryptographySettings>
31         </mscorlib>
32 </configuration>
33
34
35 Note:   the whole <mscorlib> section can be missing from your machine.config
36         file.
37
38
39 Sebastien Pouliot
40 sebastien@ximian.com