MENU
  1. ホーム
  2. C#
  3. フォーム
  4. コンポーネント
  5. DirectoryEntry
  6. [C#] DirectoryEntryとsAMAccountNameの使い方

[C#] DirectoryEntryとsAMAccountNameの使い方

DirectoryEntry

C#でDirectoryEntryとsAMAccountNameを使用する際は、主にActive Directoryにアクセスしてユーザー情報を取得または操作するために用います。

DirectoryEntryはActive Directoryのオブジェクトを表し、LDAPパスを指定して接続します。

sAMAccountNameはユーザーのログオン名を示す属性で、ユーザーを一意に識別するために使用されます。

例えば、DirectoryEntryを使って特定のsAMAccountNameを持つユーザーを検索し、そのユーザーの情報を取得することが可能です。

これにより、ユーザーの属性を読み取ったり、更新したりすることができます。

この記事でわかること
  • DirectoryEntryの基本的な使い方
  • sAMAccountNameの取得と利用方法
  • Active Directoryでのユーザー管理手法
  • グループメンバーシップの操作方法
  • ユーザーのパスワードリセット手順

目次から探す

DirectoryEntryの使い方

DirectoryEntryの初期化

DirectoryEntryクラスは、Active Directoryのオブジェクトを表現するために使用されます。

初期化する際には、LDAPパスを指定する必要があります。

以下は、DirectoryEntryの初期化のサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry directoryEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // DirectoryEntryの初期化
        directoryEntry = new DirectoryEntry("LDAP://CN=Users,DC=example,DC=com");
    }
}

このコードでは、DirectoryEntryを初期化し、指定したLDAPパスに接続しています。

CN=Users,DC=example,DC=comは、Active Directory内の特定のコンテナを指します。

LDAPパスの指定方法

LDAPパスは、Active Directory内のオブジェクトを一意に識別するための重要な要素です。

以下の形式で指定します。

  • LDAP://：LDAPプロトコルを示すプレフィックス
  • CN=：共通名(Common Name)
  • OU=：組織単位(Organizational Unit)
  • DC=：ドメインコンポーネント(Domain Component)

例えば、次のようなLDAPパスを指定することができます。

スクロールできます
LDAPパス例説明
LDAP://CN=John Doe,OU=Users,DC=example,DC=comユーザー John Doe のエントリ
LDAP://OU=Sales,DC=example,DC=comSales 組織単位のエントリ

認証情報の設定

DirectoryEntryを使用する際には、必要に応じて認証情報を設定することができます。

以下のサンプルコードでは、ユーザー名とパスワードを指定して認証情報を設定しています。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry directoryEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // 認証情報を設定してDirectoryEntryを初期化
        directoryEntry = new DirectoryEntry("LDAP://CN=Users,DC=example,DC=com", "username", "password");
    }
}

このコードでは、usernameとpasswordを使用して、指定したLDAPパスに接続しています。

これにより、適切な権限を持つユーザーとしてActive Directoryにアクセスすることが可能になります。

sAMAccountNameの利用方法

sAMAccountNameの取得

sAMAccountNameは、Active Directory内のユーザーアカウントを一意に識別するための属性です。

この属性を取得するには、DirectoryEntryオブジェクトを使用してユーザー情報にアクセスします。

以下は、特定のユーザーのsAMAccountNameを取得するサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry directoryEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // DirectoryEntryの初期化
        directoryEntry = new DirectoryEntry("LDAP://CN=John Doe,OU=Users,DC=example,DC=com");
        // sAMAccountNameの取得
        string samAccountName = directoryEntry.Properties["sAMAccountName"].Value.ToString();
        MessageBox.Show("sAMAccountName: " + samAccountName);
    }
}

このコードでは、指定したユーザーのsAMAccountNameを取得し、メッセージボックスで表示しています。

Propertiesコレクションを使用して、sAMAccountName属性にアクセスしています。

sAMAccountNameを用いたユーザー検索

sAMAccountNameを使用して、特定のユーザーをActive Directory内で検索することができます。

以下は、sAMAccountNameを用いてユーザーを検索するサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry directoryEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // DirectoryEntryの初期化
        directoryEntry = new DirectoryEntry("LDAP://DC=example,DC=com");
        // ユーザー検索
        DirectorySearcher searcher = new DirectorySearcher(directoryEntry)
        {
            Filter = "(sAMAccountName=jdoe)" // sAMAccountNameでフィルタリング
        };
        SearchResult result = searcher.FindOne();
        if (result != null)
        {
            MessageBox.Show("ユーザーが見つかりました: " + result.Properties["sAMAccountName"][0]);
        }
        else
        {
            MessageBox.Show("ユーザーが見つかりませんでした。");
        }
    }
}

このコードでは、DirectorySearcherを使用して、指定したsAMAccountNameを持つユーザーを検索しています。

