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步)。 如果访问令牌不再有效,您需要重新生成该令牌。