ActiveDirectoryMembershipProvider.ChangePasswordQuestionAndAnswer メソッド

.NET Framework クラス ライブラリ リファレンス

ActiveDirectoryMembershipProvider.ChangePasswordQuestionAndAnswer メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

Active Directory ストアでユーザーのパスワードの質問と解答を更新します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 ChangePasswordQuestionAndAnswer ( _
    username As String, _
    password As String, _
    newPasswordQuestion As String, _
    newPasswordAnswer As String _
) As Boolean

Visual Basic (使用法)

Dim instance As ActiveDirectoryMembershipProvider
Dim username As String
Dim password As String
Dim newPasswordQuestion As String
Dim newPasswordAnswer As String
Dim returnValue As Boolean

returnValue = instance.ChangePasswordQuestionAndAnswer(username, password, newPasswordQuestion,
 newPasswordAnswer)

C#

public override bool ChangePasswordQuestionAndAnswer
 (
    string username,
    string password,
    string newPasswordQuestion,
    string newPasswordAnswer
)

C++

public:
virtual bool ChangePasswordQuestionAndAnswer (
    String^ username, 
    String^ password, 
    String^ newPasswordQuestion, 
    String^ newPasswordAnswer
) override

J#

public boolean ChangePasswordQuestionAndAnswer (
    String username, 
    String password, 
    String newPasswordQuestion, 
    String newPasswordAnswer
)

JScript

public override function ChangePasswordQuestionAndAnswer
 (
    username : String, 
    password : String, 
    newPasswordQuestion : String, 
    newPasswordAnswer : String
) : boolean

パラメータ

username

パスワードの質問と解答を変更するユーザー。

password

指定したユーザーのパスワード。

newPasswordQuestion

指定したユーザーの新しいパスワード。

newPasswordAnswer

指定したユーザーの新しいパスワードの解答。

戻り値
更新が正常に実行された場合は true。それ以外の場合は false。パスワードが無効であったり、ユーザーがロックアウトされていたり、ユーザーが Active Directory データ ストアに存在していない場合にも false が返されます。

例外

例外の種類	条件
NotSupportedException	管理者がパスワードの質問と解答のフィールドを Active Directory スキーマの属性にマップしていません。
ArgumentException	username が空であるか、ユーザー名の最大長 (通常は 256 文字) を超えています。 または username はコンマを含んでいます。 または ユーザー名は userPrincipalName 属性にマップされており、username パラメータに円記号が含まれています。 または password は、長さ 0 の文字列です。 または password がパスワードの最大長 (通常は 128 文字) を超えています。 または newPasswordQuestion が空で、RequiresQuestionAndAnswer プロパティ値が true です。 または newPasswordQuestion が 256 文字を超えています。 または 解答を暗号化した後の newPasswordAnswer が 128 文字を超えています。
ArgumentNullException	username が null 参照 (Visual Basic では Nothing) です。 または password が null 参照 (Visual Basic では Nothing) です。 または newPasswordQuestion が null 参照 (Visual Basic では Nothing) で、RequiresQuestionAndAnswer プロパティが true です。 または newPasswordAnswer が null 参照 (Visual Basic では Nothing) で、RequiresQuestionAndAnswer プロパティが true です。
ProviderException	machineKey 要素 (ASP.NET 設定スキーマ) 構成要素は、自動生成されたマシン暗号化キーを示します。ActiveDirectoryMembershipProvider を使用してパスワードの解答を格納するには、machineKey 要素 (ASP.NET 設定スキーマ) 要素の decriptionKey 属性を明示的に設定する必要があります。
InvalidOperationException	ActiveDirectoryMembershipProvider インスタンスが初期化される前に ChangePasswordQuestionAndAnswer メソッドが呼び出されました。

解説

このメソッドは、Active Directory メンバシップ ストアでユーザーのパスワードの質問と解答を更新するときに、ActiveDirectoryMembershipUser クラスによって呼び出されます。

パスワードの質問と解答を要求することにより、ユーザーのパスワードをリセットする際のセキュリティをさらに高めることができます。ユーザー名を作成するときに、パスワードを忘れた場合に備えて、忘れたパスワードをリセットする際に使用される質問とその解答を設定しておくことができます。ChangePasswordQuestionAndAnswer メソッドは、メンバシップ ユーザーのパスワードの質問と解答を新しい値に更新します。

ChangePasswordQuestionAndAnswer メソッドを使用するには、次に示す追加の属性をアプリケーションの構成ファイルで設定する必要があります。

• requiresQuestionAndAnswer を true に設定する必要があります。

• attributeMapPasswordQuestion および attributeMapPasswordAnswer を Active Directory スキーマ内の属性にマップする必要があります。

上の基準が満たされていない場合は、初期化時に ProviderException がスローされます。

ActiveDirectoryMembershipProvider インスタンスは、username パラメータおよび password パラメータに指定された資格情報を使用して Active Directory データ ストアに接続し、ユーザー名とパスワードの組み合わせを検証します。質問と解答の実際の更新は、プロバイダの構成された接続資格情報を使用して行われます。

ChangePasswordQuestionAndAnswer メソッドに正しくないパスワードが入力された場合は、無効なパスワードの指定回数を追跡するカウンタがインクリメントされます。これにより、ユーザーをロックし、UnlockUser メソッドが呼び出されてロック ステータスが解除されるまで、またはディレクトリに指定されたロック期間が経過するまで、そのユーザーのログオンを禁止できます。

質問と解答の更新が成功し、EnablePasswordReset プロパティが true の場合は、ユーザーの無効なパスワードの解答の追跡カウンタがリセットされます。

パスワードの解答は、EncryptPassword メソッドを使用して暗号化されてから、Active Directory データ ストアに格納されます。暗号化のキーとアルゴリズムは、machineKey 要素 (ASP.NET 設定スキーマ) 構成要素により指定されます。machineKey 要素 (ASP.NET 設定スキーマ) の復号化属性は指定する必要があります。ActiveDirectoryMembershipProvider クラスでは、自動生成された暗号化キーはサポートされません。

パスワードの質問の最大長は 256 文字です。パスワードの解答の最大長は 128 文字です。

password 以外のすべてのパラメータ値について文字列の先頭と末尾の空白はトリムされます。

プロバイダは、接続文字列で指定された検索位置を開始点としてユーザー名のサブツリー検索を実行することによって、更新するユーザー インスタンスを検索します。接続文字列の詳細については、ActiveDirectoryMembershipProvider クラスのトピックを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ActiveDirectoryMembershipProvider クラス
ActiveDirectoryMembershipProvider メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要