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

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

ASP.NET メンバーシップを使用して、ユーザー アカウントの管理と認証を行うためのパラメーターを構成します。

この要素は、.NET Framework Version 2.0 で追加されました。

<membership
    defaultProvider="provider name"
    userIsOnlineTimeWindow="number of minutes"
    hashAlgorithmType="SHA1">
    <providers>...</providers>
</membership>

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性

Description

defaultProvider

省略可能な String 属性です。

既定のメンバーシップ プロバイダーの名前です。 詳細については、「Provider」を参照してください。

既定値は、AspNetSqlProvider です。

userIsOnlineTimeWindow

省略可能な String 属性です。

ユーザー アカウントの最終アクティビティの日付時刻スタンプ以降に、ユーザーがオンラインになっていると見なされる時間 (分) を指定します。

既定値は、15 分です。

hashAlgorithmType

省略可能な String 属性です。

パスワード値のハッシュに使用する暗号化アルゴリズムを指定します。

この属性の値は、cryptoNameMapping 構成セクション内にある nameEntry 要素の name 属性に対応します。 カスタム ハッシュ アルゴリズムの指定については、「暗号化クラスへのアルゴリズム名の割り当て」を参照してください。

既定値は、SHA1 です。

子要素

要素

Description

providers

省略可能な要素です。

メンバーシップ プロバイダーのコレクションを定義します。

親要素

要素

Description

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

参照

処理手順

How to: Lock ASP.NET Configuration Settings

Reference

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

<configuration> 要素

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

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

その他の技術情報

Managing Users Using ASP.NET Membership

ASP.NET Configuration Files

ASP.NET 構成設定

全般構成設定 (ASP.NET)

ASP.NET Configuration API