导航

• 首页

• 随机页
• 创建新页
• 所有页面
• 分类

• 系统管理
• 文件管理

• 登录/注销
• 选择语言
• 个人设置
• 创建账户

• Wiki 帮助

Enterprise Library 3.1中文帮助：加密应用程序块

加密应用程序块介绍

• 减少了处理标准任务时编写重复代码的需要，提供了可以用来解决常规应用程序加密问题的实现。
• 有助于维护一致的加密实践，无论是在应用程序中还是在企业间。
• 使用一致的架构模型跨越提供的不同的功能范围来平滑开发人员的学习曲线。
• 提供了可用于解决常规加密问题的实现。
• 可扩展，支持其他加密提供程序的实现。

• C#

string encryptedContentsBase64 = Cryptographer.EncryptSymmetric("symmProvider", "SensitiveData");
// Decrypt the base64 encoded string
string readableString; 
readableString = Cryptographer.DecryptSymmetric("symmProvider", encryptedContentsBase64);

• Visual Basic

Dim encryptedContentsBase64 As String
encryptedContentsBase64 = Cryptographer.EncryptSymmetric("symmProvider", "SensitiveData")
' Decrypt the base64 encoded string
Dim readableString As String
readableString = Cryptographer.DecryptSymmetric("symmProvider", encryptedContentsBase64)

• Microsoft Visual Studio 2005 开发系统
• Microsoft .NET Framework 2.0

• Microsoft Windows XP Professional, Windows Server 2003, 或 Windows Vista 操作系统
• Microsoft .NET Framework 2.0 或 3.0
• Microsoft Visual Studio 2005 开发系统（任何下列版本）：
  • Microsoft Visual Studio 2005 标准版
  • Microsoft Visual Studio 2005 专业版
  • Microsoft Visual Studio 2005 软件开发人员团队版
  • Microsoft Visual Studio 2005 软件测试人员团队版
  • Microsoft Visual Studio 2005 软件架构师团队版
  • Microsoft Visual Studio 2005 团队套件

• 内核库功能。Enterprise Library 内核提供了如度量和配置这样的服务，并且是所有 Enterprise Library 应用程序块的共享依赖。内核库功能包含在程序集 Microsoft.Practices.EnterpriseLibrary.Common.dll 中。
• ObjectBuilder 子系统，ObjectBuilder 子系统执行所有重复且必要的对象实例的创建和销毁任务，且依然提供了高级的灵活性。Enterprise Library 将 ObjectBuilder 用于如注入配置到程序块的类中和连接度量类到应用程序块这样的任务中。ObjectBuilder 子系统包含在程序集 Microsoft.Practices.ObjectBuilder.dll 。

• 用加密应用程序块开发应用程序。本主题描述了如何下载并安装应用程序块以使你可以在你的应用程序中使用它。它也描述了如何为常规操作配置应用程序块。关键场景子主题展示了如何使用应用程序块来完成最典型的加密任务。
• 加密应用程序块的设计。此主题解释了设计中的决定和这些决定背后相关的东西。
• 扩展和修改加密应用程序块。此主题解释了如何创建自己的提供程序来扩展应用程序块和修改源代码。
• 部署和操作。此主题解释了如何部署和更新应用程序块的程序集，还包含了与配置相关的信息。
• 快速入门。此主题解释了如何安装和配置快速入门应用程序，并包含了一系列的漫游，漫游示范了如何将常规的加密操作加入到应用程序中去。

• Improving Web Application Security: Threats and Countermeasures
• How To: Use Authorization Manager (AzMan) with ASP.NET 2.0
• patterns & practices Security How Tos Index

场景和目标

• 配置加密
• 加密数据
• 解密数据
• 获取数据的哈希
• 检查哈希是否配置某些文本

• 用访问控制列表（ACL）来保护密钥。只授予需要访问密钥文件的个体必要的权限。
• 在计算机运行在低信任环境中时不要配置计算机允许远程调试。例如，允许匿名访问的 Web 服务器。

