取得用戶端憑證

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

本主題說明如何使用立即可用的開發人員應用程式和產品,取得用於開發與測試的用戶端憑證 (也稱為開發人員金鑰)。在實際工作環境中,這些步驟非常類似,但您可以使用自己的開發人員應用程式、產品和其他實體。

什麼是用戶端憑證?

如要參與任何 OAuth 2.0 流程,所有用戶端應用程式都必須向 Apigee Edge (授權伺服器) 註冊。註冊應用程式時,系統會指派兩個金鑰:「Consumer ID」和「Consumer Secret」。消費者 ID 是公開金鑰,且用戶端密鑰不得公開。這些用戶端憑證金鑰可讓 Apigee Edge 識別用戶端應用程式。

快速步驟

以下快速步驟說明如何取得建立 Apigee Edge 機構時立即可用的其中一個應用程式的開發人員金鑰。這些金鑰主要可用於開發和測試:

  1. 按照下文說明前往「開發人員應用程式」頁面。

    Edge

    如何使用 Edge UI 存取「開發人員應用程式」頁面:

    1. 登入 apigee.com/edge
    2. 在左側導覽列中,依序選取「發布」>「應用程式」
    3. 按一下「+Proxy」

    傳統邊緣 (Private Cloud)

    如何使用傳統版 Edge UI 存取「開發人員應用程式」頁面:

    1. 登入 http://ms-ip:9000,其中 ms-ip 是管理伺服器節點的 IP 位址或 DNS 名稱。
    2. 在頂端導覽列中,依序選取「發布」>「開發人員應用程式」
  2. 按一下「天氣應用程式」 ,開啟「天氣應用程式總覽」頁面。請注意,與應用程式相關聯的開發人員為 Nicolai Tesla。根據預設,系統會在貴機構建立時佈建這個應用程式和開發人員。所有開發人員應用程式都必須有相關聯的開發人員。
  3. 在「Products」(產品) 區段,按一下 Premium Weather API 產品旁邊的「Show」(顯示),公開顯示「Consumer ID」(消費者 ID) 與「Consumer Secret」(消費者密鑰) 值。
  4. 請複製並儲存這兩個值,您之後需使用這些值進行 API 呼叫來取得存取權杖。

透過 Edge API 取得用戶端憑證

您也可以呼叫 Management API,取得應用程式的用戶端金鑰和密鑰。首先,請執行下列 API 呼叫,取得貴機構的應用程式清單:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps \
-u email:password 

此呼叫會根據應用程式 ID 傳回應用程式清單。

[ "da496fae-2a04-4a5c-b2d0-709278a6f9db", "50e3e831-175b-4a05-8fb6-05a54701af6e" ]

您可以對應用程式 ID 進行簡單的 GET 呼叫,藉此擷取應用程式的設定檔:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/{app_id} \
-u email:password 

例如:

$ curl https://api.enterprise.apigee.com/v1/o/{org_name}/apps/da496fae-2a04-4a5c-b2d0-709278a6f9db \
-u email:password 

API 呼叫會傳回您指定的應用程式設定檔。例如,weatherapp 的應用程式設定檔採用下列 JSON 表示法:

{
  "accessType" : "read",
  "apiProducts" : [ ],
  "appFamily" : "default",
  "appId" : "da496fae-2a04-4a5c-b2d0-70928a6f9db",
  "attributes" : [ ],
  "callbackUrl" : "http://weatherapp.com",
  "createdAt" : 1380290158713,
  "createdBy" : "noreply_admin@apigee.com",
  "credentials" : [ {
    "apiProducts" : [ {
      "apiproduct" : "PremiumWeatherAPI",
      "status" : "approved"
    } ],
    "attributes" : [ ],
    "consumerKey" : "bBGAQrXgivA9lKu7NMPyYpVKNhGar6K",
    "consumerSecret" : "hAr4Gn0gA9vyvI4",
    "expiresAt" : -1,
    "issuedAt" : 1380290161417,
    "scopes" : [ ],
    "status" : "approved"
  } ],
  "developerId" : "5w95xGkpnjzDBT4",
  "lastModifiedAt" : 1380290158713,
  "lastModifiedBy" : "noreply_admin@apigee.com",
  "name" : "weatherapp",
  "scopes" : [ ],
  "status" : "approved"
}

請記下 consumerKeyconsumerSecret 的值。

深入探索

如需有關應用程式註冊和金鑰管理的詳細討論,請參閱「註冊應用程式及管理 API 金鑰」。