KB: Đăng nhập SSO qua SAML không thành công với lỗi "Tên người dùng hoặc mật khẩu không hợp lệ"

Chi tiết giải pháp

Kiểm tra kết nối thành công nhưng đăng nhập thất bại

Cấu hình SAML có thể có vẻ đang hoạt động chính xác vì SAML Connection Test hoàn tất thành công và hiển thị thông báo tương tự như sau:

Connection Test Successful
You would have been signed in as username@domain.com

Tuy nhiên, khi người dùng thử đăng nhập qua SSO:

1. Quá trình xác thực tại Nhà cung cấp danh tính thành công.
2. Người dùng được chuyển hướng trở lại Enterprise Server.
3. Enterprise Server hiển thị lỗi sau:

"Our system hit a snag, please try again in a moment.
Invalid UserName/Password combination"

Tên người dùng phải khớp chính xác

Enterprise Server sử dụng tên người dùng do Nhà cung cấp danh tính cung cấp để tìm và ánh xạ người dùng tới một tài khoản Enterprise Server hiện có.

Tên người dùng do IdP trả về phải khớp chính xác với giá trị được cấu hình trong trường Username của người dùng trên Enterprise Server.

Ví dụ: nếu Kiểm tra kết nối SAML báo cáo:

username@domain.com

nhưng tài khoản Enterprise Server được cấu hình là:

username

hoặc:

Username@domain.com

thì quá trình đăng nhập SSO có thể thất bại vì các giá trị không khớp chính xác.

Important: Việc so sánh tên người dùng case-sensitive. Các giá trị sau được coi là khác nhau:

username@domain.com
Username@domain.com

Cơ chế ánh xạ tên người dùng này không phụ thuộc vào loại xác thực của người dùng và áp dụng cho cả:

• Xác thực tích hợp
• Xác thực Windows

Xác nhận tên người dùng do Nhà cung cấp danh tính trả về

• Chạy SAML Connection Test để xác định tên người dùng do Nhà cung cấp danh tính trả về.
• So sánh tên người dùng được trả về với trường Username của người dùng trên Enterprise Server.
• Đảm bảo cách viết, định dạng email và chữ hoa/chữ thường đều giống hệt nhau.
• Cập nhật tên người dùng trên Enterprise Server nếu cần.
• Nếu sự cố vẫn tiếp diễn sau khi đã xác nhận các giá trị khớp chính xác, hãy xem nhật ký UnifiedLogin để biết thêm chi tiết. Các nhật ký này nằm tại đường dẫn sau:
  C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin

Kiểm tra và sửa ánh xạ tên người dùng

1. Mở giao diện web của Enterprise Server.
2. Đi đến Admin » Settings » Authentication.
3. Mở nhà cung cấp xác thực SAML đã được cấu hình.
4. Chạy Connection Test.
5. Hoàn tất quá trình xác thực với Nhà cung cấp danh tính.
6. Ghi lại tên người dùng được báo cáo trong kết quả kiểm tra.
7. Đi đến Admin » Users.
8. Mở tài khoản người dùng tương ứng.
9. Đảm bảo trường Username khớp chính xác với giá trị do Kiểm tra kết nối SAML trả về, bao gồm cả chữ hoa/chữ thường.
10. Lưu các thay đổi cần thiết.
11. Thử đăng nhập SSO lại.

Lưu ý bổ sung

• Việc ánh xạ người dùng SSO được thực hiện bằng trường Username trên Enterprise Server.
• Cơ chế này áp dụng bất kể tài khoản sử dụng xác thực Built-In hay Windows.
• Việc đối chiếu tên người dùng case-sensitive.
• Nếu cần khắc phục sự cố thêm, hãy xem nhật ký UnifiedLogin tại:
  C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
• Nhật ký UnifiedLogin có thể cung cấp thông tin chi tiết về thông tin danh tính nhận được từ IdP, việc ánh xạ người dùng và các lỗi xử lý xác thực.
• Kết quả mong đợi: sau khi tên người dùng trên Enterprise Server khớp chính xác với tên người dùng do Nhà cung cấp danh tính cung cấp, người dùng được ánh xạ thành công tới tài khoản hiện có, quá trình xác thực SSO hoàn tất thành công và lỗi không còn xảy ra.

Tài liệu tham khảo

• Cấu hình xác thực đăng nhập một lần