用加密应用程序块开发应用程序

输入配置信息

1. 打开配置文件。更多信息，请参见配置应用程序块。
2. 右单击应用程序配置，指向 New ，然后单击应用程序块。
3. 配置控制台自动添加加密应用程序块节点，以及 HashProviders 和 SymmetricProviders 子节点，并使用了默认配置。

1. （可选的）在右面板中，设置 DefaultHashProvider 属性。在这设置的是，如果应用程序代码没有指定另一个提供程序的话，加密应用程序块将使用的哈希提供程序实例。在下拉列表框中，单击哈希提供程序。默认为无。
2. （可选的）在右面板中，设置 DefaultSymmetricCryptoProvider 属性。在此设置的是，如果应用程序代码没有指定另一个提供程序的话，加密应用程序块将使用的对称加密提供程序的实例。在下拉列表框中，单击对称提供程序。默认为无。

1. 单击 Hash Providers ，指向 New ，然后单击 CustomHashProvider 。
2. 在右面板中的 Attributes 属性中，单击省略号按钮（...）。
3. 在 EditableKeyValueCollectionEditor 对话框中，单击 Add 来添加一个新的名称/值对。
4. 在 EditableKeyValueCollectionEditor 对话框的右面板中，输入键的名称和属性的值。
5. 按上列方法添加多个名称/值对，然后单击 OK 。
6. （可选的）在配置控制台右面板中的 Name 属性节中，修改定制哈希提供程序的名称，默认的名称是 CustomHash Provider 。
7. 在右面板的 Type 属性节中，单击省略号按钮（...）。如果程序集文件夹中没有想要的类型，在 TypeSelector 中单击 LoadAssembly，以查找包含想要的类型的程序集。

1. 单击 Hash Providers ，指向 New ，然后单击 HashAlgorithmProvider 。
2. 在 TypeSelector 对话框中，选择要使用的哈希算法提供程序。如果哈希提供程序没有包含在内，在 TypeSelector 中单击 LoadAssembly 以查找包含想要的类型的程序集。
3. （可选的）在配置控制台右面板中的 Name 属性节中，修改哈希算法提供程序的名称，默认的名称是在第2步中选择的类型的名称。
4. 设置 SaltEnabled 属性。在下拉列表中，单击 True 或 False 。默认为 False 。

