在 Swagger 中處理認證授權通常需要使用 OpenAPI 規范中的 securityDefinitions 字段來定義安全模式,并在 API 操作上使用 security 字段指定需要的安全模式。
下面是一個示例,演示如何在 Swagger 中處理基本身份驗證認證授權:
securityDefinitions:
basicAuth:
type: basic
paths:
/api/endpoint:
get:
security:
- basicAuth: []
responses:
200:
description: Successful operation
這樣,在 Swagger UI 中就會顯示一個認證框,用戶需要輸入用戶名和密碼才能訪問該 API 操作。
除了基本身份驗證,Swagger 還支持其他認證方式,如 OAuth 2.0、API Key 等。你可以根據實際需要在 securityDefinitions 中定義相應的安全模式,并在 API 操作上使用 security 字段指定需要的安全模式。