Quản lý dữ liệu OAuth khi đọc thư và kết thúc phiên

Token không phải dữ liệu công khai

Refresh token cho phép ứng dụng xin quyền truy cập theo phạm vi được cấp. Đừng đưa token vào lịch sử tên hoặc bài viết minh họa. Bộ đọc hiện tại không chủ động lưu thông tin kết nối, nhưng nội dung nhập vẫn nằm trong biểu mẫu trong lúc dùng. Chỉ đọc tài khoản bạn có quyền truy cập.

Xóa phiên và hiểu giới hạn

Nút Xóa thông tin và thư làm trống đầu vào cùng kết quả, không thu hồi quyền ứng dụng trên Microsoft. Nếu muốn thu hồi quyền, dùng phần quản lý của tài khoản Microsoft. Việc dừng server cũng không thu hồi token. Những thao tác này có mục tiêu khác nhau và cần được phân biệt rõ.

Chuẩn bị đúng thông tin kết nối hộp thư

Bộ đọc nhận một tài khoản mỗi lần theo dạng Email|Pass|RefreshToken|ClientID. Mật khẩu được chấp nhận trong định dạng nguồn nhưng không được dùng để đăng nhập trực tiếp. Dịch vụ cục bộ xin access token từ Microsoft bằng refresh token và Client ID. Bạn cần quyền truy cập tài khoản cùng phạm vi ứng dụng đã được cấp. Token trông dài hoặc có đúng số trường chưa chứng minh xác thực sẽ thành công. Khi sao chép từ nguồn, giữ nguyên dữ liệu và không thay Client ID bằng định danh của ứng dụng khác chỉ vì thấy nó trong một ví dụ hướng dẫn.

Mở trang qua dịch vụ chạy trên máy

Đọc thư cần bộ xử lý phía máy, nên chạy mo-doc-mail.cmd và dùng địa chỉ localhost do cửa sổ server thông báo. Trang mở bằng đường dẫn file có thể hiển thị giao diện nhưng không đủ để gọi bộ đọc thư. Cổng có thể thay đổi nếu phiên trước đang sử dụng cổng mặc định. Dùng trang tự mở hoặc kiểm tra địa chỉ của phiên mới thay vì truy cập một đường dẫn cũ. Khi mã server được cập nhật, cần khởi động lại dịch vụ; làm mới trình duyệt chỉ tải lại phần giao diện và không thay mã Python của tiến trình đang chạy.

Chọn phương thức theo quyền đang có

Microsoft Graph API và OAuth2 qua IMAP là hai cách kết nối khác nhau. Graph lấy thư bằng yêu cầu HTTPS, còn IMAP dùng kết nối hộp thư để tìm và đọc nội dung. Quyền của token phải phù hợp với phương thức; có quyền ở cách này không đảm bảo có quyền ở cách kia. Giao diện cho phép chọn và hiển thị phương thức đang dùng để bạn theo dõi. Nếu không biết phạm vi token, kiểm tra nguồn cấp hoặc quy trình đồng ý của ứng dụng. Không thể suy ra quyền chỉ từ email, mật khẩu hay hình thức của chuỗi refresh token.

Theo dõi tiến trình và phân biệt thông báo

Sau khi bấm đọc, nút bị vô hiệu trong lúc chờ và dòng trạng thái cho biết đang kết nối theo phương thức nào. Thành công sẽ hiện số thư trả về cùng các thẻ nội dung. Nếu lỗi, đọc mô tả trước khi đổi dữ liệu. Từ chối xác thực thường liên quan token hoặc quyền; không kết nối được thường liên quan mạng, proxy, tường lửa hoặc thời gian chờ. Đây là các nhóm nguyên nhân khác nhau. Đừng sửa mật khẩu trong nguồn để xử lý lỗi mạng, vì mật khẩu không tham gia luồng OAuth của bộ đọc hiện tại.

Dùng nút chuyển phương thức khi cần

