Apidog Docs
🇻🇳 Tiếng Việt
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇻🇳 Tiếng Việt
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇻🇳 Tiếng Việt
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
Learning Center
HomeSupport CenterAPI ReferencesDownloadChangelog
Learning Center
HomeSupport CenterAPI ReferencesDownloadChangelog
  1. Lược đồ bảo mật
  • Trung tâm Học tập Apidog
  • Bắt đầu
    • Giới thiệu về Apidog
    • Các khái niệm cơ bản trong Apidog
    • Điều hướng Apidog
    • Bắt đầu nhanh
      • Tổng quan
      • Tạo một Endpoint
      • Tạo yêu cầu
      • Thêm một khẳng định
      • Tạo kịch bản kiểm thử
      • Chia sẻ tài liệu API
      • Khám phá thêm
    • Di chuyển sang Apidog
      • Tổng quan
      • Nhập thủ công
      • Nhập theo lịch (Liên kết nguồn dữ liệu)
      • Tùy chọn nhập
      • Xuất dữ liệu
      • Nhập từ
        • Nhập từ Postman
        • Nhập OpenAPI Spec
        • Nhập cURL
        • Nhập Markdown
        • Nhập từ Insomnia
        • Nhập từ apiDoc
        • Nhập tệp .har
        • Nhập WSDL
  • Dữ liệu API mock
    • Tổng quan
    • Smart Mock
    • Mock tùy chỉnh
    • Trình tự ưu tiên Mock
    • Mock Scripts
    • Cloud Mock
    • Self-Hosted Runner Mock
    • Ngôn ngữ Mock (Locales)
  • Tài khoản và tùy chọn
    • Cài đặt tài khoản
    • Tạo Token truy cập OpenAPI
    • Thông báo
    • Cài đặt ngôn ngữ
    • Phím tắt
    • Cấu hình Proxy Mạng
    • Sao lưu dữ liệu
    • Cập nhật Apidog
    • Xóa tài khoản
    • Tính năng thử nghiệm
  • Gửi yêu cầu
    • Tổng quan
    • Gỡ lỗi SSE
    • MCP Client
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP hoặc WebService
    • GraphQL
    • gRPC
    • Sử dụng Tác nhân Proxy Yêu cầu để Gỡ lỗi
    • Tạo yêu cầu
      • Lịch sử yêu cầu
      • Cơ bản về yêu cầu
      • Tham số và Body
      • Header của yêu cầu
      • Cài đặt yêu cầu
      • Gỡ lỗi yêu cầu
      • Lưu yêu cầu dưới dạng Endpoint
      • HTTP/2
    • Xác thực và phân quyền
      • Tổng quan
      • Chứng chỉ CA và Chứng chỉ Client
      • Các loại ủy quyền
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Xác thực Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Phản hồi và cookie
      • Xem phản hồi API
      • Quản lý Cookie
      • Tổng quan
  • Phát triển và gỡ lỗi API
    • Tổng quan
    • Tạo yêu cầu
    • Gửi yêu cầu
    • Trường hợp gỡ lỗi
    • Trường hợp kiểm thử
    • Giá trị động
    • Xác thực phản hồi
    • Design-First vs Request-First
    • Tạo mã
    • Môi trường và biến
      • Tổng quan
      • Sử dụng biến
      • Quản lý môi trường
    • Bí mật trong vault
      • Tổng quan
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Mô-đun giá trị động
      • Hãng hàng không
      • Animal
      • Màu sắc
      • Commerce
      • Company
      • Cơ sở dữ liệu
      • Kiểu dữ liệu
      • Ngày
      • Finance
      • Food
      • Git
      • Hacker
      • Helpers
      • Hình ảnh
      • Internet
      • Vị trí
      • Lorem
      • Music
      • Number
      • Person
      • Phone
      • Science
      • String
      • Hệ thống
      • Vehicle
      • Từ
    • Bộ xử lý trước và sau
      • Tổng quan
      • Khẳng định
      • Trích xuất biến
      • Chờ
      • Bảo mật
      • Thao tác cơ sở dữ liệu
        • Tổng quan
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • Sử dụng script
        • Tổng quan
        • Script tiền xử lý
        • Tập lệnh hậu xử lý
        • Public Scripts
        • Tài liệu tham khảo về Postman Scripts
        • Gọi các ngôn ngữ lập trình khác
        • Sử dụng thư viện JS
        • Trực quan hóa phản hồi
        • Ví dụ script
          • Tập lệnh khẳng định
          • Sử dụng biến
          • Sửa đổi yêu cầu
          • Các ví dụ khác
    • Gỡ lỗi API
      • AI Agent Debugger
      • A2A Debugger
  • Thiết kế API
    • Tổng quan
    • Tạo một dự án API mới
    • Kiến thức cơ bản về Endpoint
    • Hướng dẫn thiết kế API
    • Mô-đun
    • Cấu hình nhiều ví dụ về body của yêu cầu
    • Thành phần
    • Trường Chung
    • Tham số toàn cục
    • Lịch sử thay đổi endpoint
    • Bình luận
    • Quản lý Endpoint Hàng loạt
    • Custom Protocol API
    • Chế độ Spec-first (Beta)
    • Lược đồ bảo mật
      • Tổng quan
      • Tạo Security Scheme
      • Sử dụng Lược đồ bảo mật
      • Lược đồ bảo mật trong tài liệu trực tuyến
    • Tính năng nâng cao
      • Trường Endpoint Tùy chỉnh
      • Các kịch bản kiểm thử được liên kết
      • Trạng thái Endpoint
      • Giao diện của Danh sách Tham số
      • Nhận dạng duy nhất endpoint
    • Schemas
      • Tổng quan
      • Tạo Schema Mới
      • Xây dựng Schema
      • Tạo Schema từ JSON, v.v.
      • oneOf, allOf, anyOf
      • Sử dụng Discriminator
  • Kiểm thử API
    • Tổng quan
    • Kịch bản kiểm thử
      • Tạo một kịch bản kiểm thử
      • Truyền dữ liệu giữa các yêu cầu
      • Điều kiện điều khiển luồng
      • Đồng bộ dữ liệu từ endpoint và trường hợp endpoint
      • Nhập Endpoint và Endpoint Case từ các dự án khác
      • Xuất Kịch bản Kiểm thử
    • Báo cáo kiểm thử
      • Báo cáo kiểm thử
    • Chạy kịch bản kiểm thử
      • Chạy một kịch bản kiểm thử
      • Chạy hàng loạt các kịch bản kiểm thử
      • Kiểm thử dựa trên dữ liệu
      • Dữ liệu kiểm thử dùng chung
      • Tác vụ đã lên lịch
      • Quản lý môi trường runtime của API từ các dự án khác
    • Bộ kiểm thử
      • Tổng quan
      • Tạo một bộ kiểm thử
      • Điều phối Bộ kiểm thử
      • Chạy bộ kiểm thử cục bộ
      • Chạy Bộ Kiểm Thử Qua CLI
      • Tác vụ đã lên lịch
    • Kiểm thử API
      • Kiểm thử tích hợp
      • Kiểm thử hiệu năng
      • Kiểm thử End-to-End
      • Kiểm thử hồi quy
      • Kiểm thử hợp đồng
    • Apidog CLI
      • Tổng quan
      • Cài đặt và chạy Apidog CLI
      • Tùy chọn Apidog CLI
    • CI/CD
      • Tổng quan
      • Tích hợp với Github Actions
      • Tích hợp với Gitlab
      • Tích hợp với Jenkins
      • Kích hoạt kiểm thử bằng Git Commit
  • Xuất bản tài liệu API
    • Tổng quan
    • Các công nghệ API được hỗ trợ
    • Chia sẻ nhanh
    • Xem tài liệu API
    • Tài liệu Markdown
    • Xuất bản site tài liệu
    • Trang đăng nhập tùy chỉnh
    • Bố cục tùy chỉnh
    • CSS, JavaScript, HTML tùy chỉnh
    • Tên miền tùy chỉnh
    • Tính năng AI
    • Cài đặt SEO
    • Cài đặt nâng cao
      • Tìm kiếm tài liệu
      • Proxy CORS
      • Tích hợp Google Analytics
      • Cài đặt cây thư mục
      • Cài đặt khả năng hiển thị
      • Nhúng giá trị vào URL tài liệu
    • Phiên bản API
      • Tổng quan
      • Tạo phiên bản API
      • Xuất bản các phiên bản API
      • Chia sẻ endpoint theo phiên bản API
  • Nhánh
    • Tổng quan
    • Tạo một Sprint Branch
    • Kiểm thử API trong một nhánh
    • Thiết kế API trong một nhánh
    • Hợp nhất các nhánh Sprint
    • Quản lý Nhánh Sprint
    • AI Branch (Beta)
  • Tính năng AI
    • Tổng quan
    • Bật các tính năng AI
    • Tạo Trường hợp Kiểm thử
    • Sửa đổi Schema bằng AI
    • Kiểm tra tuân thủ endpoint
    • Kiểm tra mức độ hoàn chỉnh của tài liệu API
    • Đặt tên trường bằng AI
    • Câu hỏi thường gặp
  • Máy chủ MCP Apidog
    • Tổng quan
    • Kết nối dự án Apidog với AI
    • Kết nối tài liệu đã xuất bản với AI
    • Kết nối tệp OpenAPI với AI
  • Thực hành tốt nhất
    • Xử lý chữ ký API
    • Truy cập các API được bảo vệ bằng OAuth 2.0
    • Quy trình cộng tác
    • Quản lý trạng thái xác thực
  • Không gian ngoại tuyến
    • Tổng quan
  • Apidog Europe
    • Apidog Europe
  • Quản trị
    • Quản lý dự án
      • Quản lý dự án
      • Cài đặt thông báo
      • Quản lý thành viên dự án
      • Tài nguyên dự án
        • Kết nối cơ sở dữ liệu
        • Kết nối Git
    • Quản lý nhóm
      • Quản lý nhóm
      • Quản lý thành viên nhóm
      • Hoạt động của nhóm
      • Vai trò & Quyền của Nhóm
      • Tài nguyên nhóm
        • General Runner
        • Biến nhóm
        • Request Proxy Agent
      • Cộng tác thời gian thực
        • Cộng tác nhóm
    • Danh sách kiểm tra onboarding
      • Khái niệm cơ bản
      • Hướng dẫn nhập môn
    • Quản lý tổ chức
      • Quản lý Tổ chức
      • Vai trò & Quyền trong Tổ chức
      • Quản lý gói
        • Người quản lý thanh toán trong tổ chức
      • Đăng nhập một lần (SSO)
        • Tổng quan về SSO
        • Cấu hình Microsoft Entra ID
        • Cấu hình Okta
        • Cấu hình SSO cho một tổ chức
        • Quản lý tài khoản người dùng
        • Ánh xạ Nhóm tới Đội
      • Cấp phát SCIM
        • Giới thiệu về cấp phát SCIM
        • Microsoft Entra ID
        • Okta
      • Tài nguyên tổ chức
        • Self-Hosted Runner
  • Thanh toán
    • Tổng quan
    • Credits
    • Nâng cấp gói của bạn
    • Phương thức thanh toán thay thế
    • Quản lý đăng ký
    • Chuyển các nhóm trả phí vào tổ chức
  • Tiện ích bổ sung
    • API Hub
    • Apidog Intellij IDEA Plugin
    • Tiện ích mở rộng trình duyệt
      • Chrome
      • Microsoft Edge
    • Proxy yêu cầu
      • Proxy yêu cầu trên Web
      • Proxy yêu cầu trong tài liệu được chia sẻ
      • Proxy yêu cầu trong Client
  • Dữ liệu và bảo mật
    • Lưu trữ và bảo mật dữ liệu
    • Quyền riêng tư và bảo mật dữ liệu người dùng
    • Định tuyến yêu cầu và bảo mật dữ liệu
  • Tham chiếu
    • Phương pháp tiếp cận API Design-First
    • Phần mở rộng Đặc tả OpenAPI của Apidog
    • JSONPath
    • XPath
    • Biểu thức chính quy
    • JSON Schema
    • Định dạng tệp CSV
    • Cài đặt môi trường Java
    • Môi trường triển khai Runner
    • Cú pháp Markdown của Apidog
    • Tiện ích mở rộng Swagger của Apidog
      • Tổng quan
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Tiện ích mở rộng JSON Schema của Apidog
      • Tổng quan
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Trung tâm hỗ trợ
  1. Lược đồ bảo mật

