驗證存取權杖

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

在 Apigee 上呼叫具有 OAuth 安全性的 API Proxy 時，Apigee 會負責驗證存取權杖。您可以將 Apigee 視為守門員，只有通過驗證的存取權杖才能通過，

提示：驗證存取權杖時，如果看到「Invalid API call as no apiproduct match found」(找不到相符的 apiproduct，因此 API 呼叫無效) 錯誤，請參閱這篇 Apigee 社群文章，瞭解錯誤原因和修正步驟。

新增 VerifyAccessToken 政策

如要設定權杖驗證，請在 API Proxy 流程的開頭 (ProxyEndpoint Preflow 的開頭)，放置具有 VerifyAccessToken 作業的 OAuthV2 政策。如果放在該處，系統會在進行任何其他處理作業前驗證存取權杖，如果權杖遭到拒絕，Apigee 會停止處理作業，並將錯誤傳回給用戶端。

如要使用 Apigee UI 存取 API Proxy 頁面，請按照下列步驟操作：

1. 開啟 Apigee 使用者介面。
2. 在左側導覽列中選取「開發」>「API Proxy」。
3. 從清單中選取要保護的 Proxy。
4. 在總覽頁面中，按一下「開發」分頁標籤。
5. 在 Navigator 中，選取 Proxy 端點下方列出的端點的「PreFlow」PreFlow。通常您需要的端點稱為「default」，但也可以建立多個 Proxy 端點。如果您有多個端點，可能需要按照下列步驟，在每個端點上執行權杖驗證。
   
   
   
6. 在 Proxy 流程編輯器中，按一下「+ Step」。
   
   
   
7. 選取「Policy Instance New」(新政策執行個體)。
8. 從政策清單中選取「OAuth v2.0」。
9. 視需要變更政策名稱和顯示名稱。舉例來說，為了提升可讀性，您可以將顯示名稱和名稱都變更為「VerifyAccessToken」。
10. 按一下「新增」。

預設政策已設定 VerifyAccessToken 作業，因此您不必採取任何進一步行動：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OAuthV2 async="false" continueOnError="false" enabled="true" name="OAuth-v20-1">
    <DisplayName>OAuth v2.0 1</DisplayName>
    <FaultRules/>
    <Properties/>
    <Attributes/>
    <ExternalAuthorization>false</ExternalAuthorization>
    <Operation>VerifyAccessToken</Operation>
    <SupportedGrantTypes/>
    <GenerateResponse enabled="true"/>
    <Tokens/>
</OAuthV2>

注意：根據預設，VerifyAccessToken 會將存取權杖視為 Bearer 權杖，並預期存取權杖會傳送至 Authorization 標頭。例如：

-H "Authorization: Bearer Rft3dqrs56Blirls56a"

如要變更這項預設值，請在 OAuthV2 政策的 <AccessToken> 元素中進行設定，詳情請參閱 OAuthV2 政策說明文件。