検索結果が見つかった場合は、そのsAMAccountNameを表示します。

sAMAccountNameの更新

既存のユーザーのsAMAccountNameを更新することも可能です。

以下は、ユーザーのsAMAccountNameを変更するサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry directoryEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // DirectoryEntryの初期化
        directoryEntry = new DirectoryEntry("LDAP://CN=John Doe,OU=Users,DC=example,DC=com");
        // sAMAccountNameの更新
        directoryEntry.Properties["sAMAccountName"].Value = "newSamAccountName";
        directoryEntry.CommitChanges(); // 変更を保存
        MessageBox.Show("sAMAccountNameが更新されました。");
    }
}

このコードでは、指定したユーザーのsAMAccountNameをnewSamAccountNameに変更し、CommitChangesメソッドを呼び出して変更を保存しています。

これにより、Active Directory内のユーザー情報が更新されます。

Active Directoryでのユーザー管理

ユーザー情報の取得

Active Directoryからユーザー情報を取得するには、DirectoryEntryとDirectorySearcherを使用します。

以下は、特定のユーザーの情報を取得するサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry directoryEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // DirectoryEntryの初期化
        directoryEntry = new DirectoryEntry("LDAP://DC=example,DC=com");
        // ユーザー情報の取得
        DirectorySearcher searcher = new DirectorySearcher(directoryEntry)
        {
            Filter = "(sAMAccountName=jdoe)" // sAMAccountNameでフィルタリング
        };
        SearchResult result = searcher.FindOne();
        if (result != null)
        {
            string userInfo = "ユーザー名: " + result.Properties["sAMAccountName"][0] + "\n" +
                              "フルネーム: " + result.Properties["displayName"][0];
            MessageBox.Show(userInfo);
        }
        else
        {
            MessageBox.Show("ユーザーが見つかりませんでした。");
        }
    }
}

このコードでは、指定したsAMAccountNameを持つユーザーの情報を取得し、ユーザー名とフルネームをメッセージボックスで表示しています。

ユーザー情報の更新

既存のユーザーの情報を更新するには、DirectoryEntryを使用して属性を変更し、CommitChangesメソッドで保存します。

以下は、ユーザーのフルネームを更新するサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry directoryEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // DirectoryEntryの初期化
        directoryEntry = new DirectoryEntry("LDAP://CN=John Doe,OU=Users,DC=example,DC=com");
        // ユーザー情報の更新
        directoryEntry.Properties["displayName"].Value = "新しいフルネーム";
        directoryEntry.CommitChanges(); // 変更を保存
        MessageBox.Show("ユーザー情報が更新されました。");
    }
}

このコードでは、指定したユーザーのフルネームを新しいフルネームに変更し、変更を保存しています。

ユーザーの追加と削除

Active Directoryに新しいユーザーを追加するには、DirectoryEntryを使用して新しいエントリを作成します。

また、ユーザーを削除するには、Deleteメソッドを使用します。

以下は、ユーザーの追加と削除のサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry directoryEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // DirectoryEntryの初期化
        directoryEntry = new DirectoryEntry("LDAP://OU=Users,DC=example,DC=com");
        // ユーザーの追加
        DirectoryEntry newUser = directoryEntry.Children.Add("CN=Jane Doe", "user");
        newUser.Properties["sAMAccountName"].Value = "janedoe";
        newUser.Properties["userPrincipalName"].Value = "janedoe@example.com";
        newUser.CommitChanges(); // 変更を保存
        MessageBox.Show("新しいユーザーが追加されました。");
        // ユーザーの削除
        directoryEntry.Children.Remove(newUser); // 追加したユーザーを削除
        directoryEntry.CommitChanges(); // 変更を保存
        MessageBox.Show("ユーザーが削除されました。");
    }
}

このコードでは、Jane Doeという新しいユーザーを追加し、その後すぐに削除しています。

Children.Addメソッドを使用して新しいユーザーを作成し、Children.Removeメソッドで削除しています。

応用例

グループメンバーシップの管理

Active Directory内のユーザーをグループに追加したり、グループから削除したりすることができます。

以下は、ユーザーを特定のグループに追加するサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry groupEntry;
    private DirectoryEntry userEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // グループとユーザーのDirectoryEntryを初期化
        groupEntry = new DirectoryEntry("LDAP://CN=Sales,OU=Groups,DC=example,DC=com");
        userEntry = new DirectoryEntry("LDAP://CN=John Doe,OU=Users,DC=example,DC=com");
        // ユーザーをグループに追加
        groupEntry.Properties["member"].Add(userEntry.Properties["distinguishedName"].Value);
        groupEntry.CommitChanges(); // 変更を保存
        MessageBox.Show("ユーザーがグループに追加されました。");
    }
}