Sử dụng Lược đồ bảo mật

Cấu hình Lược đồ bảo mật ở cấp thư mục#

1
Chọn một thư mục bất kỳ, nhấp vào thẻ Auth ở bên phải và chọn Security Scheme làm loại xác thực.
Chọn loại xác thực bằng lược đồ bảo mật
2
Chọn Security Scheme mong muốn từ menu thả xuống.
Chọn lược đồ bảo mật mong muốn
3
Nếu bạn chọn OAuth 2.0 làm lược đồ bảo mật, bạn có thể tiếp tục chọn các Scopes bắt buộc.
Chọn phạm vi của lược đồ bảo mật
Các lược đồ bảo mật được cấu hình ở cấp thư mục sẽ áp dụng cho tất cả thư mục con và endpoint thuộc thư mục đó, trừ khi chúng có cấu hình xác thực riêng.

Cấu hình Lược đồ bảo mật ở cấp endpoint#

1
Chọn một endpoint bất kỳ và đi tới thẻ Edit ở bên phải. Trong phần Request, chọn Security Scheme làm loại ủy quyền.
Cấu hình lược đồ bảo mật ở cấp endpoint
2
Chọn Security Scheme mong muốn từ menu thả xuống.
Chọn lược đồ bảo mật mong muốn cho endpoint
3
Nếu bạn chọn OAuth 2.0 làm lược đồ bảo mật, bạn có thể tiếp tục chọn các Scopes bắt buộc.
Chọn phạm vi lược đồ bảo mật của endpoint
Các thiết lập Auth được cấu hình ở cấp endpoint sẽ ghi đè các thiết lập ở cấp thư mục.

