FormsAuthenticationCredentials クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
フォーム ベース認証を使用する ASP.NET アプリケーションに対してユーザー資格情報を構成します。
public ref class FormsAuthenticationCredentials sealed : System::Configuration::ConfigurationElementpublic sealed class FormsAuthenticationCredentials : System.Configuration.ConfigurationElementtype FormsAuthenticationCredentials = class
inherit ConfigurationElementPublic NotInheritable Class FormsAuthenticationCredentials
Inherits ConfigurationElement- 継承
例
この例では、 セクションのいくつかの属性に対して宣言的に値を credentials 指定する方法を示します。これは、 クラスの FormsAuthenticationCredentials メンバーとしてもアクセスできます。
次の構成ファイルの例は、 セクションに値を宣言的に指定する方法を credentials 示しています。
<credentials passwordFormat="SHA1">
<user name="aspnetuser1"
password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
<user name="aspnetuser2"
password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
</credentials>
この例では SHA1 を使用します。 SHA1 との競合問題のため、Microsoft では SHA256 を推奨しています。
注意
セクションを使用する credentials 場合は、「 ASP.NET 認証」で説明されているガイドラインに従ってください。 スケーラビリティとセキュリティを強化するために、外部データベースを使用してユーザーの資格情報を格納することをお勧めします。 セキュリティで保護された ASP.NET アプリケーションの構築の詳細については、「 ASP.NET アプリケーションのセキュリティ保護 」および「 セキュリティで保護された ASP.NET アプリケーションの構築: 認証、承認、およびセキュリティで保護された通信」を参照してください。
次のコード例では、 クラスの使用方法 FormsAuthenticationCredentials を示します。
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration("/aspnetTest");
// Get the authentication section.
AuthenticationSection authenticationSection =
(AuthenticationSection)configuration.GetSection(
"system.web/authentication");
// Get the forms credentials collection .
FormsAuthenticationCredentials formsAuthenticationCredentials =
authenticationSection.Forms.Credentials;
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the authentication section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
' Get the forms credentials collection .
Dim formsAuthenticationCredentials _
As FormsAuthenticationCredentials = _
authenticationSection.Forms.Credentials
注釈
クラスはFormsAuthenticationCredentials、構成ファイルの セクションの セクションの forms 要素にプログラムでauthenticationアクセスして変更credentialsする方法を提供します。 この型は、 型、、 型をFormsAuthenticationConfigurationFormsAuthenticationUserCollection含むグループのFormsAuthenticationUser一部です。 コレクション型を除き、それ以外はすべて基になる構成タグに直接影響します。
注意
では FormsAuthenticationCredentials 、 で MachineToApplication定義されている制限に従って、構成ファイルの関連セクションに情報を書き込むことができます。 階層内で許可されていないレベルで構成ファイルに書き込もうとすると、パーサーによってエラー メッセージが生成されます。 ただし、このクラスを使用して、階層内の任意のレベルで構成情報を読み取ることができます。 安全性とスケーラビリティを確保するために、データベースなどの外部リポジトリを使用して、ユーザーの資格情報を保持することをお勧めします。
コンストラクター
| FormsAuthenticationCredentials() |
FormsAuthenticationCredentials クラスの新しいインスタンスを初期化します。 |
プロパティ
メソッド
適用対象
こちらもご覧ください
.NET