Quản lý chính sách mật khẩu LDAP mặc định để quản lý API

Hệ thống Apigee sử dụng OpenLDAP để xác thực người dùng trong môi trường quản lý API. OpenLDAP cung cấp chức năng chính sách mật khẩu LDAP này.

Phần này mô tả cách định cấu hình chính sách mật khẩu LDAP mặc định đã phân phối. Sử dụng chính sách mật khẩu này để định cấu hình nhiều tuỳ chọn xác thực mật khẩu, chẳng hạn như số lần đăng nhập không thành công liên tiếp sau đó mật khẩu không thể được dùng để xác thực người dùng vào thư mục nữa.

Phần này cũng mô tả cách sử dụng một số API để mở khoá các tài khoản người dùng đã bị khoá theo các thuộc tính được định cấu hình trong chính sách mật khẩu mặc định.

Để biết thêm thông tin, hãy xem:

Định cấu hình mật khẩu LDAP mặc định Chính sách

Cách định cấu hình chính sách mật khẩu LDAP mặc định:

  1. Kết nối với máy chủ LDAP bằng một ứng dụng LDAP, chẳng hạn như Apache Studio hoặc ldapmodify. Theo mặc định, máy chủ OpenLDAP sẽ nghe trên cổng 10389 trên nút OpenLDAP.

    Để kết nối, hãy chỉ định Liên kết DN hoặc người dùng của cn=manager,dc=apigee,dc=com và Mật khẩu OpenLDAP mà bạn đã đặt tại thời điểm cài đặt Edge.

  2. Sử dụng ứng dụng để chuyển đến các thuộc tính chính sách mật khẩu cho:
    • Người dùng phiên bản Edge: cn=default,ou=pwpolicies,dc=apigee,dc=com
    • Quản trị viên hệ thống Edge: cn=sysadmin,ou=pwpolicies,dc=apigee,dc=com
  3. Chỉnh sửa các giá trị thuộc tính của chính sách mật khẩu như mong muốn.
  4. Lưu cấu hình.

Thuộc tính mặc định của chính sách mật khẩu LDAP

Thuộc tính Mô tả Mặc định
pwdExpireWarning
Số giây tối đa trước khi một mật khẩu hết hạn tin nhắn cảnh báo sẽ được trả lại cho người dùng đang xác thực vào thư mục.

604800

(Tương đương với 7 ngày)

pwdFailureCountInterval

Số giây sau khi các lần liên kết không thành công cũ bị xóa khỏi bộ đếm lỗi.

Nói cách khác, đây là số giây sau đó số lần đăng nhập liên tiếp không thành công sẽ được đặt lại.

Nếu pwdFailureCountInterval được đặt thành 0, thì chỉ quá trình xác thực thành công mới có thể đặt lại bộ đếm.

Nếu bạn đặt pwdFailureCountInterval thành >0, thuộc tính này xác định khoảng thời gian mà sau đó số lần đăng nhập không thành công liên tiếp các lượt xác thực sẽ tự động được đặt lại, ngay cả khi không có xác thực thành công nào xảy ra.

Bạn nên đặt thuộc tính này thành cùng một giá trị với thuộc tính pwdLockoutDuration.

300
pwdInHistory

Số mật khẩu tối đa đã sử dụng hoặc trước đây mà một người dùng đã sử dụng sẽ được lưu trữ trong Thuộc tính pwdHistory.

Khi thay đổi mật khẩu, người dùng sẽ không được thay đổi thành bất kỳ mật khẩu nào mật khẩu trước đây.

3
pwdLockout

Nếu là TRUE, hãy chỉ định khoá người dùng khi mật khẩu của họ hết hạn để người dùng không thể đăng nhập được nữa.

Sai
pwdLockoutDuration

Số giây mà mật khẩu không thể được dùng để xác thực người dùng do quá nhiều lần đăng nhập không thành công liên tiếp.

Nói cách khác, đây là khoảng thời gian mà tài khoản người dùng sẽ ở trạng thái bị khoá do vượt quá số lần đăng nhập không thành công liên tiếp do Thuộc tính pwdMaxFailure.

Nếu bạn đặt pwdLockoutDuration thành 0, tài khoản người dùng sẽ vẫn bị khoá cho đến khi quản trị viên hệ thống mở khoá.

Xem bài viết Mở khoá tài khoản người dùng.

Nếu pwdLockoutDuration được đặt thành >0, thuộc tính này xác định khoảng thời gian tài khoản người dùng sẽ được lưu giữ đã khoá. Khi khoảng thời gian này kết thúc, tài khoản người dùng sẽ tự động được mở khoá.

Chúng tôi đề xuất rằng thuộc tính này nên được đặt thành cùng một giá trị với Thuộc tính pwdFailureCountInterval.

300
pwdMaxAge

Số giây sau khi mật khẩu của người dùng (không phải quản trị viên hệ thống) hết hạn. Giá trị 0 có nghĩa là mật khẩu không hết hạn. Giá trị mặc định là 2592000 tương ứng với 30 ngày từ thời gian mật khẩu được tạo.

user: 2592000

quản trị viên hệ thống: 0

pwdMaxFailure

Số lần đăng nhập không thành công liên tiếp sau đó mật khẩu có thể không được dùng để xác thực người dùng vào thư mục.

3
pwdMinLength

Chỉ định số lượng ký tự tối thiểu cần thiết khi đặt mật khẩu.

8

Mở khoá tài khoản người dùng

Tài khoản của người dùng có thể bị khoá do các thuộc tính được đặt trong chính sách mật khẩu. Người dùng có vai trò Apigee của quản trị viên hệ thống được chỉ định có thể sử dụng lệnh gọi API sau đây để mở khoá tài khoản. Thay thế userEmail, adminEmailpassword bằng giá trị thực tế giá trị.

Cách mở khoá người dùng:

/v1/users/userEmail/status?action=unlock -X POST -u adminEmail:password