Thiết lập giá trị mặc định cho Lược đồ bảo mật#

Lược đồ bảo mật chỉ xác định phương thức xác thực. Bạn vẫn cần cung cấp các giá trị xác thực thực tế khi gỡ lỗi endpoint.
Để tránh phải nhập lại các giá trị xác thực nhiều lần trong quá trình gỡ lỗi endpoint, Apidog cho phép bạn thiết lập các giá trị xác thực mặc định. Sau khi được thiết lập, các giá trị mặc định này sẽ tự động được sử dụng trong quá trình gỡ lỗi, trừ khi được ghi đè thủ công. Nếu một thư mục đã cấu hình các giá trị xác thực mặc định, tất cả endpoint thuộc thư mục đó đều có thể sử dụng chúng.
1
Chọn một lược đồ bảo mật từ danh sách và thiết lập Default Auth Values.
Giá trị xác thực m�ặc định
2
Điền giá trị dựa trên loại xác thực:
API Key: Nhập khóa của bạn
Basic Auth: Nhập tên người dùng và mật khẩu
Bearer Token: Nhập token
OAuth 2.0: Nhập client ID, client secret, v.v.
Các phương thức khác: Điền các giá trị tương ứng

Kế thừa và tùy chỉnh giá trị xác thực#

Khi sử dụng lược đồ bảo mật, bạn có thể:

