Cách cho phép người dùng đăng nhập bằng Google¶

Để cho phép mọi người đăng nhập Viindoo bằng tài khoản Google, hãy tạo ID máy khách OAuth trong Google Cloud, sau đó vào Thiết lập ‣ Thiết lập chung ‣ Tích hợp, bật Xác thực OAuth, lưu lại, tick Xác thực Google, dán ID máy khách rồi lưu lần nữa. Nút Sign in with Google sẽ hiện trên các trang đăng nhập, đăng ký và đặt lại mật khẩu.

Ai làm	Quản trị viên có quyền truy cập Thiết lập. Cần một tài khoản Google để tạo ID máy khách.
Ứng dụng	Thiết lập (Thiết lập chung). Nút hiển thị trên trang đăng nhập Viindoo.

Cần có trước

Biết địa chỉ web mà mọi người dùng để mở Viindoo, ví dụ https://mycompany.viindoo.cloud. Google chỉ chấp nhận địa chỉ chuyển hướng bắt đầu bằng https:// (ngoại lệ duy nhất là http://localhost).
Quyết định ai được đăng nhập bằng Google: xem Ai được đăng nhập bằng Google?.

Làm sao để tạo ID máy khách trong Google?¶

Phần này làm trên trang web của Google, không làm trong Viindoo. Google thỉnh thoảng đổi giao diện nên tên các mục dưới đây có thể hơi khác.

Mở Google Cloud console và tạo một dự án, hoặc chọn dự án có sẵn.
Mở Google Auth Platform. Trong Branding, nhập tên ứng dụng và email hỗ trợ. Trong Audience, chọn External (Bên ngoài) nếu người dùng có tài khoản Google thông thường, hoặc Internal (Nội bộ) nếu tất cả đều thuộc Google Workspace của công ty.
Trong Google Auth Platform ‣ Clients, bấm CREATE CLIENT và chọn loại ứng dụng Web application (Ứng dụng web).
Ở mục URI chuyển hướng được ủy quyền (Authorized redirect URIs), thêm địa chỉ Viindoo của bạn theo sau là /auth_oauth/signin, ví dụ https://mycompany.viindoo.cloud/auth_oauth/signin. Địa chỉ phải đúng y hệt địa chỉ mà người dùng gõ trên trình duyệt.
Bấm CREATE và sao chép ID máy khách (Client ID). ID này kết thúc bằng .apps.googleusercontent.com. Viindoo không yêu cầu mã bí mật của máy khách (client secret).

Nếu màn hình khác với tên các mục trên, xem hướng dẫn của chính Google: Manage OAuth clients.

Làm sao để bật đăng nhập Google trong Viindoo?¶

Vào Thiết lập ‣ Thiết lập chung và tìm Xác thực OAuth trong phần Tích hợp. Tick chọn rồi bấm Lưu. Viindoo chuẩn bị tính năng và tải lại trang.
Mở lại Thiết lập chung. Mục Xác thực Google (Cho phép người dùng đăng nhập bằng tài khoản Google của họ) giờ đã xuất hiện bên dưới. Tick chọn, rồi dán ID máy khách của Google vào ô hiện ra và bấm Lưu.
Kiểm tra kết quả: mở trang đăng nhập trong một cửa sổ ẩn danh của trình duyệt.

Giờ bạn sẽ thấy Sign in with Google bên dưới nút Đăng nhập. Bấm vào đó, chọn một tài khoản Google và Viindoo sẽ mở bằng tài khoản ấy.

Những trường nào quan trọng?¶

Trường	Tác dụng	Nếu để trống hoặc nhập sai
Xác thực OAuth	Bật đăng nhập bằng tài khoản bên ngoài và hiện mục Xác thực Google.	Không có mục Google để thiết lập.
Xác thực Google	Hiện hoặc ẩn nút Sign in with Google trên các trang đăng nhập, đăng ký và đặt lại mật khẩu.	Bỏ tick: nút biến mất và không ai đăng nhập được bằng Google.
ID máy khách	Cho Google biết ứng dụng nào đang yêu cầu người dùng đăng nhập.	Google hiện trang báo lỗi sau khi người dùng bấm nút, nên không ai đăng nhập được bằng Google. Hãy sao chép lại giá trị từ Google Cloud.

