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>

要素情報

構成セクション ハンドラー

System.Web.Configuration.MembershipSection

構成メンバー

Membership

構成できる場所

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

参照

処理手順

方法 : ASP.NET 構成設定をロックする

参照

system.web 要素 (ASP.NET 設定スキーマ)

<configuration> 要素

membership の providers 要素 (ASP.NET 設定スキーマ)

System.Configuration

System.Web.Configuration

概念

ASP.NET 構成の概要

ASP.NET Web サーバー コントロールとブラウザーの機能

ASP.NET 構成の保護

ASP.NET の構成のシナリオ

その他の技術情報

メンバーシップを使用したユーザーの管理

ASP.NET 構成ファイル

ASP.NET 構成設定

全般構成設定 (ASP.NET)

ASP.NET 構成 API