匯入現有的消費者金鑰和密鑰

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

查看 Apigee Edge 說明文件。

建立開發人員應用程式並與 API 產品建立關聯時，Apigee 會自動產生用戶端金鑰和用戶端密鑰。(這些程序請參閱「 註冊應用程式來控管 API 存取權」一文)。不過，您可能想從其他系統匯入現有的消費者金鑰和密鑰至 Apigee。從技術上來說，這項程序並非匯入作業，系統會一次重新建立 Apigee 中的現有金鑰。

注意：請留意 API 金鑰的大小限制。只要不超出這些限制，就能避免服務中斷。

用戶端金鑰 (API 金鑰) 大小	2 KB
用戶端密鑰大小	2 KB

注意：消費者金鑰和密鑰可包含字母、數字、底線和連字號。不得使用其他特殊字元。

1. 使用 Apigee API 建立消費者金鑰和密鑰。
   請參閱 create用戶端金鑰和密鑰 API。以下是 curl：
   

   curl https://apigee.googleapis.com/v1/organizations/{org}/developers/{developer_email}/apps/{app_name}/keys \
     -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-type:application/json' \
     -d \
       '{
         "consumerKey": "key",
         "consumerSecret": "secret",
         "expiresInSeconds": "180"
       }'

   其中 $TOKEN 會設為您的 OAuth 2.0 存取權杖，如「取得 OAuth 2.0 存取權杖」一文所述。如要瞭解本範例使用的 curl 選項，請參閱「使用 curl」。如要瞭解可使用的環境變數，請參閱為 Apigee API 要求設定環境變數。

   如要瞭解可在要求內容中提供的欄位，請參閱資源：DeveloperAppKey。

2. 將消費者金鑰/密鑰與一或多個 Apigee API 產品建立關聯。這樣一來，您就能在呼叫 API Proxy 時使用匯入的消費者金鑰 (也稱為 API 金鑰)，授權作業則由產品控管。
   請參閱 ReplaceDeveloperAppKey API。以下是 curl：

   curl https://apigee.googleapis.com/v1/organizations/{org}/developers/{developer_email}/apps/{app_name}/keys/{key} \
     -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-type:application/json' \
     -d \
       '{
         "apiProducts": ["product_1", "product_2"]
       }'

   其中 $TOKEN 會設為您的 OAuth 2.0 存取權杖，如「取得 OAuth 2.0 存取權杖」一文所述。如要瞭解本範例使用的 curl 選項，請參閱「使用 curl」。如要瞭解可使用的環境變數，請參閱為 Apigee API 要求設定環境變數。

3. (選用) 刪除 Apigee 自動產生的初始消費者金鑰/密鑰。不過，您可以保留自動產生的金鑰。匯入的金鑰和自動產生的金鑰都可用於 API 呼叫，且都會顯示在 Apigee UI 的「開發人員應用程式詳細資料」頁面。
   請參閱 delete 開發人員應用程式 API 的 API 金鑰。