このコードでは、SalesというグループにJohn Doeというユーザーを追加しています。

memberプロパティにユーザーのdistinguishedNameを追加し、変更を保存しています。

ユーザーのパスワードリセット

ユーザーのパスワードをリセットするには、DirectoryEntryを使用して新しいパスワードを設定します。

以下は、ユーザーのパスワードをリセットするサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry userEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // ユーザーのDirectoryEntryを初期化
        userEntry = new DirectoryEntry("LDAP://CN=John Doe,OU=Users,DC=example,DC=com");
        // パスワードのリセット
        userEntry.Invoke("SetPassword", new object[] { "newPassword123" });
        userEntry.CommitChanges(); // 変更を保存
        MessageBox.Show("ユーザーのパスワードがリセットされました。");
    }
}

このコードでは、John DoeというユーザーのパスワードをnewPassword123にリセットしています。

SetPasswordメソッドを呼び出して新しいパスワードを設定し、変更を保存しています。

ユーザーのロック解除

ユーザーがロックされている場合、そのロックを解除することも可能です。

以下は、ユーザーのロックを解除するサンプルコードです。

using System.DirectoryServices;
public partial class MyForm : Form
{
    private DirectoryEntry userEntry;
    public MyForm()
    {
        InitializeComponent(); // フォームの初期化
        // ユーザーのDirectoryEntryを初期化
        userEntry = new DirectoryEntry("LDAP://CN=John Doe,OU=Users,DC=example,DC=com");
        // ユーザーのロック解除
        userEntry.Properties["lockoutTime"].Value = 0; // ロック解除
        userEntry.CommitChanges(); // 変更を保存
        MessageBox.Show("ユーザーのロックが解除されました。");
    }
}

このコードでは、John Doeというユーザーのロックを解除しています。

lockoutTimeプロパティを0に設定することで、ユーザーのロックを解除し、変更を保存しています。

よくある質問

DirectoryEntryを使う際の注意点は？

DirectoryEntryを使用する際には、以下の点に注意が必要です。

  • 権限の確認: Active Directoryにアクセスするためには、適切な権限を持つユーザーアカウントが必要です。

権限が不足していると、操作が失敗することがあります。

  • 接続の安定性: ネットワーク接続が不安定な場合、DirectoryEntryへの接続が失敗することがあります。

接続の安定性を確認してください。

  • リソースの解放: DirectoryEntryオブジェクトを使用した後は、必ずリソースを解放するためにDisposeメソッドを呼び出すことが推奨されます。

これにより、メモリリークを防ぐことができます。

sAMAccountNameと他の属性の違いは？

sAMAccountNameは、Active Directory内でユーザーアカウントを一意に識別するための属性ですが、他の属性といくつかの違いがあります。

  • 一意性: sAMAccountNameは、同じドメイン内で一意である必要がありますが、userPrincipalNameは、全体で一意である必要があります。
  • 形式: sAMAccountNameは通常、ユーザー名の形式(例: jdoe)であり、userPrincipalNameはメールアドレス形式(例: jdoe@example.com)です。
  • 使用目的: sAMAccountNameは、主に古いシステムとの互換性のために使用されることが多く、userPrincipalNameは、主にログインや認証に使用されます。

Active Directoryに接続できない場合の対処法は？

Active Directoryに接続できない場合、以下の対処法を試みることができます。

  • 接続文字列の確認: LDAPパスや認証情報が正しいか確認してください。

特に、ドメイン名やユーザー名に誤りがないかをチェックします。

  • ネットワーク接続の確認: ネットワークが正常に機能しているか確認し、Active Directoryサーバーにアクセスできるかテストします。
  • ファイアウォール設定の確認: ファイアウォールやセキュリティソフトウェアがLDAPポート(通常は389)をブロックしていないか確認します。
  • 権限の確認: 使用しているアカウントがActive Directoryにアクセスするための適切な権限を持っているか確認します。

必要に応じて、管理者に問い合わせて権限を確認します。

まとめ

この記事では、C#を使用してActive Directoryにアクセスし、ユーザー管理を行うための基本的な方法について解説しました。

具体的には、DirectoryEntryやsAMAccountNameを利用したユーザー情報の取得、更新、グループメンバーシップの管理、パスワードリセット、ユーザーのロック解除などの実践的な例を紹介しました。

これらの知識を活用することで、Active Directoryを効果的に管理し、業務の効率化を図ることが可能です。

ぜひ、実際のプロジェクトにおいてこれらの技術を試してみてください。

目次に戻る

当サイトはリンクフリーです。出典元を明記していただければ、ご自由に引用していただいて構いません。

C言語
C++
Python
HTML
Java
HTTP

関連カテゴリーから探す

DirectoryEntry
  • URLをコピーしました！

関連記事

目次から探す