Bỏ qua, đến nội dung chính
WisMail

Kết nối LDAP / Active Directory

Nếu công ty đã lưu người dùng và mật khẩu trong một thư mục, bạn không phải tạo hai lần. WisMail có thể ánh xạ một tên miền thư tới máy chủ LDAP hoặc Microsoft Active Directory: thư mục cung cấp người dùng và nhóm, và mọi người đăng nhập IMAP, POP3, SMTP và webmail bằng mật khẩu thư mục. Mất khoảng 20 phút. Tổng quan tính năng: Bảo mật, 2FA và LDAP.

Những gì chúng tôi đã kiểm chứng. Đăng nhập qua thư mục và ánh xạ người dùng đã được thử với OpenLDAP, gồm cả bản đồ thuộc tính tùy chỉnh và chuyển sang máy chủ thư mục dự phòng. Active Directory và các sản phẩm thư mục khác chọn được nhưng chúng tôi chưa tự thử: hãy chạy thử trên một tên miền kiểm tra trước, và dùng bản dùng thử miễn phí để kiểm tra thư mục của bạn.

Bạn nhận được gì

  • Đăng nhập qua thư mục. Thư mục kiểm tra mật khẩu khi người dùng đăng nhập. Mật khẩu cục bộ không dùng cho người dùng thư mục.
  • Ánh xạ người dùng và nhóm. Tên miền liệt kê người dùng và nhóm của thư mục. Họ hiện trong quản trị web được đánh dấu là người dùng thư mục và chỉ đọc ở đó: bạn sửa trong thư mục, không sửa trong WisMail. Máy chủ làm mới dữ liệu thư mục định kỳ và làm lại khi bạn đổi thiết lập.
  • Máy chủ thư mục dự phòng được dùng khi máy chủ chính không phản hồi.

Người dùng bạn tạo cục bộ trong cùng tên miền vẫn hoạt động như cũ.

Trước khi bắt đầu

  • Tên miền thư đã có trong WisMail (xem hướng dẫn cài đặt).
  • Bạn có tên máy chủ thư mục và cổng truy cập được từ máy chủ WisMail (389 cho LDAP, 636 cho LDAPS).
  • Bạn có tài khoản bind: một người dùng thư mục chỉ đọc có quyền tìm kiếm người dùng và nhóm. Không dùng tài khoản quản trị.
  • Bạn biết hậu tố tìm kiếm (base DN), ví dụ dc=example,dc=com. Với Active Directory cần tên miền AD.

Bước 1. Mở thiết lập thư mục của tên miền

Cài đặt tên miền trong quản trị web, thẻ Directory Service: máy chủ, tài khoản bind và Test Connection

Đăng nhập quản trị web, mở Cấu hình, Tên miền, sửa tên miền và mở thẻ Dịch vụ thư mục.

Bước 2. Bật ánh xạ và chọn loại

  1. Đánh dấu Ánh xạ tài khoản người dùng và nhóm từ một dịch vụ thư mục vào tên miền này.
  2. Ở Loại dịch vụ thư mục chọn Microsoft Active Directory hoặc custom LDAP server (cho OpenLDAP và tương tự).

Bước 3. Kết nối và tài khoản bind

Trong Máy chủ thư mục (domain controller):

  1. Tên máy: tên hoặc IP máy chủ thư mục.
  2. Tên đăng nhập và Mật khẩu: tài khoản bind.
  3. Đánh dấu Kết nối bảo mật (LDAPS) nếu máy chủ hỗ trợ LDAPS. Việc này mã hóa lưu lượng. Hãy giữ lưu lượng thư mục trong mạng bạn tin cậy: kết nối không xác minh chứng chỉ của máy chủ thư mục.
  4. Có thể nhập tên Máy chủ thư mục phụ (dự phòng).

Bước 4. Hậu tố tìm kiếm hoặc tên miền AD

  • Với custom LDAP server, nhập Hậu tố tìm kiếm, ví dụ ou=people,dc=example,dc=com.
  • Với Active Directory, nhập Tên miền Microsoft Active Directory; đánh dấu Khác với tên miền thư này khi nó khác tên miền thư của bạn (ví dụ corp.example.com).

Bước 5. Kiểm tra rồi áp dụng

Bấm Kiểm tra kết nối. Kết quả cho biết máy chủ chính và máy chủ phụ có phản hồi không. Sửa lỗi nếu có rồi bấm Áp dụng.

Bước 6. Kiểm tra người dùng

Mở Tài khoản, Người dùng và chọn tên miền: người dùng thư mục phải được liệt kê với biểu tượng thư mục. Đăng nhập webmail bằng một người dùng đó với mật khẩu thư mục. Mật khẩu sai và mật khẩu rỗng bị từ chối. Thông báo như Can't contact LDAP server hoặc Invalid username or password xuất hiện trong nhật ký Bảo mật.

Ánh xạ thuộc tính tùy chỉnh

Ánh xạ cho WisMail biết thuộc tính thư mục nào cấp cho trường nào (tên đăng nhập, họ tên, địa chỉ email, nhóm). Các tệp ánh xạ dựng sẵn cho vài loại thư mục được cài trong /opt/wismail/ldapmap/ (ví dụ openldap.map, ads.map). Đó là tệp XML. Nếu lược đồ của bạn dùng tên thuộc tính khác, sao chép tệp gần nhất, đổi tên thuộc tính và thử trước trên một tên miền không phải sản xuất. Chúng tôi chỉ kiểm chứng bản đồ tùy chỉnh với OpenLDAP. Nhóm ánh xạ từ thư mục cũng chỉ đọc như người dùng.

Xử lý sự cố

Kiểm tra kết nối lỗi. Kiểm tra tên máy chủ phân giải được từ máy chủ WisMail và cổng mở ở cả hai tường lửa: nc -vz ldap.example.com 389 (hoặc 636).

Không thấy người dùng. Hậu tố tìm kiếm sai, hoặc tài khoản bind không đọc được nhánh đó. Thử cùng truy vấn bằng ldapsearch từ máy chủ WisMail.

Người dùng không đăng nhập được. Xem nhật ký Bảo mật để biết lý do. Nhớ rằng mật khẩu thư mục mới là mật khẩu có hiệu lực, và tài khoản bị tắt trong thư mục thì không đăng nhập được.

Máy chủ thư mục chính ngừng hoạt động. Nếu đã cấu hình máy chủ phụ, đăng nhập sẽ dùng nó.

Bước tiếp theo