1. 单击 Symmetric Providers ，指向 New ，然后单击 CustomSymmetric CryptographyProvider 。
2. 在右面板中的 Attributes 属性节中，单击省略号按钮（...）。
3. 在 EditableKeyValueCollectionEditor 对话框中，单击 Add 以添加一个新的名称/值对。
4. 在 EditableKeyValueCollectionEditor 对话框的右面板中，输入密钥名称和属性的值。
5. 按以上方法添加更多的名称/值对，然后单击 OK 。
6. (可选的）在配置控制台的右面板中的 Name 属性节中，修改定制对称加密提供程序的名称。默认的名称为 CustomHash Provider 。
7. 在右面板的 Type 属性节中，单击省略号按钮（...）。如果程序集文件夹中没有想要的类型，在 TypeSelector 中单击 LoadAssembly，以查找包含想要的类型的程序集。

1. 单击 Symmetric Providers ，指向 New ，然后单击 DPAPISymmetric CryptographyProvider 。
2. (可选的）在配置控制台的右面板中的 Name 属性节中，修改 DPAPI 对称加密提供程序的名称。默认名称为 DPAPI Symmetric CryptographyProvider 。
3. 设置 ProtectionScope 属性。在下拉列表中，选择 CurrentUser 或 LocalMachine 。

1. 单击 Symmetric Providers ，指向 New ，然后单击 Symmetric AlgorithmProvider 。
2. 在 TypeSelector 中，选择要使用的对称算法提供程序。如果没有包含提供程序，单击 TypeSelector 中的 LoadAssembly 来查找包含想要的类型的程序集。默认类型是 RijndaelMananged 。
3. 使用 CryptographicKeyWizard 可以导入或生成密钥。更多信息，请参见使用 Cryptographic Key Wizard 。

• 创建新的密钥。
• 使用已存在的 DPAPI 保护的密钥文件。
• 导入密码保存的密钥文件。

• 应用程序运行在自己专用的服务器，服务器上没有其他应用程序。
• 多个应用程序运行在同一服务器上，这些应用程序能够共享敏感信息。

1. 选择 Create a new key ，然后单击 Next 。
2. 输入要使用的十六进制密钥或者单击 Generate 生成一个新的密钥。单击 Next 。
3. 选择要保存密钥文件的位置。输入位置或者单击省略按钮（...）并选择位置。单击 Next 。
4. 选择 Usermode 或者 Machinemode。用户模式使用当前登录的用户的证书加密密钥。在机器模式中，任何登录的用户都可以加密和解密密钥。单击 Finish 。
5. Key 属性将出现在配置控制台的右面板中。单击省略号按钮（...）可再次使用 Cryptographic Key Wizard 生成一个不同的密钥。

1. 选择 Use an existing DPAPI-protected key file，然后单击 Next 。
2. 输入密钥文件的位置。文件必须包含与所使用的同样的算法类型相关联的密钥。例如，如果配置了 RijndaelManaged 类型的算法，导入的密钥也就必须与 RijndaelManaged 类型算法相关联。更多信息，请参见使用提示。输入位置或者单击省略号按钮（...）并选择位置。单击 Next 。
3. 选择 Usermode 或 Machinemode 之一。用户模式使用当前登录的用户的证书加密密钥。在机器模式中，任何登录的用户都可以加密和解密密钥。单击 Finish 。
4. Key 属性将出现在配置控制台的右面板中。单击省略号按钮（...）可再次使用 Cryptographic Key Wizard 生成一个不同的密钥。

1. 选择 Import a password-protected key file，然后单击 Next 。
2. 输入密钥文件的位置。输入位置或者单击省略号按钮（...）并选择位置。文件必须包含与当前所使用的同样的算法类型相关联的密钥。例如，如果配置了 RijndaelManaged 类型的算法，导入的密钥也就必须与 RijndaelManaged 类型算法相关联。更多信息，请参见使用提示。输入用于加密文件的密码。单击 Next 。
3. 选择 Usermode 或 Machinemode 之一。用户模式使用当前登录的用户的证书加密密钥。在机器模式中，任何登录的用户都可以加密和解密密钥。单击 Finish 。
4. Key 属性将出现在配置控制台的右面板中。单击省略号按钮（...）可再次使用 Cryptographic Key Wizard 生成一个不同的密钥。

• 在为算法导入密钥时，必须选择为同样算法类型导出的密钥文件。如果选择了一个其他算法类型的密钥，在应用程序运行时将会出现异常。
• 配置控制台在配置源的 节中保存每个密钥文件的绝对路径。例如，在使用默认的配置源时，应用程序配置文件包含了密钥文件的绝对路径。如果在另一台计算机中部署应用程序，必须复制密钥文件到同样的绝对路径，或者更新计算机的配置源中的 节以反映新的位置。

加密应用程序块的源的模式

<section name="securityCryptographyConfiguration" 
   type="Microsoft.Practices.EnterpriseLibrary.Security.Cryptography.Configuration.CryptographySettings, 
   Microsoft.Practices.EnterpriseLibrary.Security.Cryptography, Version=3.1.0.0, Culture=neutral, PublicKeyToken=null" />

添加应用程序代码

1. 添加一个到加密应用程序块程序集的引用。在 Visual Studio 中，右单击解决方案浏览器中的项目节点，然后单击添加引用。单击浏览定位到 Microsoft.Practices.EnterpriseLibrary.Security.Cryptography.dll 程序集。选择程序集，然后单击确定。
2. 根据同样的步骤，设置到 Enterprise Library Common 程序集的引用，Microsoft.Practices.EnterpriseLibrary.Common.dll，以及到 ObjectBuilder 程序集的引用，Microsoft.Practices.EnterpriseLibrary.ObjectBuilder.dll。
3. (可选的) 要不带完整的精确的元素引用使用来自加密应用程序块的元素，可以添加下列的 using 语句(C#)或者 Imports 语句(Visual Basic)到源代码文件的顶部。

using Microsoft.Practices.EnterpriseLibrary.Security.Cryptography;

Imports Microsoft.Practices.EnterpriseLibrary.Security.Cryptography

关键场景

• 加密秘密。此场景示范了怎样使用对称算法提供程序加密秘密。
• 解密秘密。此场景示范了怎样使用对称算法提供程序解密已加密的秘密。
• 获得文本的哈希。此场景示范了怎样从数据中生成哈希值。
• 验证哈希值是否与某些文本匹配。此场景示范了怎样比较纯文本数据和以前从数据中生成的哈希值，以验证从生成初始的哈希以来数据没有被改变过。

用对称提供程序加密数据

string encryptedContentsBase64 = Cryptographer.EncryptSymmetric("symmProvider", "password"); 

Dim encryptedContentsBase64 As String
encryptedContentsBase64 = Cryptographer.EncryptSymmetric("symmProvider", "password")

byte[] valueToEncrypt = Encoding.Unicode.GetBytes("password");
byte[] encryptedContents = Cryptographer.EncryptSymmetric("symmProvider", valueToEncrypt);

// Clear the byte array memory that holds the password.
Array.Clear(valueToEncrypt, 0, valueToEncrypt.Length);

Dim valueToEncrypt = Encoding.Unicode.GetBytes("password")
Dim encryptedContents As Byte() = Cryptographer.EncryptSymmetric("symmProvider", valueToEncrypt)

' Clear the byte array memory that holds the password.
Array.Clear(valueToEncrypt, 0, valueToEncrypt.Length)

• 确定在 Enterprise Library 配置控制台中配置了合适的对称提供程序。
• 敏感数据尽可能快的从内存中清除。留下未加密的数据在内存中会使数据面临安全威胁。要注意的是，内存中的数据也有可能到硬盘上，因为操作系统会将数据写入一个交换文件中。如果计算机崩溃，操作系统会将内存中的内容保存到磁盘中。

用对称加密提供程序解密数据

string encryptedContentsBase64 = Cryptographer.EncryptSymmetric("symmProvider", "password");

// Decrypt the base64 encoded string.
string readableString; 
readableString = Cryptographer.DecryptSymmetric("symmProvider", encryptedContentsBase64);

Dim encryptedContentsBase64 As String
encryptedContentsBase64 = Cryptographer.EncryptSymmetric("symmProvider", "password")

' Decrypt the base64 encoded string.
Dim readableString As String
readableString = Cryptographer.DecryptSymmetric("symmProvider", encryptedContentsBase64)

byte[] valueToEncrypt = Encoding.Unicode.GetBytes("password");
byte[] encryptedContents = Cryptographer.EncryptSymmetric("symmProvider", valueToEncrypt);

// stringToDecrypt contains an encrypted string.
byte[] decryptedContents = Cryptographer.DecryptSymmetric("symmProvider", encryptedContents);
string plainText = (new UnicodeEncoding()).GetString(decryptedContents);

Dim valueToEncrypt = Encoding.Unicode.GetBytes("password")
Dim encryptedContents As Byte() = Cryptographer.EncryptSymmetric("symmProvider", valueToEncrypt)

' stringToDecrypt contains an encrypted string.
Dim decryptedContents As Byte() = Cryptographer.EncryptSymmetric("symmProvider", stringToDecrypt)
Dim plainText As String = (New UnicodeEncoding).GetString(decryptedContents)

获取哈希值

byte[] valueToHash = (new UnicodeEncoding()).GetBytes("password");
byte[] generatedHash = Cryptographer.CreateHash("hashProvider", valueToHash);

// Clear the byte array memory.
Array.Clear(valueToHash, 0, valueToHash.Length);

Dim valueToHash = (New UnicodeEncoding).GetBytes("password")
Dim generatedHash As Byte() = Cryptographer.CreateHash("hashProvider", valueToHash)

' Clear the byte array memory.
Array.Clear(valueToHash, 0, valueToHash.Length)

• CreateHash 方法有二个重载。重载的使用依赖于是从字符串还是从字节数据创建哈希。
• 确认已在 Enterprise Library 配置控制台中指定了哈希提供程序。
• 敏感数据应该尽快从内存中清除。在内存中保留未加密的敏感数据会暴露数据到安全风险中。要注意的是在内存中的数据也可能会放到硬盘上，因为操作系统会将数据写到一个交换文件。还有，如果系统崩溃，操作系统会转储内存中的数据到磁盘中。

校验哈希值是否与某些文本匹配

// generatedHash contains a hash value for a previously hashed string.
byte[] stringToCompare = (new UnicodeEncoding()).GetBytes("TestValue");
bool comparisonSucceeded = Cryptographer.CompareHash("hashProvider", stringToCompare, generatedHash);

' generatedHash contains a hash value for a previously hashed string. 
Dim stringToCompare = (New UnicodeEncoding).GetBytes("TestValue")
Dim comparisonSucceeded As Boolean = Cryptographer.CompareHash( "hashProvider", stringToCompare, generatedHash)

加密应用程序块的设计

• 加密算法
• 哈希算法
• 多种加密提供程序
• 加密提供程序的其他实现
• 使用 DPAPI 的密钥保护

• 为通常需要的功能提供简单且直观的接口。
• 封装用于执行绝大多数常规应用程序加密任务的逻辑。
• 为常规加密任务提出了一个标准一致的模型。
• 确定应用程序块是可扩展的。
• 确定与手工编写加密代码以完成同样的功能相比对性能的影响最小或者很小。
• 提供了一种密钥保护模型，可以定制来满足组织安全需求。

加密应用程序块的设计

用于简单加密功能的设计

• 它仅暴露少量需要开发人员理解的方法。
• 它将使用一致的数据类型接收和返回数据。
• 它将支持常规算法。

• CreateHash
• CompareHash
• EncryptSymmetric
• DecryptSymmetric

public static byte">"> CreateHash(string hashInstance, byte[ plainText)

public static string CreateHash(string hashInstance, string plaintext)

Public Shared Function CreateHash(ByVal hashInstance As String, ByVal plainText As Byte()) As Byte()

Public Shared Function CreateHash(ByVal hashInstance As String, ByVal plainText As String) As String

用于算法抽象的设计

• 用于逻辑名称的 API 的支持
• 对 Enterprise Library 内核的依赖

扩展和修改加密应用程序块

扩展加密应用程序块

1. 创建新的自定义类并添加它到项目中。
2. 确认类实现了要求的接口、构造函数和方法。
3. 在 Enterprise Library 控制台中创建一个通用对象。
4. 指定自定义类的类型名。
5. 个性对象的属性能指定任何自定义的配置属性。

using Microsoft.Practices.EnterpriseLibrary.Common.Configuration;
using Microsoft.Practices.EnterpriseLibrary.Security.Cryptography;
using Microsoft.Practices.EnterpriseLibrary.Security.Cryptography.Configuration;

Imports Microsoft.Practices.EnterpriseLibrary.Common.Configuration
Imports Microsoft.Practices.EnterpriseLibrary.Security.Cryptography
Imports Microsoft.Practices.EnterpriseLibrary.Security.Cryptography.Configuration

[ConfigurationElementType(typeof(CustomHashProviderData))]
public class MyHashProvider : IHashProvider

<ConfigurationElementType(GetType(CustomHashProviderData))> _
Public Class MyHashProvider: Implements IHashProvider

public MyHashProvider(NameValueCollection attributes)
{
}

Public Sub New(ByVal attributes As NameValueCollection)

End Sub

public byte[] CreateHash(byte[] plaintext)
{
}
public bool CompareHash(byte[] plaintext, byte[] hashedtext)
{
}

Public Function CreateHash(ByVal plaintext As Byte()) As Byte() 
End Function 
Public Function CompareHash(ByVal plaintext As Byte(), ByVal hashedtext As Byte()) As Boolean 
End Function

using Microsoft.Practices.EnterpriseLibrary.Common.Configuration;
using Microsoft.Practices.EnterpriseLibrary.Security.Cryptography;
using Microsoft.Practices.EnterpriseLibrary.Security.Cryptography.Configuration;

Imports Microsoft.Practices.EnterpriseLibrary.Common.Configuration
Imports Microsoft.Practices.EnterpriseLibrary.Security.Cryptography
Imports Microsoft.Practices.EnterpriseLibrary.Security.Cryptography.Configuration

[ConfigurationElementType(typeof(CustomSymmetricCryptoProviderData))]
public class MyCustomEncryptionProvider : ISymmetricCryptoProvider

<ConfigurationElementType(GetType(CustomSymmetricCryptoProviderData))> _
Public Class MyCustomEncryptionProvider: Implements ISymmetricCryptoProvider

public MockCustomSymmetricProvider(NameValueCollection attributes)
{
}

Public Sub New(ByVal attributes As NameValueCollection)

End Sub

public byte[] Encrypt(byte[] plaintext)
{
}

public byte[] Decrypt(byte[] ciphertext)
{
} 

Public Function Encrypt(ByVal plaintext As Byte()) As Byte()
End Function 
Public Function Decrypt(ByVal ciphertext As Byte()) As Byte() 
End Function

修改加密应用程序块

• 通过阅读文本中的加密应用程序块设计节理解应用程序块是如何工作的。
• 如果大量修改了代码或者要将应用程序块自定义版本和原始版本一起使用，考虑修改加密应用程序块的命名空间。需要注意的是，改变应用程序块的命名空间要求更新所有其他应用程序块以及使用加密应用程序块的应用程序以适应新的命名空间。
• 使用强名称。强名称允许程序集被唯一标识、版本化和以及完整性验证。这将不得不生成自己的密钥对以签名应用程序块的修改版本。更多信息，请参见强命名程序集和版本手册。另一种选择是，可以选择不签名定制的版本，而是做为弱命名来引用。
• 为了使修改起作用，必须重新编译代码。打开加密应用程序块的 Visual Studio 解决方案文件，然后重建整个解决方案。

• 修改 KeyManager 类。应用程序块运行时使用 KeyManager 类来读取和写入密钥。此类放置在 Security.Cryptography 项目中。
• 修改或替换 Cryptographic Key Wizard 的源代码。此向导是应用程序块设计时组件的一部分。可以在 Security.Cryptography.Configuration.Design 项目中找到用于向导的源代码。
• 修改运行加密密钥向导的设计时源代码。配置控制台在添加加密的哈希算法提供程序或者添加一个对称算法提供程序到应用程序配置中时运行此向导。可以在 AddHashAlgorithmProviderNodeCommand 类和 AddSymmetricAlgorithmProviderNodeCommand 类中找到运行向导的代码。可以在 Security.Cryptography.Configuration.Design 项目中找到这些类的源代码。

• How to: Store Asymmetric Keys in a Key Container
• ICspAsymmetricAlgorithm.ImportCspBlob Method
• ICspAsymmetricAlgorithm.ExportCspBlob Method

部署和操作

• 部署加密应用程序块
• 更新加密应用程序块
• 度量加密应用程序块

部署加密应用程序块

• 部署为在应用程序文件夹层次中的私有程序集。
• 部署为任意文件系统位置或者在全局程序集缓存中做为共享程序集。

• 一个安装程序，如 Microsoft Windows Installer, version 2.0
• 全局程序集缓存工具命令行实用程序( Gacutil.exe )
• .NET Framework 配置工具 ( Mscorcfg.msc )

密钥分发

更新加密应用程序块

度量加密应用程序块

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
      <configSections>
         <section name="instrumentationConfiguration" 
             type="Microsoft.Practices.EnterpriseLibrary.Common.Instrumentation.Configuration.InstrumentationConfigurationSection,
             Microsoft.Practices.EnterpriseLibrary.Common, Version=2.9.9.0, Culture=neutral, PublicKeyToken=null" />
      </configSections>
  <instrumentationConfiguration performanceCountersEnabled="true" eventLoggingEnabled="true" wmiEnabled="true" />
</configuration>

加密应用程序块性能计算器

加密应用程序块事件日志实体

加密应用程序块 WMI 事件

• HashOperationFailedEvent
• HashMisMatchDetectedEvent
• SymmetricOperationFailedEvent
• CryptograhyConfigurationFailureEvent

快速入门

加密快速入门

• 加密秘密
• 解密秘密
• 从文本中获取一个哈希
• 检查哈希是否与某些文本匹配

• Microsoft Windows 2000, Windows XP Professional, 或者 Windows Server 2003 操作系统
• Microsoft .NET Framework, version 2.0 或者 3.0
• Microsoft Visual Studio 2005 开发系统

1. 确认已安装 Enterprise Library 内核
2. 从 Winidows 资源管理器中打开 Enterprise Library 源代码，或者从开始菜单快捷方式中：在任务栏上，单击开始，指向程序，指向 Microsoft patterns and practices，指向 Enterprise Library 3.1 – May 2007 ，然后选择 Enterprise Library 3.1 Source Folder。
3. 打开 QuickStarts 文件夹，然后是 Cryptography ，再然后是 CS(用于C#)或者 VB (用于 Visual Basic .NET)。
4. 双击 CryptographyQuickStart.sln 图标。
5. Visual Studio 打开并显示解决方案文件。在菜单中，单击 生成。
6. 单击 重新生成解决方案。默认情况下，这是一个 debug 构建。
7. 按下 F5 运行快速入门。

• Hash 提供程序：

• 对称提供程序

漫游：加密秘密

const string symmProvider = "symprovider";
string stringToEncrypt;
string encryptedContentsBase64;

Const symmProvider As String = "symprovider"
Dim stringToEncrypt As String
Dim encryptedContentsBase64 As String

stringToEncrypt = "Sample text";

stringToEncrypt = "Sample text"

encryptedContentsBase64 = Cryptographer.EncryptSymmetric(symmProvider, stringToEncrypt);

encryptedContentsBase64 = Cryptographer.EncryptSymmetric(symmProvider, stringToEncrypt)

漫游：解密秘密

const string symmProvider = "symprovider";
string encryptedContentsBase64;

Const symmProvider As String = "symprovider"
Dim encryptedContentsBase64 As String

string decryptedContents = Cryptographer.DecryptSymmetric(symmProvider, encryptedContentsBase64);

Dim decryptedContents As String = Cryptographer.DecryptSymmetric(symmProvider, encryptedContentsBase64)

漫游：从数据中获取哈希

private const string hashProvider = "hashprovider";
private string stringForHash;
private byte[] generatedHash;

Const hashProvider As String = "hashprovider"
Dim stringForHash As String
Dim generatedHash As Byte()

byte[] plainText = Encoding.UTF8.GetBytes("password");  

Dim valueToHash As Byte() = Encoding.UTF8.GetBytes("password")

generatedHash = Cryptographer.CreateHash(hashProvider, valueToHash);

generatedHash = Cryptographer.CreateHash(hashProvider, valueToHash)

漫游：验证哈希值是否匹配某些文本

const string hashProvider = "hashprovider";
byte[] generatedHash;

Const hashProvider As String = "hashprovider"
Dim generatedHash As Byte()

byte[] plainText = Encoding.UTF8.GetBytes("password");  

Dim valueToHash As Byte() = Encoding.UTF8.GetBytes("password")

bool comparisonSucceeded = Cryptographer.CompareHash(hashProvider, valueToHash, generatedHash);

Dim comparisonSucceeded As Boolean = Cryptographer.CompareHash(hashProvider, valueToHash, generatedHash)