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

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

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

ActiveDirectoryMembershipProvider.CreateUser メソッド

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

新規ユーザーを Active Directory データストアに追加します。

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

Visual Basic (宣言)

Public Overrides Function
 CreateUser ( _
    username As String, _
    password As String, _
    email As String, _
    passwordQuestion As String, _
    passwordAnswer As String, _
    isApproved As Boolean, _
    providerUserKey As Object, _
    <OutAttribute> ByRef status As MembershipCreateStatus
 _
) As MembershipUser

Visual Basic (使用法)

Dim instance As ActiveDirectoryMembershipProvider
Dim username As String
Dim password As String
Dim email As String
Dim passwordQuestion As String
Dim passwordAnswer As String
Dim isApproved As Boolean
Dim providerUserKey As Object
Dim status As MembershipCreateStatus
Dim returnValue As MembershipUser

returnValue = instance.CreateUser(username, password, email, passwordQuestion, passwordAnswer,
 isApproved, providerUserKey, status)

public override MembershipUser CreateUser (
    string username,
    string password,
    string email,
    string passwordQuestion,
    string passwordAnswer,
    bool isApproved,
    Object providerUserKey,
    out MembershipCreateStatus status
)

C++

public:
virtual MembershipUser^ CreateUser (
    String^ username, 
    String^ password, 
    String^ email, 
    String^ passwordQuestion, 
    String^ passwordAnswer, 
    bool isApproved, 
    Object^ providerUserKey, 
    [OutAttribute] MembershipCreateStatus% status
) override

public MembershipUser CreateUser (
    String username, 
    String password, 
    String email, 
    String passwordQuestion, 
    String passwordAnswer, 
    boolean isApproved, 
    Object providerUserKey, 
    /** @attribute OutAttribute() */ /** @ref */ MembershipCreateStatus status
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

username: 新しいユーザーのユーザー名。

password: 新規ユーザーのパスワード。

email: 新規ユーザーの電子メールアドレス。

passwordQuestion: 新しいユーザーのパスワードの質問。

passwordAnswer: 新しいユーザーのパスワードの解答。

isApproved: 新しいユーザーを承認するかどうか。

providerUserKey: メンバシップデータソースでのユーザーの一意の識別子。ActiveDirectoryMembershipProvider クラスを使用するときは、このパラメータを null 参照 (Visual Basic では Nothing) に設定する必要があります。

status: このメソッドから制御が戻るときに、ユーザーが正常に作成されたかどうかを示す MembershipCreateStatus 列挙値の 1 つを格納します。

戻り値
新しく作成したユーザーに関する情報を格納している ActiveDirectoryMembershipUser インスタンス。ユーザーが正常に作成されなかった場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
ArgumentException	providerUserKey パラメータが null 参照 (Visual Basic では Nothing) ではありません。
NotSupportedException	管理者がパスワードの質問と解答のフィールドを Active Directory スキーマの属性にマップしておらず、passwordQuestion パラメータまたは passwordAnswer パラメータが null 参照 (Visual Basic では Nothing) ではありません。
ProviderException	machineKey 要素 (ASP.NET 設定スキーマ) 構成要素は、自動生成されたマシン暗号化キーを示します。ActiveDirectoryMembershipProvider を使用してパスワードの解答を格納するには、machineKey 要素 (ASP.NET 設定スキーマ) 要素の decriptionKey 属性を明示的に設定する必要があります。または新規ユーザーのパスワードの設定を試みているときに、ActiveDirectoryMembershipProvider はディレクトリへのセキュリティで保護された接続を確立できませんでした。
COMException	ユーザーの作成を試みているときにエラーが発生しました。
InvalidOperationException	ActiveDirectoryMembershipProvider インスタンスが初期化される前に CreateUser メソッドが呼び出されました。

解説

CreateUser メソッドは、Active Directory データストアに新規ユーザーを作成するときに、Membership クラスによって呼び出されます。

Active Directory サーバーの場合も ADAM サーバーの場合も、ActiveDirectoryMembershipProvider クラスでは、ディレクトリ内のインスタンスクラスは user である必要があります。inetOrgPerson などの他のユーザークラスはサポートされません。

Active Directory サーバーを使用している場合、ユーザー名が userPrincipalName 属性にマップされているときは、ActiveDirectoryMembershipProvider クラスによって 20 文字のランダムなユーザー名が sAMAccountName パラメータに対して自動生成されます。

パラメータは、既定で次の最大長に設定されます。

パラメータ	最大長
username	userPrincipalName 属性を使用する場合は 64 文字。sAMAccountName 属性を使用する場合は、一般的な制限は 20 文字以下です。
password	128 文字。
email	256 文字。
passwordQuestion	256 文字。
passwordAnswer	暗号化する前と後で 128 文字。

返された ActiveDirectoryMembershipUser インスタンスの Comment プロパティは 1024 文字に制限されます。

これらの属性の最大文字長を短くすることによりディレクトリスキーマが変更された場合、変更後の長さが優先されます。

ActiveDirectoryMembershipProvider クラスでは、ユーザーを作成する前に、ユーザー名が一意であることを確認します。一意の電子メールアドレスを必要とするように ActiveDirectoryMembershipProvider インスタンスが構成されている場合、電子メールアドレスが一意であることも確認されます。

Active Directory では、ユーザー名が userPrincipalName にマップされるときに、GC 検索を実行してユーザー名が一意になるようにします。sAMAccountName を使用する場合は、Active Directory ドメイン全体で自動的に sAMAccountName を一意にします。

ADAM サーバーの場合は、すべてのアプリケーションパーティション間で自動的に userPrincipalName のユーザー名を一意にします。

電子メールアドレスは、ユーザーが作成されたコンテナのルートを開始点として、重複する電子メールアドレスのサブツリー検索を実行することにより、一意にします。これは、既定のユーザーコンテナ (Active Directory に接続されており、接続文字列でコンテナを指定しなかった場合) または接続文字列で指定したコンテナです。

ActiveDirectoryMembershipProvider クラスは、接続文字列で指定したユーザーコンテナにユーザーを直接作成します。接続文字列の詳細については、ActiveDirectoryMembershipProvider クラスのトピックを参照してください。

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

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

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

セキュリティに関するメモ
Active Directory サーバーへの接続に使用する資格情報が Domain Administrator 権限を持っている (お勧めしません) か、または "子インスタンスの作成"、"子インスタンスの削除"、および "パスワードの設定" のアクセス権を持っている場合にのみ、新規ユーザーを作成できます。"子インスタンスの削除" アクセス権が必要になるのは、ユーザーの作成が複数の手順で構成されるプロセスであり、そのいずれかの手順が失敗した場合、ActiveDirectoryMembershipProvider クラスは不完全に構築されたユーザーインスタンスをディレクトリに残さずに、そのユーザーインスタンスを削除するからです。