Ghép nối ứng dụng máy tính với tài khoản của bạn

Tổng quan

Để ứng dụng Whisperer dành cho macOS hoạt động với các phiên, gói đăng ký và cơ sở tri thức của bạn, bạn cần ghép nối nó với tài khoản của mình một lần. Việc chỉ cài đặt ứng dụng thôi không cấp quyền truy cập — thiết bị cần được cấp quyền (xác thực thiết bị).

Việc ghép nối được xây dựng trên luồng mã dùng một lần an toàn: ứng dụng khởi tạo quá trình đăng nhập, bạn xác thực trong trình duyệt, nhận một mã dùng một lần, và trình duyệt đưa bạn quay lại ứng dụng. Mã này dùng một lần và tồn tại trong 30 phút.

Khi nào nên dùng

  • Ngay sau khi cài đặt ứng dụng và hoàn tất trình hướng dẫn cấp quyền.
  • Khi đăng nhập trên một máy tính mới hoặc vừa cài đặt lại.
  • Khi ứng dụng không còn nhận diện được tài khoản của bạn (bạn đã đăng xuất khỏi tất cả thiết bị, đổi mật khẩu, v.v.) và cần ghép nối lại.

Các bước thực hiện

  1. Khởi tạo đăng nhập trong ứng dụng. Mở Whisperer trên máy Mac và bắt đầu quá trình đăng nhập/ghép nối. Ứng dụng yêu cầu một mã dùng một lần từ máy chủ (POST /v1/auth/desktop/code) và mở trang web ghép nối trong trình duyệt của bạn — /app/connect.
  2. Đăng nhập vào tài khoản trong trình duyệt. Trên trang /app/connect, đăng nhập bằng e-mail và mật khẩu của bạn. Nếu bạn chưa có tài khoản — hãy đăng ký và xác nhận e-mail (xem Đăng ký và đăng nhập). Không thể đăng nhập cho đến khi e-mail của bạn được xác nhận.
  3. Xác nhận việc ghép nối thiết bị. Sau khi đăng nhập, bảng điều khiển web liên kết mã dùng một lần với tài khoản của bạn.
  4. Quay lại ứng dụng. Trình duyệt tự động chuyển hướng bạn trở lại Whisperer thông qua lược đồ whisperer://auth?code=...&state=.... Nếu xuất hiện thông báo hệ thống "Mở trong Whisperer?" — hãy xác nhận.
  5. Chờ quá trình đổi mã lấy token. Ứng dụng đổi mã dùng một lần lấy các token truy cập và lưu chúng vào kho lưu trữ an toàn (được mã hóa). Sau đó, ứng dụng đã được ghép nối với tài khoản của bạn.
  6. Kiểm tra. Hãy đảm bảo ứng dụng hiển thị tài khoản và gói của bạn. Bây giờ bạn có thể bắt đầu các phiên.

Ảnh chụp màn hình

📸 [Ảnh chụp màn hình: màn hình khởi tạo đăng nhập trong ứng dụng macOS]

📸 [Ảnh chụp màn hình: trang web /app/connect với biểu mẫu đăng nhập]

📸 [Ảnh chụp màn hình: thông báo hệ thống macOS "Mở trong Whisperer?" (lược đồ whisperer://)]

Lỗi thường gặp

  • Mã đã hết hạn. Mã dùng một lần tồn tại trong 30 phút. Nếu bạn mất nhiều thời gian hơn hoặc bị gián đoạn, việc ghép nối sẽ không hoàn tất. Cách khắc phục: quay lại ứng dụng và khởi tạo đăng nhập lại — một mã mới sẽ được cấp.
  • Trình duyệt không quay lại ứng dụng. Nếu việc chuyển hướng qua lược đồ whisperer:// không tự động kích hoạt, hãy đảm bảo Whisperer đã được cài đặt trong thư mục "Applications" và lặp lại quá trình đăng nhập. Khi xuất hiện thông báo hệ thống yêu cầu mở ứng dụng — hãy xác nhận.
  • Đăng nhập thất bại — e-mail chưa được xác nhận. Bạn không thể đăng nhập cho đến khi e-mail của bạn được xác nhận bằng mã 6 chữ số. Hãy xác nhận e-mail và thử lại.
  • Nhiều tab /app/connect. Mở cùng lúc nhiều trang ghép nối sẽ làm hỏng luồng. Hãy đóng các tab thừa và chạy lại việc ghép nối từ ứng dụng.
  • Tài khoản bị đóng băng hoặc bị cấm. Nếu trạng thái tài khoản là frozen/banned, việc ghép nối sẽ không hoàn tất — hãy liên hệ bộ phận hỗ trợ.

Thực hành tốt nhất

  • Hãy thực hiện ghép nối ngay sau khi cài đặt, không trì hoãn — như vậy bạn sẽ thoải mái nằm trong khoảng thời gian sống 30 phút của mã.
  • Chỉ giữ trang /app/connect mở trong một tab duy nhất.
  • Nếu bạn đã đổi mật khẩu hoặc đăng xuất khỏi tất cả thiết bị, hãy ghép nối lại ứng dụng — các token cũ đã bị vô hiệu hóa (token_version).
  • Không tự truyền mã dùng một lần và không chia sẻ liên kết whisperer://auth?... — đó là bí mật dành cho thiết bị của bạn.

Bài viết liên quan