1. Kế thừa từ thư mục cha#

Sử dụng lược đồ bảo mật và các giá trị mặc định được định nghĩa trong thư mục cha hoặc thư mục gốc.
Kế thừa lược đồ bảo mật

2. Tùy chỉnh giá trị xác thực#

Giữ nguyên lược đồ bảo mật, nhưng ghi đè các giá trị mặc định của lược đồ đó.
Tùy chỉnh lược đồ bảo mật

Sử dụng nhiều Lược đồ bảo mật#

Apidog hỗ trợ cấu hình nhiều lược đồ bảo mật cho một endpoint, phù hợp với cơ chế nhiều loại xác thực được định nghĩa trong đặc tả OpenAPI:
AND: Các lược đồ bảo mật được kết hợp bằng AND phải được sử dụng đồng thời trong cùng một yêu cầu (sắp ra mắt).
OR: Các lược đồ bảo mật được kết hợp bằng OR là các lựa chọn thay thế – có thể sử dụng bất kỳ một lược đồ nào trong ngữ cảnh đã cho.
Sử dụng nút + trong phần thiết lập Auth để thêm nhiều lược đồ bảo mật hơn.
Thêm nhiều lược đồ bảo mật

Chọn Scopes cho Lược đồ bảo mật OAuth 2.0#

