ActiveDirectoryMembershipProvider.ResetPassword メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ActiveDirectoryMembershipProvider.ResetPassword メソッド

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

ユーザーのパスワードを、自動的に生成された新しいパスワードにリセットします。

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

Visual Basic (宣言)

Public Overrides Function
 ResetPassword ( _
    username As String, _
    passwordAnswer As String _
) As String

Visual Basic (使用法)

Dim instance As ActiveDirectoryMembershipProvider
Dim username As String
Dim passwordAnswer As String
Dim returnValue As String

returnValue = instance.ResetPassword(username, passwordAnswer)

public override string ResetPassword (
    string username,
    string passwordAnswer
)

C++

public:
virtual String^ ResetPassword (
    String^ username, 
    String^ passwordAnswer
) override

public String ResetPassword (
    String username, 
    String passwordAnswer
)

JScript

public override function ResetPassword (
    username : String, 
    passwordAnswer : String
) : String

パラメータ

username: パスワードをリセットするユーザー。

passwordAnswer: 指定したユーザーのパスワードの解答。

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

例外

例外の種類	条件
InvalidOperationException	ActiveDirectoryMembershipProvider インスタンスが初期化される前に ResetPassword メソッドが呼び出されました。
NotSupportedException	EnablePasswordReset プロパティ値が false です。
ArgumentNullException	passwordAnswer が null 参照 (Visual Basic では Nothing) です。または username が null 参照 (Visual Basic では Nothing) です。
ArgumentException	トリム後の passwordAnswer が空です。または passwordAnswer が 128 文字を超えています。または username が空であるか、ユーザー名の許容最大長 (通常は 256 文字) を超えています。または username はコンマを含んでいます。またはユーザー名は userPrincipalName にマップされていますが、username パラメータに円記号が含まれています。
MembershipPasswordException	無効なログオン試行が所定の回数行われたか、またはパスワードの解答によるリセット試行が所定の回数行われたため、ユーザーがロックアウトされています。または passwordAnswer は、格納されているパスワードの解答と一致しません。
ProviderException	username に指定されたユーザーが Active Directory データストアに存在しません。または生成されたパスワードがカスタム検証ハンドラに合格しませんでした。または生成されたパスワードが Active Directory サーバーで設定されているカスタムパスワードポリシーの複雑さの基準を満たしていません。または新しいパスワードを設定するために Active Directory Application Mode サーバーにセキュリティで保護された接続を確立できません。

解説

このメソッドは、Active Directory データストアでユーザーのパスワードをランダムに生成された新しい値にリセットするときに、Membership クラスによって呼び出されます。新しいパスワードが返されます。

メモ
ResetPassword メソッドにより生成されたランダムパスワードは、PasswordStrengthRegularExpression プロパティの正規表現に合格するとは限りません。ただし、ランダムパスワードは、MinRequiredPasswordLength プロパティおよび MinRequiredNonAlphanumericCharacters プロパティで設定された基準は満たしています。

正しくないパスワードの解答が ResetPassword メソッドに対して入力されると、無効なパスワードの解答の指定回数を追跡する内部カウンタが 1 つインクリメントされます。これにより、UnlockUser メソッドが呼び出されてロックステータスが解除されるまでそのユーザーのログオンを禁止できます。ユーザーがロックアウトされていない状態で、正しいパスワードの解答が指定されると、無効なパスワードの解答の指定回数を追跡する内部カウンタはゼロにリセットされます。詳細については、MaxInvalidPasswordAttempts プロパティのトピックと PasswordAttemptWindow プロパティのトピックを参照してください。

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

最初に Membership.Provider プロパティから ActiveDirectoryMembershipProvider インスタンスの参照を取得することにより、ResetPassword メソッドを直接呼び出すことができます。

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

Active Directory サーバーでパスワードを設定するには、connectionProtection 属性が SignAndSeal に設定されている必要があります。

ADAM サーバーを使用している場合は、セキュリティで保護されていない接続経由でのパスワード変更を許可するよう ADAM サーバーを明示的に構成した場合のみ、connectionProtection 属性を None に設定できます。

メモ
Active Directory サーバーに設定されているセキュリティポリシーによっては、このポリシーを満たすパスワードを ResetPassword メソッドが生成できない場合があります。GeneratePassword メソッドの既定の実装では、Windows Server 2003 SP1 を実行しているドメインコントローラの既定のパスワードポリシーを満たすパスワードが生成されます。Active Directory サーバーのセキュリティポリシーが原因でパスワードをリセットできない場合は、ProviderException がスローされます。

メモ

Active Directory サーバーに設定されているセキュリティポリシーによっては、このポリシーを満たすパスワードを ResetPassword メソッドが生成できない場合があります。GeneratePassword メソッドの既定の実装では、Windows Server 2003 SP1 を実行しているドメインコントローラの既定のパスワードポリシーを満たすパスワードが生成されます。Active Directory サーバーのセキュリティポリシーが原因でパスワードをリセットできない場合は、ProviderException がスローされます。