此信息向您说明如何创建Adobe I/O和Places Service集成。
与贵组织的系统管理员确认以下任务已完成:
Places核心服务将显示在您组织的Admin Console中。
您已被添加到组织。
您已被添加为组织中的Places核心服务的用户。
有关更多信息,请参阅 将用户或开发人员添加到Places服务和Experience Platform Launch配置文件 在 获取对Places服务的访问权限.
您已被添加为组织中Places核心服务的开发人员。
有关添加开发人员的详细信息,请参阅 将用户或开发人员添加到Places服务和Experience Platform Launch配置文件 在 获取对Places服务的访问权限.
有关开发人员角色的更多信息,请参阅 管理开发人员.
对Places服务REST API的每个请求都需要以下项:
与Adobe I/O的集成提供了这些项目,以及使用JSON Web令牌(JWT)请求持有者令牌的方法。
如果您无法登录到Adobe I/O控制台,或者如果Places服务不是 创建集成页面,请参见 组织要求 在 Web服务API概述.
要创建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 > 用户 > (您的用户名) > 键.
以下视频将指导您完成生成密钥对的过程:
要创建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,以及有关您的集成的其他详细信息。
在集成详细信息页面上,单击 服务 制表符并确认 Places Service 显示于 已配置的服务.
在 概述 选项卡,找到并记录API密钥(客户端ID)和组织ID。
每个Places服务REST API请求都需要这些ID。
在集成详细信息页面上,单击 JWT 选项卡,以便您可以通过生成JWT并提供Exchange URL来测试集成。
要生成JWT令牌:
在文本编辑器中,打开 private.key
您在上面创建的文件。
在 JWT 选项卡上,复制密钥的内容并将其粘贴到粘贴私钥字段中。
单击 生成JWT.
在示例 CURL 命令部分中,单击复制并将内容粘贴到命令提示符或终端窗口中。
通过按运行命令 输入 在键盘上。
找到 "token_type": "bearer"
和 "access_token"
值。
持有者访问令牌的值是您将在Places服务API请求中使用的值。
Adobe访问令牌有效 仅限 保存24小时,然后保存示例CURL命令(步骤5)。 如果访问令牌不再有效,则需要重新生成令牌。