Show Menu
主题×

集成概述和先决条件

此信息会向您展示如何创建Adobe I/O和Places service集成。

用户访问的先决条件

向贵组织的系统管理员确认以下任务已完成:
  • “放置核心服务”会显示在您组织的管理控制台中。
  • 您已添加到组织。
  • 您已作为用户添加到组织中放置核心服务。
    有关详细信息,请参 阅获取对Places service的访问权限中的将用户或开发人员添加到Places Service and Experience Platform Launch配置文件​
  • 您已作为开发人员添加到您组织中的Places Core Service。
    有关添加开发人员的详细信 息,请参阅获取对Places service的访问权限中的将用户或开发人员添加到您的Places Service and Experience Platform Launch配置文件​
    有关开发人员角色的详细信息,请参阅管 理开发人员

REST API请求

对Places Service REST API的每个请求都需要以下项:
  • 组织ID
  • API密钥
  • 承载令牌
与Adobe I/O的集成提供了这些项,以及使用JSON web令牌(JWT)请求承载令牌的方法。
如果无法登录到Adobe I/O控制台,或者如果“创建集成”页面上不提供“放置服务”选项 ,请参阅 Web服务API概述中的组织要求 ** Web服务API概述

创建Places service集成

要创建Places service集成,请完成以下任务:

生成公钥和私钥对

要创建Places service集成,您需要一个公共密钥对和一个私钥对。 可以购买这些对,也可以生成您自己的自签名密钥。
要生成您自己的自签名密钥,请执行以下操作:
  1. 在终端窗口中,复制并粘贴以下每行,然后在粘贴每 Enter ​行后按:
       mkdir keys
       cd keys
       openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout places_integration_test_private.key -out    places_integration_test_public.crt
    
    
    我们建议您命名密钥以便于参考,并将其存储在文件夹中。 如果您创建多个集成,则可以轻松识别和管理属于哪个集成的密钥。
  2. 键入OpenSSL请求的信息:
    Country Name (2 letter code:  // Example: US
    State or Province Name (full name):  // Example: California
    Locality Name (eg, city):  // Example: San Jose
    Organization Name (eg, company):  // Example: Places
    Organizational Unit Name (eg, section):  // Example: Engineering
    Common Name (eg, fully qualified host name):  // Example: places.com
    Email Address:  // Example:  poi@places.com
    
    
    有关OpenSSL的详细信息,请参 阅OpenSSL
    您提供的信息会并入密钥中。
  3. 导览至文件和文 .key 件所 .crt 在的目录。
    例如,在MacOS中,转到 Macintosh HD > users > (your user name) > Keys
以下视频将指导您完成生成键对的过程:

在Adobe I/O控制台中创建Places service集成

要创建Places service集成,请执行以下操作:
  1. 转到 https://console.adobe.io ,然后使用您的Adobe ID登录。
  2. 在“快 速入门 ”部分,单击 创建集成
  3. 选择 Access an API ​并单击​ Continue
    Access an API ​是默认位置。
  4. 如果您有权访问多个Experience cloud组织,请从右上方的下拉列表中选择该组织。
  5. Under Experience Cloud , select​ Places Service as the Adobe service to which you want to integrate and click Continue .
  6. 选择 New integration ​并单击​ Continue
  7. 在创建新集成屏幕中,输入名称和说明。
  8. 将您在上面创 xxxx_public.crt 建的文件拖放到放置 Public keys certificates ​区域。
  9. 选择产品配置。
    如果不确定要选择哪个配置文件,请与系统管理员联系。
  10. At the bottom of the page, click Create integration .
  11. 几秒钟后,在“集成已创 建”屏幕中 ,确认显示以下消息:
    Your integration has been created.
  12. 将显示集成详细信息页面,其顶部是集成名称。
    该选 Overview ​项卡默认显示,并显示API密钥、组织ID、技术帐户ID以及有关集成的其他详细信息。

记录组织ID和API密钥

  1. 在集成详细信息页面上,单击 Services ​选项卡并确认显​ Places Service 示在下方 Configured Services
  2. 在选 Overview ​项卡上,找到并记录API密钥(客户端ID)和组织ID。
    每个Places Service REST API请求都需要这些ID。

生成JWT令牌

在集成详细信息页面上,单 JWT ​击选项卡,以便通过生成JWT并提供交换URL来测试集成。
要生成JWT令牌,请执行以下操作:
  1. 在文本编辑器中,打开您 private.key 在上面创建的文件。
  2. On the JWT ​tab, copy the contents of the key and paste it in the​ Paste private key field.
  3. 单击 Generate JWT
  4. In the Sample CURL command ​section, click​ Copy and paste the contents in your command prompt or terminal window.
  5. 通过按键盘运 Enter ​行命令。
  6. 找到 "token_type": "bearer" "access_token" 值。
    承载访问令牌的值是您将在Places Service API请求中使用的值。
Adobe访问令牌的有 效期仅为 24小时,因此请保存示例CURL命令(第5步)。 如果访问令牌不再有效,您需要重新生成该令牌。