取得用戶端憑證

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

本主題說明如何使用現成開發人員應用程式和產品,取得用於開發和測試的用戶端憑證 (也稱為開發人員金鑰)。在正式環境中,步驟類似,但您會使用自己的開發人員應用程式、產品和其他實體。

什麼是用戶端憑證?

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

快速步驟

這些快速步驟說明如何取得其中一個隨附應用程式的開發人員金鑰,這些應用程式是在您建立 Apigee Edge 機構時設定。您可以使用這些金鑰進行開發和測試:

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

    邊緣

    如要使用 Edge 使用者介面存取「開發人員應用程式」頁面,請按照下列步驟操作:

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

    Classic Edge (Private Cloud)

    如要使用傳統 Edge UI 存取「開發人員應用程式」頁面,請按照下列步驟操作:

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

使用 Edge API 取得用戶端憑證

您也可以呼叫管理 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 金鑰」。