集成概述和先决条件
此信息向您说明如何创建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服务集成，您需要一个公钥和私钥对。 这些密钥对可以购买，也可以生成您自己的自签名密钥。
要生成您自己的自签名密钥，请执行以下操作：
-
在终端窗口中，复制并粘贴以下各行，然后按键 输入 粘贴每行后：
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重要我们建议您为密钥命名以便轻松引用，并将它们存储在文件夹中。 如果您创建多个集成，则可以轻松识别和管理哪些键属于哪个集成。
-
键入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.
重要您提供的信息将合并到键中。
-
导航到
.key和.crt找到文件。例如，在MacOS中，转到 Macintosh HD > 用户 > （您的用户名） > 键.
以下视频将指导您完成生成密钥对的过程：
在Adobe I/O控制台中创建Places Service集成
要创建Places Service集成，请执行以下操作：
-
转到 https://console.adobe.io 然后使用您的Adobe ID登录。
-
在 快速入门 部分，单击 创建集成.
-
选择 访问API 并单击 继续.
访问API 是默认位置。
-
如果您有权访问多个Experience Cloud组织，请从右上方的下拉列表中选择该组织。
-
下 Experience Cloud，选择 Places Service 作为要集成到的Adobe服务，然后单击 继续.
-
选择 新集成 并单击 继续.
-
在创建新集成屏幕上，输入名称和描述。
-
拖放
xxxx_public.crt文件（您在上面创建的）到 公钥证书 放置区域。 -
选择产品配置文件。
如果不确定要选择哪个配置文件，请联系您的系统管理员。
-
在页面底部，单击 创建集成.
-
几秒钟后，在 已创建集成 屏幕，验证是否显示以下消息：
Your integration has been created. -
此时将显示集成详细信息页面，集成名称位于顶部。
此 概述 选项卡，其中默认显示API密钥、您的组织ID、技术帐户ID，以及有关您的集成的其他详细信息。
记录组织ID和API密钥
-
在集成详细信息页面上，单击 服务 制表符并确认 Places Service 显示于 已配置的服务.
-
在 概述 选项卡，找到并记录API密钥（客户端ID）和组织ID。
每个Places服务REST API请求都需要这些ID。
生成JWT令牌
在集成详细信息页面上，单击 JWT 选项卡，以便您可以通过生成JWT并提供Exchange URL来测试集成。
要生成JWT令牌：
-
在文本编辑器中，打开
private.key您在上面创建的文件。 -
在 JWT 选项卡上，复制密钥的内容并将其粘贴到粘贴私钥字段中。
-
单击 生成JWT.
-
在示例 CURL 命令部分中，单击复制并将内容粘贴到命令提示符或终端窗口中。
-
通过按运行命令 输入 在键盘上。
-
找到
"token_type": "bearer"和"access_token"值。持有者访问令牌的值是您将在Places服务API请求中使用的值。
Adobe访问令牌有效 仅限 保存24小时，然后保存示例CURL命令（步骤5）。 如果访问令牌不再有效，则需要重新生成令牌。
