DpapiProtectedConfigurationProvider 類別

定義

命名空間:

System.Configuration

組件:

System.Configuration.ConfigurationManager.dll

來源:

DpapiProtectedConfigurationProvider.cs

提供 ProtectedConfigurationProvider 物件，該物件會使用 Windows 數據保護 API （DPAPI） 來加密和解密組態數據。

public ref class DpapiProtectedConfigurationProvider sealed : System::Configuration::ProtectedConfigurationProvider

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public sealed class DpapiProtectedConfigurationProvider : System.Configuration.ProtectedConfigurationProvider

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
type DpapiProtectedConfigurationProvider = class
    inherit ProtectedConfigurationProvider

Public NotInheritable Class DpapiProtectedConfigurationProvider
Inherits ProtectedConfigurationProvider

繼承

Object

ProviderBase

ProtectedConfigurationProvider

DpapiProtectedConfigurationProvider

屬性

SupportedOSPlatformAttribute

範例

下列範例示範如何使用標準 DpapiProtectedConfigurationProvider 來保護或取消保護組態區段。

下列組態摘錄會顯示套用保護前後的組態區段。

警告

Microsoft不建議直接提供您的使用者名稱和密碼，因為這是不安全的模式。 可能的話，請使用更安全的驗證流程，例如 azure 資源的 受控識別，或 SQL Server Windows 驗證。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <connectionStrings>
    <add name="NorthwindConnectionString"
      connectionString="Data Source=webnetue2;Initial Catalog=Northwind;User ID=aspnet_test;Password=test"
      providerName="System.Data.SqlClient" />
  </connectionStrings>
</configuration>

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <connectionStrings>
    <EncryptedData>
      <CipherData>                <CipherValue>AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAAcAMh0jIC1kigyFfd9AUZfQQAAAACAAAAAAADZgAAqAAAABAAAADQwbQ2DgIgIlqskE1RI9UpAAAAAASAAACgAAAAEAAAAAXlYBxi3jhM6wv4sxLhugsQAgAAgoReHZS2406dc/AyRDd6WuNr4ihHn6fbipd4tzHEmeuyS4o4fS4CmT3jMt/WjsP/kR7TF4ygwr2GG47podK79ECpVCZHAgctCauCYjE2Ls3iphKXy/pHic2o6aaClt/xPm+fb4OfODv6XjrJhJzGK2lqUPXkyJN1w2zwh6OVpDQF9N8vTyxL4eitp35/M5zYbW7e6VVAgYUOxlNxgCV5+jXpUKh/rPovopTD392u8KavqQFW1iu+gBPSPq/xeZNz+qYMKbUl+r4VTzBQg3fPlRxp1lNZmM2yRgUbkYPNaFb9ihS7GAg5/wZn8lLmThvq39eA0Vlp6hDE92iop885umELt0/NBKf5umQCqqz9EXXLbmmGc7qoLqTaYVuOmqx0LsvrJL0wSL1dSySCjmB/dNAtVUYgg02eWQNKyaLqnpMdCbTLLQ/oCKuNkL5OQ7t1yl5wQGjQhieIRzLtrMgpTSyaHbqDsRurp9Bc5mM078IAg1hXquQNKlJC/wiJ9kbHerFCbtuLGy/7nXVrFH91ud4U4ExCJEuhoTdmuql5kbqYd6Ye/bu2CftPni19nDkSJ8w4NoqMNKbK3Mi/Cd0o113HsVYlETMv1vlJWZWYP91PK9trixiY4E0G81c6IKITjHDrOJ9evdw2T1/TrvY6pzre3UXSJbFMDQVX6JoAxFk02SRZDKOZdRojeoX19lgrFAAAABzjlz3Qg2as3vn7MRQVxDfZucgE</CipherValue>
      </CipherData>
    </EncryptedData>
  </connectionStrings>
  <configProtectedData defaultProvider="RsaProtectedConfigurationProvider">
    <providers>
      <clear />
      <add keyContainerName="NetFrameworkConfigurationKey" cspProviderName=""
        useMachineContainer="true" useOAEP="false" description="Uses RsaCryptoServiceProvider to encrypt and decrypt"
        name="RsaProtectedConfigurationProvider" type="System.Configuration.RsaProtectedConfigurationProvider,System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
      <add useMachineProtection="true" description="Uses CryptProtectData and CryptUnProtectData Windows APIs to encrypt and decrypt"
        keyEntropy="" name="DataProtectionConfigurationProvider" type="System.Configuration.DpapiProtectedConfigurationProvider,System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    </providers>
  </configProtectedData>
</configuration>

備註

DpapiProtectedConfigurationProvider 可讓您保護儲存在組態檔中的敏感性資訊不受未經授權的存取。

您可以使用標準 DpapiProtectedConfigurationProvider，方法是在組態檔中宣告提供者和適當的設定，而不是建立這個類別的實例。 請參閱下一個範例。

如需受保護組態的詳細資訊，請參閱使用受保護的組態 加密組態資訊。

DpapiProtectedConfigurationProvider 會使用 Windows 內建的密碼編譯服務，並可針對電腦特定或用戶帳戶特定的保護進行設定。 機器特定的保護對於匿名服務很有用，但提供較少的安全性。 用戶帳戶特定保護可以搭配以特定使用者身分識別執行的服務搭配使用。

建構函式

DpapiProtectedConfigurationProvider()

使用預設設定，初始化 DpapiProtectedConfigurationProvider 類別的新實例。

屬性

Description	取得簡短且易記的描述，適合顯示在系統管理工具或其他使用者介面中。 (繼承來源 ProviderBase)
Name	取得組態期間用來參考提供者的易記名稱。 (繼承來源 ProviderBase)
UseMachineProtection	取得值，這個值表示 DpapiProtectedConfigurationProvider 物件是否使用計算機特定或用戶帳戶特定的保護。

方法

Decrypt(XmlNode)	解密傳遞 XmlNode 物件。
Encrypt(XmlNode)	加密傳遞 XmlNode 物件。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
Initialize(String, NameValueCollection)	使用預設設定初始化提供者。
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

另請參閱

• RsaProtectedConfigurationProvider
• 密碼編譯服務