Đồng bộ người dùng với hệ thống Active Directory của tổ chức

Giải pháp sẵn có và linh động để ánh xạ các thuộc tính người dùng từ máy chủ Active Directory của tổ chức. Nâng cao sự tiện dụng cho người dùng và đơn giản hóa việc quản lý.

Đồng bộ người dùng với hệ thống Active Directory của tổ chức

Với nhu cầu cá nhân hoặc tại các công ty/phòng ban nhỏ. Việc enduser tự đăng ký tài khoản và sử dụng Smart Drafting Hub khá đơn giản. Nhưng với những tổ chức lớn có sẵn hệ thống quản lý tập trung Active Directory thì hoàn toàn có thể tích hợp để nâng cao trải nghiệm cho nhân viên, cũng như đơn giản hóa việc quản lý.

1. Nhu cầu linh hoạt khi kết nối máy chủ AD

Trong phiên bản đầu, phương án tích hợp với AD được đưa sẵn vào biến môi trường và tệp cấu hình của Smart Drafting Hub. Nhưng sẽ gây mất thời gian cho việc cấu hình và cần khởi động lại hệ thống làm gián đoạn công việc.

Hiện tại chương trình đã đưa phần cấu hình này vào /admin, với cấu trúc khai báo linh hoạt nhằm ánh xạ một cách mềm dẻo với các thuộc tính ở phía Active Directory.

anhxaAD.png


2. Mô hình ánh xạ động

Hệ thống lưu cấu hình ánh xạ dưới dạng cấu trúc JSON trong cơ sở dữ liệu và sử dụng cơ chế phản chiếu để gán dữ liệu vào đối tượng người dùng khi đăng nhập:
Active Directory to Database Mapping Flow.webp


Triển khai phương thức ánh xạ

Đoạn mã xử lý đồng bộ thuộc tính được đóng gói trong tầng dịch vụ:

class LDAPService:
    @staticmethod
    def sync_user_attributes(user, profile, ldap_entry: dict, attr_mapping: dict):
        """
        Ánh xạ động thuộc tính từ Active Directory sang User và UserProfile
        dựa trên cấu hình do nhân viên quản trị thiết lập trên giao diện.
        """
        for user_field in ['first_name', 'last_name', 'email']:
            ad_attr = attr_mapping.get(user_field)
            if ad_attr and ad_attr in ldap_entry:
                val = ldap_entry[ad_attr]
                val_str = val[0].decode('utf-8') if isinstance(val, list) and val else str(val)
                setattr(user, user_field, val_str)
        for prof_field in ['full_name', 'phone', 'position', 'department', 'workplace']:
            ad_attr = attr_mapping.get(prof_field)
            if ad_attr and ad_attr in ldap_entry:
                val = ldap_entry[ad_attr]
                val_str = val[0].decode('utf-8') if isinstance(val, list) and val else str(val)
                if hasattr(profile, prof_field):
                    setattr(profile, prof_field, val_str)

        profile.is_ldap = True
        user.save()
        profile.save()

Xử lý trạng thái tài khoản bị khóa

Hệ thống đọc giá trị số nguyên đại diện cho các cờ trạng thái (userAccountControl) từ Active Directory và kiểm tra cờ vô hiệu hóa:

ACCOUNTDISABLE = 0x0002

def is_ad_user_disabled(user_account_control_int: int) -> bool:
    return bool(user_account_control_int & ACCOUNTDISABLE)
uac_value = int(ldap_entry.get('userAccountControl', [0])[0])
if is_ad_user_disabled(uac_value):
    user.is_active = False
    user.save()
    raise PermissionDenied("Tài khoản của bạn đã bị vô hiệu hóa trên hệ thống chung.")

Đồng bộ phân quyền theo nhóm

Hệ thống cho phép nhân viên quản trị liên kết từng nhóm trên Active Directory với một nhóm quyền tương ứng trong phần mềm. Hiện tại bất kỳ username mới phát sinh đều được gán vào nhóm quyền cơ bản nhất:

user_ad_groups = ldap_entry.get('memberOf', [])
for ad_group_dn in user_ad_groups:
    dn_str = ad_group_dn.decode('utf-8')
    matched_django_group = group_mapping.get(dn_str)
    if matched_django_group:
        group_obj, _ = Group.objects.get_or_create(name=matched_django_group)
        user.groups.add(group_obj)

Kết quả đạt được

  • Quá trình kết nối với hệ thống thư mục của một đơn vị mới diễn ra thuận tiện trên giao diện quản trị trong vài phút.
  • Đảm bảo tính nhất quán về thông tin nhân sự và quyền hạn giữa hệ thống chung và phần mềm nội bộ.

❓ Câu hỏi thường gặp

Khi máy chủ AD gặp sự cố thì quản trị viên có thể truy cập hệ thống không?
Có. Hệ thống hỗ trợ cơ chế đăng nhập bằng tài khoản quản trị nội bộ để đảm bảo khả năng duy trì hoạt động trong các tình huống khẩn cấp.

Đăng ký nhận bài viết mới từ Kỷ nguyên Ai

Đừng bỏ lỡ các ấn bản mới nhất. Đăng ký ngay để truy cập thư viện dành riêng cho thành viên.
[email protected]
Đăng ký đọc