导入现有的使用方密钥和 Secret

本页面适用于 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 文档。

当您创建开发者应用并将其与 API 产品相关联时，Apigee 会自动生成使用方密钥和使用方 Secret。（通过注册应用来控制对 API 的访问权限中包含这些过程。）但是，您可能已有要从其他系统导入到 Apigee 的使用方密钥和 Secret。从技术上讲，这并不是导入过程。它将在 Apigee 中一次重建一个现有密钥。

注意：请留意 API 密钥的以下大小限制。不超出这些限制，有助于避免服务中断。

使用方密钥（API 密钥）大小	2 KB
使用方 Secret 大小	2 KB

注意：使用方密钥和 Secret 可以包含字母、数字、下划线和连字符。不允许使用其他特殊字符。

1. 使用 Apigee API 创建使用方密钥和 Secret。
   请参阅 create 使用方密钥和 Secret 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"
       }'

   按照获取 OAuth 2.0 访问令牌中的说明，将 $TOKEN 设置为您的 OAuth 2.0 访问令牌。如需了解此示例中使用的 curl 选项，请参阅使用 curl。如需了解您可以使用的环境变量，请参阅为 Apigee API 请求设置环境变量。

   有关您可以在请求正文中提供的字段的说明，请参阅 资源：DeveloperAppKey。

2. 将使用方密钥/Secret 与一个或多个 Apigee API 产品相关联。这样，就可以在产品控制授权的 API 代理中使用导入的使用方密钥（也称为 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"]
       }'

   按照获取 OAuth 2.0 访问令牌中的说明，将 $TOKEN 设置为您的 OAuth 2.0 访问令牌。如需了解此示例中使用的 curl 选项，请参阅使用 curl。如需了解您可以使用的环境变量，请参阅为 Apigee API 请求设置环境变量。

3. （可选）删除 Apigee 自动生成的初始使用方密钥/Secret。不过，您可以保留自动生成的密钥。导入的密钥和自动生成的密钥在 API 调用中都有效，两者都在 Apigee 界面的“开发者应用详情”页面上显示。
   请参阅开发者应用 API 的 delete API 密钥。