Quản lý trạng thái xác thực
Xác thực là một khía cạnh quan trọng trong kiểm thử và phát triển API. Việc quản lý đúng trạng thái xác thực bảo đảm rằng các yêu cầu API của bạn an toàn, hiệu quả và phản ánh chính xác các tình huống sử dụng trong thực tế.Hướng dẫn này trình bày cách xử lý hiệu quả trạng thái xác thực trong Apidog, bao gồm các phương thức xác thực phổ biến và triển khai đăng nhập tự động.Các phương thức xác thực phổ biến#
1. Xác thực Session/Cookie#
Apidog tự động duy trì trạng thái xác thực thông qua session và cookie.Khi thực thi API đăng nhập, Apidog lưu thông tin Session/Cookie được trả về ở phạm vi toàn cục
Các lệnh gọi API tiếp theo tự động bao gồm thông tin Session/Cookie này
Không cần cấu hình thủ công cho từng yêu cầu
2. Xác thực dựa trên token#
Xác thực dựa trên token liên quan đến việc đưa thông tin đăng nhập vào các tham số yêu cầu API, thường là trong Header. Các phương pháp phổ biến bao gồm Basic Auth, Bearer Token và API Key.Tùy chọn 1: Cấu hình xác thực toàn cục#
Thiết lập thông tin xác thực ở các cấp độ khác nhau:Cấp độ dự án: Trang tổng quan dự án
Cấp độ nhóm: Cài đặt nhóm
Cấp độ API riêng lẻ: Trang tài liệu
Tùy chọn 2: Cấu hình token thủ công#
Thêm token thủ công vào Header hoặc các tham số liên quan khác. Chúng tôi khuyến nghị sử dụng biến môi trường để lưu trữ token.Bearer Token: Đặt một Header có tên Authorization với giá trị Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9yJpZCI6
Sử dụng biến môi trường: Bearer {{AUTH_TOKEN}}
Tùy chọn 3: Tham số toàn cục#
Thiết lập giá trị trong các tham số toàn cục. Tất cả API sẽ tự động bao gồm các tham số toàn cục trong thời gian chạy, loại bỏ nhu cầu cấu hình thủ công cho từng API.3. Phương thức đăng nhập tự động#
Phương thức này tự động gọi API đăng nhập để hoàn tất xác thực mà không cần can thiệp thủ công, đồng thời duy trì trạng thái xác thực trên các yêu cầu.Triển khai đăng nhập tự động#
Kết quả mong muốn#
1.
Tự động gọi API đăng nhập mà không cần can thiệp thủ công
2.
Duy trì trạng thái xác thực sau khi đăng nhập thành công để tránh các lệnh gọi API đăng nhập dư thừa
3.
Làm mới token khi thông tin xác thực hết hạn
Các bước triển khai#
Bước 1: Thiết lập biến môi trườngSử dụng biến môi trường để lưu trữ thông tin xác thực:ACCESS_TOKEN: Lưu trữ thông tin đăng nhập
ACCESS_TOKEN_EXPIRES: Lưu trữ thời gian hết hạn (nếu có)
1.
Kiểm tra xem ACCESS_TOKEN có giá trị hay không và ACCESS_TOKEN_EXPIRES có còn hợp lệ hay khôngNếu hợp lệ, tiếp tục với yêu cầu
Nếu không hợp lệ hoặc bị thiếu, tiếp tục sang bước tiếp theo
2.
Sử dụng pm.sendRequest để gọi API đăng nhập
3.
Ghi thông tin xác thực được trả về và thời gian hết hạn vào biến môi trường
1.
Thiết lập tham số xác thực thành {{ACCESS_TOKEN}}Đặt header Authorization thành {{ACCESS_TOKEN}}
Hoặc sử dụng cookie/các tham số khác khi cần
Ngoài ra, thiết lập giá trị trong các tham số toàn cục để tự động bao gồm trong tất cả các lệnh gọi API
2.
Tham chiếu script công khai trong script tiền xử lý
Ví dụ về script công khai#
Thông tin đăng nhập trong script này được lấy từ các biến môi trường LOGIN_USERNAME và LOGIN_PASSWORD. Hãy bảo đảm các biến này đã được thiết lập trước khi sử dụng mã này.
Nếu token của bạn không hết hạn, hãy xóa mã liên quan đến ACCESS_TOKEN_EXPIRES.
Điều chỉnh cấu trúc yêu cầu đăng nhập và cách xử lý phản hồi theo các yêu cầu API cụ thể của bạn.
Tài nguyên bổ sung#
Modified at 2026-06-11 10:23:06
