Swipeguide: Đăng nhập một lần (SSO)

Last updated: June 19, 2026

Sử dụng chung​

Chúng tôi cung cấp tính năng tích hợp xác thực OAuth2 cho nền tảng, có thể được sử dụng để đăng nhập vào Web CMS, Web Frontline App, các ứng dụng SwipeGuide Native (iOS và Android) để truy cập ngoại tuyến và ứng dụng Kỹ năng thông minh.

Điều này cho phép người dùng của bạn xác thực thông qua nhà cung cấp OAuth2 do công ty bạn duy trì.

Xin lưu ý rằng các cấp độ phân quyền trong nền tảng vẫn được quản lý bên trong nền tảng để duy trì một hệ thống thân thiện với người dùng và dễ hiểu.

Chúng tôi cung cấp sự linh hoạt trong việc cấu hình các phương thức đăng nhập khác nhau trên CMS và các ứng dụng Frontline, tùy thuộc vào nhu cầu của Workspace, chẳng hạn như email và mật khẩu, cũng như SSO. Ngoài ra, bạn có thể yêu cầu người dùng của mình CHỈ đăng nhập bằng SSO.

Nếu bạn muốn bật tính năng này trên nền tảng của mình, vui lòng liên hệ với Bộ phận hỗ trợ SwipeGuide trước khi sử dụng tài liệu này.

Điều kiện tiên quyết​

  1. Nền tảng của bạn phải được bật sẵn các tùy chọn đăng nhập (thay vì là một nền tảng công khai).
  2. Nhà cung cấp OAuth2 mà bạn muốn sử dụng để đăng nhập vào SwipeGuide phải được đội ngũ CNTT của bạn quản lý và thiết lập sẵn với thông tin xác thực hoặc chứng chỉ hợp lệ. SwipeGuide cũng phải được thêm vào dưới dạng một trong các ứng dụng trong hệ thống của bạn.

Thiết lập OAuth2​

Để xem tài liệu cơ bản, vui lòng tham khảo trang web OAuth. Để thiết lập nền tảng của bạn, có một số thông tin cần được gửi đến dịch vụ xác thực OAuth2 của bạn và có một số thông tin chúng tôi cần để kết nối các dịch vụ. Chúng tôi có một URL callback cần được thiết lập trong dịch vụ xác thực OAuth2 và chúng tôi sẽ cần một số mã thông báo ủy quyền OAuth2 từ dịch vụ. Các thông tin này sẽ khác nhau tùy theo từng dịch vụ.

Hiện tại, chúng tôi hỗ trợ sẵn:

  • Microsoft Entra ID (Trước đây là Azure AD)
  • Google

Microsoft Entra ID​

Để thiết lập Microsoft Entra ID (trước đây là Azure AD) hoạt động, chúng tôi cần: clientID, clientSecret, resource và tenant. Vui lòng tìm hiểu thêm về các thông tin này trong tài liệu OAuth dành cho Azure Entra ID.

URL callback

https://[platform].swipeguide.com/sso/azureadoauth2/callback

Nền tảng trong URL là tên miền chính của nền tảng cần được tham chiếu. Xin lưu ý rằng URL callback này sẽ hoạt động cho cả nền tảng một tên miền và nhiều tên miền, đồng thời người dùng sẽ được chuyển hướng tương ứng.

Google​

Để thiết lập Google hoạt động, chúng tôi cần: clientID, clientSecret và hostedDomain. Vui lòng tìm hiểu thêm về các thông tin này trong tài liệu OAuth dành cho Google.

URL callback

https://[platform].swipeguide.com/sso/googleoauth2/callback

Nền tảng trong URL là tên miền chính của nền tảng cần được tham chiếu. Xin lưu ý rằng URL callback này sẽ hoạt động cho cả nền tảng một tên miền và nhiều tên miền, đồng thời người dùng sẽ được chuyển hướng tương ứng.

Thiết lập SAML 2.0​

Để thiết lập SAML hoạt động, chúng tôi sẽ cần tệp siêu dữ liệu của bạn hoặc:

entryPoint: URL dịch vụ SSO cert: Chứng chỉ ký công khai được sử dụng để xác thực chữ ký của các SAML Response gửi đến nếu được sử dụng.

Các claim chúng tôi cần bạn gửi: displayName, ID, Email

URL dịch vụ người tiêu dùng Assertion