Ai được đăng nhập bằng Google?¶

Viindoo nhận biết tài khoản Google qua định danh Google trả về, không chỉ dựa vào địa chỉ email. Vì vậy lần đăng nhập đầu tiên phụ thuộc vào việc người đó đã có người dùng trong Viindoo hay chưa.

Tình huống	Điều gì xảy ra
Người chưa có người dùng trong Viindoo, và Tài khoản khách hàng đặt là Đăng ký miễn phí	Viindoo tạo một người dùng cổng thông tin từ tên và email Google, rồi đăng nhập cho người đó. Tùy chọn Tài khoản khách hàng nằm trong thiết lập của ứng dụng Website (mục Chung) và trong thiết lập của ứng dụng Bán hàng (mục Định giá).
Người chưa có người dùng trong Viindoo, và Tài khoản khách hàng đặt là Khi mời	Việc đăng nhập bị từ chối với thông báo Bạn không có quyền truy cập vào cơ sở dữ liệu này hoặc lời mời của bạn đã hết hạn. Vui lòng yêu cầu một lời mời mới và nhấp vào liên kết trong email mời của bạn.
Người đã có người dùng (ví dụ nhân viên)	Lần đầu, người đó phải mở liên kết trong email mời (hoặc email đặt lại mật khẩu) rồi bấm Sign in with Google ngay trên trang đó. Khi ấy Viindoo liên kết tài khoản Google với người dùng hiện có. Từ lần sau, nút trên trang đăng nhập thông thường dùng được. Việc đăng nhập bằng Google thẳng từ trang đăng nhập, trước khi có liên kết này, bị từ chối với thông báo ở trên.

Đăng nhập bằng Google không bao giờ biến ai đó thành nhân viên: người dùng nội bộ luôn do quản trị viên tạo hoặc mời.

Lỗi thường gặp¶

Thông báo hoặc hiện tượng	Cách xử lý
Google báo redirect_uri_mismatch sau khi bấm nút	URI chuyển hướng trong Google Cloud không đúng y hệt `<địa chỉ Viindoo của bạn>/auth_oauth/signin`. Địa chỉ phải khớp hoàn toàn, kể cả giao thức (`http` hoặc `https`), chữ hoa chữ thường và dấu gạch chéo ở cuối (nếu có). Sửa lại ở mục URI chuyển hướng được ủy quyền (Authorized redirect URIs).
Bạn không có quyền truy cập vào cơ sở dữ liệu này hoặc lời mời của bạn đã hết hạn...	Người đó chưa có người dùng và việc đăng ký đặt là Khi mời, hoặc đã có người dùng nhưng chưa được liên kết. Hãy mời người đó, hoặc gửi lại liên kết mời, và nhờ họ bấm Sign in with Google từ liên kết đó.
Truy cập bị từ chối	Viindoo không xác nhận được tài khoản Google, ví dụ do mã đăng nhập bị từ chối hoặc máy chủ Viindoo không kết nối được tới Google. Hãy thử lại; nếu vẫn lỗi, nhờ quản trị hệ thống kiểm tra kết nối internet của máy chủ.
Trang đăng nhập không có nút	Kiểm tra mục Xác thực Google đã được tick và lưu, rồi tải lại trang.

Bước tiếp theo¶

Cách phân quyền người dùng theo nhóm quyền: quyết định mỗi người dùng được làm gì sau khi đăng nhập.
Cách cài đặt, nâng cấp và gỡ cài đặt ứng dụng, phân hệ: cài các ứng dụng khác mà người dùng cần.