Theo đặc tả OpenAPI, khi tạo lược đồ bảo mật OAuth 2.0, tất cả Scopes có thể có cần được định nghĩa. Khi sử dụng lược đồ đó trong một endpoint, bạn phải chọn các phạm vi bắt buộc.
Để đơn giản hóa thao tác, Apidog cho phép bạn thiết lập các phạm vi mặc định ở cấp thư mục. Các giá trị mặc định này sẽ áp dụng cho tất cả endpoint trong thư mục — trừ khi bạn thiết lập các phạm vi khác theo cách thủ công ở cấp endpoint.
1
Trong phần thiết lập Auth của endpoint, chọn OAuth 2.0.
2
Trong phần Scopes, bạn có thể xem tất cả phạm vi có sẵn được định nghĩa bởi lược đồ bảo mật và chọn các phạm vi cần thiết.
Chọn phạm vi xác thực ở cấp endpoint
3
Nếu endpoint kế thừa phạm vi từ thư mục cha, bạn có thể nhấp vào Reset the scopes to the configuration of the parent folder để khôi phục về cấu hình của thư mục cha.
Đặt lại thiết lập phạm vi

Gỡ lỗi endpoint với Lược đồ bảo mật OAuth 2.0#

Bạn có thể cấu hình sẵn một token làm giá trị mặc định cho lược đồ bảo mật OAuth 2.0, nhờ đó bạn không cần lấy token mới mỗi khi gỡ lỗi API.

Lấy token ở cấp thư mục làm giá trị xác thực mặc định#

1
Chọn một thư mục, đi tới thẻ Auth, chọn một lược đồ bảo mật OAuth 2.0, chọn phạm vi và loại cấp quyền, sau đó nhấp vào Get Token.
Lấy token OAuth 2.0 ở cấp thư mục
2
Trong bảng bật lên:
Nhập client ID, client secret, v.v.
Nhấp vào Continue
Kiểm thử lược đồ bảo mật token OAuth 2.0
3
Sau khi lấy token, bạn có thể xem thông tin chi tiết của token, bao gồm thời điểm token hết hạn. Token này có thể được sử dụng trên tất cả endpoint trong thư mục.
Xem thông tin chi tiết token trong thư mục

Lấy token ở cấp endpoint làm giá trị xác thực mặc định#

1
Chọn endpoint mong muốn, đi tới Edit, chọn một lược đồ bảo mật OAuth 2.0 và nhấp vào Get Token.
Lấy token ở cấp endpoint
2
Trong bảng bật lên:
Nhập client ID, client secret, v.v.
Nhấp vào Continue
Kiểm thử lược đồ bảo mật token OAuth 2.0 ở cấp endpoint
3
Hoàn tất việc ủy quyền để lấy token
Token sẽ được sử dụng để gỡ lỗi endpoint này
Xem thông tin chi tiết token

Sử dụng token mặc định hoặc tạo token mới để gỡ lỗi endpoint#

Khi gỡ lỗi một endpoint trong Apidog, bạn có hai tùy chọn để áp dụng token xác thực:

Phương thức 1: Sử dụng token xác thực mặc định#

Khi chạy một endpoint, đi tới thẻ Auth trong bảng Run. Chọn Use Parent Default Auth Values. Token xác thực mặc định được cấu hình trong thư mục cha sẽ tự động được áp dụng cho yêu cầu endpoint.
Sử dụng token xác thực mặc định để gỡ lỗi endpoint

Phương thức 2: Tạo token mới#

1
Khi chạy một endpoint, đi tới thẻ Auth trong bảng Run. Chọn Set Manually. Nhấp vào Get Token để mở bảng tạo token.
Tạo token mới để gỡ lỗi endpoint
2
Trong bảng bật lên:
Nhập client ID, client secret, v.v.
Nhấp vào Continue
Điền thông tin để tạo token mới
3
Hoàn tất việc ủy quyền để lấy token
Token sẽ được sử dụng để gỡ lỗi endpoint hiện tại
Modified at 2026-06-11 10:23:06
Previous
Tạo Security Scheme
Next
Lược đồ bảo mật trong tài liệu trực tuyến
Built with