https://[platform].swipeguide.com/sso/saml/consume

Metadata SAML

https://[platform].swipeguide.com/sso/saml/metadata

Entity ID: swipe-guide

Nền tảng trong URL là tên miền chính của nền tảng cần được tham chiếu. Xin lưu ý rằng URL callback này sẽ hoạt động cho cả nền tảng một miền và đa miền, đồng thời người dùng sẽ được chuyển hướng tương ứng.

Tự động hết thời gian phiên​

Là một dịch vụ và cấu hình bổ sung của nền tảng, bạn có thể yêu cầu Quản lý thành công khách hàng tự động hết thời gian phiên sau X phút không hoạt động (không có yêu cầu nào gửi đến máy chủ).

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

1. Tìm hiểu cần làm gì khi lỗi xác thực SSO hiển thị sau khi cố gắng Đăng nhập vào SwipeGuide

Bạn có thể nhận được lỗi xác thực khi Đăng nhập vào các Nền tảng SwipeGuide do khóa bí mật đã hết hạn.

Đăng nhập một lần (SSO) là một phương thức xác thực cho phép người dùng xác thực an toàn với nhiều ứng dụng và trang web bằng cách chỉ sử dụng một bộ thông tin đăng nhập.

Hiện tại, SSO là một tính năng Add-On có thể được yêu cầu bằng cách gửi yêu cầu hỗ trợ đến bộ phận Support. Bộ phận CNTT của công ty bạn cần cung cấp thông tin được yêu cầu dựa trên nhà cung cấp giải pháp mong muốn cho đội ngũ kỹ thuật SwipeGuide để thiết lập tính năng này. Chúng tôi không quản lý hoặc duy trì bất kỳ khóa nào của khách hàng.

Nếu bạn cho rằng khóa bí mật của mình đã hết hạn hoặc sắp hết hạn, vui lòng thực hiện các bước sau:

  • Thông báo cho bộ phận CNTT tại địa phương về việc này và chủ động yêu cầu cấp chứng chỉ mới
  • Liên hệ với bộ phận Support của SwipeGuide và cung cấp thông tin mới

Lưu ý: Chúng tôi đặc biệt khuyến nghị công ty bạn đặt lời nhắc 2 năm một lần để ngăn điều này khiến người dùng không thể đăng nhập và chia sẻ thông tin xác thực mới với chúng tôi.

2. Nhiều người dùng trên thiết bị dùng chung

Bạn có thể gặp tình huống như sau: "Người vận hành A và Người vận hành B sử dụng chung một thiết bị, Người vận hành A đăng xuất khỏi ỨNG DỤNG, sau đó Người vận hành B đăng nhập vào ỨNG DỤNG. Lúc này, Người vận hành B nhìn thấy Ma trận Kỹ năng của Người vận hành A."

Tại sao điều này xảy ra?

Khi người dùng đăng nhập vào ứng dụng bằng SSO, hệ thống sẽ kiểm tra xem trên thiết bị đó đã có phiên SSO đang hoạt động hay chưa. Nếu Nhân viên vận hành A đăng xuất khỏi ứng dụng nhưng không đăng xuất hoàn toàn khỏi chính tài khoản SSO của họ, người tiếp theo (Nhân viên vận hành B) sẽ tự động được nhận diện là Nhân viên vận hành A khi đăng nhập qua SSO. Đây là hành vi phổ biến ở nhiều ứng dụng sử dụng SSO hoặc các dịch vụ tương tự, vì chúng dựa vào trạng thái đăng nhập hiện tại của trình duyệt hoặc thiết bị.
 
Để đảm bảo mỗi người dùng phải nhập thông tin đăng nhập khi sử dụng thiết bị dùng chung, vui lòng thực hiện các bước sau:
1. Sau khi sử dụng ứng dụng, hãy đăng xuất khỏi ỨNG DỤNG như bình thường.
2. Đồng thời, hãy đăng xuất hoàn toàn khỏi tài khoản SSO (ví dụ: Google) trên trình duyệt hoặc thiết bị.
3. Người dùng tiếp theo có thể đăng nhập bằng thông tin đăng nhập của riêng họ.
 
Ngoài ra, để tránh việc tự động nhận diện SSO này, người dùng có thể đăng nhập bằng email và mật khẩu thay vì SSO trên các thiết bị dùng chung.