集成概述和先决条件

此信息向您说明如何创建Adobe I/O和Places Service集成。

用户访问的先决条件

与贵组织的系统管理员确认以下任务已完成:

  • Places核心服务将显示在您组织的Admin Console中。

  • 您已被添加到组织。

  • 您已被添加为组织中的Places核心服务的用户。

    有关更多信息,请参阅 将用户或开发人员添加到Places服务和Experience Platform Launch配置文件获取对Places服务的访问权限.

  • 您已被添加为组织中Places核心服务的开发人员。

    有关添加开发人员的详细信息,请参阅 将用户或开发人员添加到Places服务和Experience Platform Launch配置文件获取对Places服务的访问权限.

    有关开发人员角色的更多信息,请参阅 管理开发人员.

REST API请求

对Places服务REST API的每个请求都需要以下项:

  • 组织ID
  • API密钥
  • 持有者令牌

与Adobe I/O的集成提供了这些项目,以及使用JSON Web令牌(JWT)请求持有者令牌的方法。

  • 有关JWT的更多信息,请参阅 JSON Web令牌简介.
  • 要为Places Service创建集成,请参阅 创建Places服务集成 部分。
  • 要了解API密钥集成、生成JWT和公共密钥证书,请参阅 Adobe I/O身份验证概述.
重要

如果您无法登录到Adobe I/O控制台,或者如果Places服务不是 创建集成页面,请参见 组织要求Web服务API概述.

创建Places服务集成

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

生成公钥和私钥对

要创建Places服务集成,您需要一个公钥和私钥对。 这些密钥对可以购买,也可以生成您自己的自签名密钥。

要生成您自己的自签名密钥,请执行以下操作:

  1. 在终端窗口中,复制并粘贴以下各行,然后按键 输入 粘贴每行后:

       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 > 用户 > (您的用户名) > .

以下视频将指导您完成生成密钥对的过程:

集成视频

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

要创建Places Service集成,请执行以下操作:

  1. 转到 https://console.adobe.io 然后使用您的Adobe ID登录。

  2. 快速入门 部分,单击 创建集成.

  3. 选择 访问API 并单击 继续.

    访问API 是默认位置。

  4. 如果您有权访问多个Experience Cloud组织,请从右上方的下拉列表中选择该组织。

  5. Experience Cloud,选择 Places Service 作为要集成到的Adobe服务,然后单击 继续.

  6. 选择 新集成 并单击 继续.

  7. 在创建新集成屏幕上,输入名称和描述。

  8. 拖放 xxxx_public.crt 文件(您在上面创建的)到 公钥证书 放置区域。

  9. 选择产品配置文件。

    如果不确定要选择哪个配置文件,请联系您的系统管理员。

  10. 在页面底部,单击 创建集成.

  11. 几秒钟后,在 已创建集成 屏幕,验证是否显示以下消息:

    Your integration has been created.

  12. 此时将显示集成详细信息页面,集成名称位于顶部。

    概述 选项卡,其中默认显示API密钥、您的组织ID、技术帐户ID,以及有关您的集成的其他详细信息。

记录组织ID和API密钥

  1. 在集成详细信息页面上,单击 服务 制表符并确认 Places Service 显示于 已配置的服务.

  2. 概述 选项卡,找到并记录API密钥(客户端ID)和组织ID。

    每个Places服务REST API请求都需要这些ID。

生成JWT令牌

在集成详细信息页面上,单击 JWT 选项卡,以便您可以通过生成JWT并提供Exchange URL来测试集成。

要生成JWT令牌:

  1. 在文本编辑器中,打开 private.key 您在上面创建的文件。

  2. JWT 选项卡上,复制密钥的内容并将其粘贴到​粘贴私钥​字段中。

  3. 单击 生成JWT.

  4. 在​示例 CURL 命令​部分中,单击​复制​并将内容粘贴到命令提示符或终端窗口中。

  5. 通过按运行命令 输入 在键盘上。

  6. 找到 "token_type": "bearer""access_token" 值。

    持有者访问令牌的值是您将在Places服务API请求中使用的值。

重要

Adobe访问令牌有效 仅限 保存24小时,然后保存示例CURL命令(步骤5)。 如果访问令牌不再有效,则需要重新生成令牌。

在此页面上