# 設計 API 安全性

作為 API 設計流程的一部分，您需要指定哪些取用端可以存取您的 API（身分驗證），以及允許他們執行哪些操作（授權）。

您可能只想為整個 API 定義通用安全性，或是選擇更精細的原則，為關鍵資源設定特定的安全性。

您可能也想要指定某些操作無需身分驗證即可自由存取。

API 合約 可透過主要的安全性類型處理所有這些情況：

* 基本驗證
* Bearer 驗證
* 摘要式驗證
* OAuth 1.0
* OAuth 2.0
* OpenID Connect
* 自訂 / API 金鑰
* 直通

不支援 Cookie 驗證。

## 建立安全性配置

建立安全性配置，以在您的 API 版本中全域使用或在個別元素中使用。

1. 前往您的 API 的一般資訊頁面。
2. 向下捲動至 安全性配置 區段，然後按一下 新增 以建立新的配置。
3. 輸入名稱，並從下拉式清單中選取類型。
4. 選用：輸入描述。
5. 輸入所選類型特有的其他參數。

   ![安全性配置定義範例。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/shows_OAuth2_security_scheme.png)

您的安全性配置現已建立，您可以在 API 的全域設定 或特定資源與操作中使用它。

## 定義您的 API 安全性

為您的 API、資源和作業定義安全性配置。

1. 前往您的 API 的一般資訊頁面。
2. 在全域安全性區段中，新增您的安全性配置，並選取您要全域套用至 API 版本的配置。

   ![在此範例中，Petstore API 受到 petstore_auth 保護，範圍為 write:pets。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/designer_security.png)
3. 選取資源，並選擇要套用至該資源所有操作的安全性配置。

   或者，您可以選取作業來定義其特定的安全性。![在此範例中，Find Pets by tags 方法使用 petstore_auth 進行保護。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/designer_security_2.png)