membership 要素 (ASP.NET 設定スキーマ)
ASP.NET メンバーシップを使用して、ユーザー アカウントの管理と認証を行うためのパラメーターを構成します。
この要素は、.NET Framework Version 2.0 で追加されました。
<membership
defaultProvider="provider name"
userIsOnlineTimeWindow="number of minutes"
hashAlgorithmType="SHA1">
<providers>...</providers>
</membership>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
---|---|
defaultProvider |
省略可能な String 型の属性です。 既定のメンバーシップ プロバイダーの名前です。 詳細については、「Provider」を参照してください。 既定値は、AspNetSqlProvider です。 |
userIsOnlineTimeWindow |
省略可能な String 型の属性です。 ユーザー アカウントの最終アクティビティの日付時刻スタンプ以降に、ユーザーがオンラインになっていると見なされる時間 (分) を指定します。 既定値は、15 分です。 |
hashAlgorithmType |
省略可能な String 型の属性です。 パスワード値のハッシュに使用する暗号化アルゴリズムを指定します。 この属性の値は、cryptoNameMapping 構成セクション内にある nameEntry 要素の name 属性に対応します。 カスタム ハッシュ アルゴリズムの指定については、「暗号化クラスへのアルゴリズム名の割り当て」を参照してください。 既定値は、SHA1 です。 |
子要素
要素 |
説明 |
---|---|
providers |
省略可能な要素です。 メンバーシップ プロバイダーのコレクションを定義します。 |
親要素
要素 |
説明 |
---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素を指定します。 |
system.web |
ASP.NET 構成セクションのルート要素を指定します。 |
解説
アプリケーション コード内の membership 要素の構成値のアクセスおよび変更方法については、MembershipSection を参照してください。
既定の構成
次の既定の membership 要素は、.NET Framework Version 2.0 の Machine.config ファイルで構成されます。
<membership>
<providers>
<add name="AspNetSqlMembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" connectionStringName="LocalSqlServer" enablePasswordRetrieval="false" enablePasswordReset="true" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="false" passwordFormat="Hashed" maxInvalidPasswordAttempts="5" minRequiredPasswordLength="7" minRequiredNonalphanumericCharacters="1" passwordAttemptWindow="10" passwordStrengthRegularExpression="" />
</providers>
</membership>
使用例
ユーザー アカウント情報の格納と取得に SqlMembershipProvider プロバイダーを使用するよう ASP.NET アプリケーションを構成する方法を、次のコード例に示します。
<configuration>
<connectionStrings>
<add name="SqlServices"
connectionString="Data Source=MySqlServer;Integrated Security=SSPI;Initial
Catalog=aspnetdb;" />
</connectionStrings>
<system.web>
<membership
defaultProvider="SqlProvider"
userIsOnlineTimeWindow="20">
<providers>
<remove name="AspNetSqlProvider" />
<add name="SqlProvider"
type="System.Web.Security.SqlMembershipProvider"
connectionStringName="SqlServices"
enablePasswordRetrieval="false"
enablePasswordReset="true"
requiresQuestionAndAnswer="true"
passwordFormat="Hashed"
applicationName="/" />
</providers>
</membership>
</system.web>
</configuration>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config |
要件 |
Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0 .NET Framework Version 2.0 Microsoft Visual Studio 2005 |
参照
処理手順
参照
system.web 要素 (ASP.NET 設定スキーマ)
membership の providers 要素 (ASP.NET 設定スキーマ)
概念
ASP.NET Web サーバー コントロールとブラウザーの機能