Khi yêu cầu thất bại, giao diện đưa ra nút chuyển sang phương thức còn lại và đọc lại. Nút này giúp thử một lựa chọn có thể phù hợp hơn, không hứa sửa được mọi lỗi. Nếu Graph hoạt động còn IMAP thất bại, có thể dùng Graph để đọc thư trong phiên; việc đó không tự sửa quyền IMAP. Nếu cả hai thất bại, kiểm tra token, Client ID và mạng thay vì thử liên tục. Một yêu cầu bị hủy hoặc quá thời gian cũng cần xem xét kết nối trước khi kết luận rằng hộp thư không tồn tại hoặc không có thư.

Đọc đúng phạm vi của danh sách kết quả

Phiên bản hiện tại lấy tối đa mười lăm thư mới nhất trong hộp thư đến. Nó không bao gồm mọi thư mục và không tải toàn bộ lịch sử. Nếu tài khoản chỉ có ba thư trong phạm vi này, ba thẻ có thể là kết quả đúng. Nếu thư cần tìm nằm trong thư rác hoặc thư mục riêng, hãy xem bằng giao diện hộp thư chính thức. Công cụ không tự gửi yêu cầu tạo mã cho dịch vụ khác. Bạn cần thực hiện yêu cầu xác minh ở dịch vụ đó, chờ thư mới tới rồi đọc lại để kiểm tra thời gian và nội dung.

Đối chiếu mã với nội dung của thư

Bộ tìm số hiện tại có thể đưa ra các dãy bốn đến tám chữ số hoặc dạng ba số nối ba số làm gợi ý sao chép. Không phải mọi dãy đều là mã xác minh: năm, số tham chiếu hoặc phần địa chỉ mạng cũng có thể bị nhận diện. Mở Xem nội dung thư để đọc câu yêu cầu dùng mã và đối chiếu tiêu đề. Chọn đúng thư gắn với phiên xác minh hiện tại; mã trong thư cũ có thể không còn được chấp nhận. Nút sao chép chỉ đưa số vào clipboard, không xác nhận hiệu lực và không tự đăng nhập.

Nội dung văn bản và giới hạn hiển thị

Thẻ thư hiển thị tiêu đề, người gửi, thời gian và nội dung dạng văn bản. Những hình ảnh, nút định dạng hoặc bố cục HTML có thể không giống giao diện Outlook vì trang không dựng trực tiếp HTML từ người gửi. Cách hiển thị này phục vụ đọc và đối chiếu, không thay thế ứng dụng thư đầy đủ. Địa chỉ người gửi hoặc tiêu đề quen thuộc chưa đủ chứng minh thư đáng tin; bộ đọc không có chức năng đánh giá giả mạo. Khi cần xử lý liên kết, tệp đính kèm hoặc thư mục khác, dùng công cụ phù hợp và kiểm tra mục đích riêng.

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

Có cần kiểm tra lại dữ liệu sau mỗi lần thay đổi không?

Có. Khi thay đổi đầu vào, hãy kiểm tra trạng thái và kết quả mới trước khi dùng. Đừng dựa vào kết quả của phiên trước để xác nhận cho nguồn vừa chỉnh. Với thao tác sao chép, đối chiếu thông báo thành công cùng nội dung bạn định chuyển. Nếu xảy ra lỗi, đọc mô tả ngay tại công cụ và xử lý đúng phần bị báo. Dữ liệu ví dụ trong bài chỉ để thực hành, không dùng để đăng nhập hoặc thử kết nối một hộp thư thật.

Làm sao biết đã hoàn tất đúng mục tiêu của bài?

Hãy xác nhận bạn đã hiểu vấn đề được nêu ở hai phần đầu, thực hiện bước phù hợp trong công cụ và kiểm tra giới hạn của kết quả. Một mã đã xuất hiện, một thẻ đã tách hoặc một danh sách thư đã tải là kết quả của chức năng tương ứng, không chứng minh tất cả dữ liệu nguồn đúng. Nếu mục đích tiếp theo là xác minh ở một dịch vụ khác, cần thực hiện bước đó riêng. Sau cùng, xóa dữ liệu trong trang khi không còn dùng và kiểm tra nơi đã sao chép.