为 AWS 合作伙伴中心和 AWS Marketplace 活动设置实时通知

1. 以系统管理员身份登录您的 Salesforce 组织。

2. 在 “设置” 的 “快速查找” 框中输入apps，然后选择 “应用程序管理器”。

3. 在 Lightning Experience 应用程序管理器页面上，选择新建互联应用程序，选择创建互联应用程序，然后选择继续。

   此时将出现 “新建连接的应用程序” 页面。

4. 执行以下操作：

   1. 在 “已连接的应用程序名称” 框中，输入应用程序的名称。

   2. 在 “联系人邮箱” 框中，输入您的电子邮件地址。

   3. （可选）按照 Salesforce 文档中配置基本互联应用程序设置中所述填写其余字段。

5. 选中 “启用 OAuth 设置” 复选框，然后执行以下操作：

   1. 选中 “启用设备流” 复选框。您可以忽略生成的回传 URL。

   2. 在 “可用 OAuth 范围” 下，选择 “通过管理用户数据”， APIs然后使用 “添加” 按钮将范围移至所选范围列表中。

   3. 选中以下复选框：

      • 支持的授权流程需要验证密钥才能使用代码交换 (PKCE) 扩展

      • Web 服务器流程需要密钥

      • 刷新令牌流需要密钥

      • 启用客户端凭证流程

   4. 在选择 “启用客户端凭证流” 后出现的消息中，选择 “确定”。

   5. 滚动到页面底部并选择 Save (保存)。

6. 选择 “继续”，然后选择 “管理消费者详细信息”。

   将出现 “验证您的身份” 页面，系统会向您的联系人电子邮件地址发送验证码。

7. 在验证码框中输入验证码，然后选择验证。

   此时将显示您已连接的应用程序的页面。

8. 在 “消费者详细信息” 下，选择消费者密钥和客户密钥的 “复制” 按钮。

9. 在 “设置” 的 “快速查找” 框中，输入 “应用程序”，选择 “管理已连接的应用程序”，然后选择您刚刚创建的关联应用程序。

10. 选择 “编辑策略”，然后执行以下操作：

    1. 从 “允许的用户” 列表中，选择 “所有用户均可自行授权”。

    2. 从 “IP 放松” 列表中，选择 “强制执行 IP 限制”。

    3. 从运行身份列表中，选择执行用户，即您向其分配客户端凭据流的用户。Salesforce 要求执行用户代表该用户返回访问令牌。

    4. 选择保存。

要查找网址

1. 登录 Salesforce。

2. 在 “设置” 部分的 “快速查找” 框中输入my domain。

3. 在左侧窗格的 “公司设置” 下，选择 “我的域名” 链接。

4. 复制 “当前我的域名 URL” 框中的地址。

1. 下载以下模板：

   注意

   您可以分别部署每个模板，并且对两个模板执行相同的步骤。

   • 合作伙伴中心 API 集成：https://servicecatalogconnector.s3.amazonaws.com/APIDestinationcft_pc api.json

   • （可选） AWS Marketplace 集成：https://servicecatalogconnector.s3.amazonaws.com/APIDestinationcft AWSMP _ .json

2. 在 AWS 控制台中，登录您的 AWS Marketplace 卖家账户并确保该账户在弗吉尼亚州北部运行。 EventBridge 仅在该地区运营。

3. 仍在控制台中，继续搜索cloudformation，然后打开 AWS CloudFormation 控制台。

4. 在堆栈页面上，选择创建堆栈。

5. 选择 “选择现有模板并上传模板文件” 单选按钮。

6. 选择 “选择文件” 以打开下载的模板，然后选择 “下一步”。

7. 在指定堆栈详细信息页面上，输入以下内容：

   • 堆栈名称-输入堆栈的名称。

   • 客户端 ID — 输入您在创建关联应用程序时记下的使用者密钥。

   • 客户端密钥-输入您在创建连接的应用程序时记下的用户密钥。

   • 域名网址-使用以下格式：https://domain_URL.

   在完成后，选择下一步。

8. 在配置堆栈选项页面上，滚动到末尾，选中 “我确认 AWS CloudFormation 可能会创建 IAM 资源” 复选框，然后选择下一步。

9. 选择提交。

创建目的地和连接

1. 打开 EventBridge 控制台 https://console.aws.amazon.com/events/，然后在左侧导航窗格中选择 API 目的地。

2. 向下滚动到 API 目标表，然后选择创建 API 目标。

   此时将出现 “创建 API 目标” 页面。

3. 输入以下信息：

   1. API 目标的名称。您最多可以使用 64 个大写或小写字母、数字、点 (.)、破折号 (-) 或下划线 (_) 字符。

      在当前区域中，该名称对于您的账户必须是唯一的。

   2. （可选）输入 API 目标的描述。

   3. 对于 API 目标端点，请使用此网址：https://my-salesforce-domain-name.my.salesforce.com/services/data/v58.0/sobjects/event-api-name。

   4. 对于 HTTP 方法，选择 POST。

4. 在 “连接配置” 下，选择 “创建新连接”，然后执行以下操作：

   1. 输入名称和可选描述。

   2. 对于目的地类型，请选择其他。

   3. 选择 “OAuth 客户凭证”。

   4. 对于授权端点，请接受预填充的端点。

      -或-

      如果您使用的是生产组织，请将填充的终端节点替换为以下 URL：

      https://my-salesforce-domain-name.my.salesforce.com/services/oauth2/token

   5. 对于 HTTP 方法，选择 POST。

   6. 在 “客户端 ID” 中，输入 Salesforce 中连接的应用程序中的使用者密钥。

   7. 对于客户机密钥，请在 Salesforce 中输入来自已连接应用程序的用户密钥。

   8. 添加以下 OAuth 值：

      • 参数：正文场

      • 密钥：grant_type

      • 值：客户凭证

5. 选择创建。

1. 在 Amazon 中 EventBridge，选择规则。

2. 从列表中选择所需的事件总线。

3. 在规则部分中，选择创建规则。

4. 输入规则的名称，然后选择下一步。

5. 在事件模式下，选择自定义模式（JSON 编辑器），然后输入以下过滤器。 您可以使用细节类型的任意组合。

   {
     "source": [
       "aws.marketplacecatalog"
     ],
     "detail-type": [
       "Change Set Succeeded",
       "Change Set Failed",
       "Change Set Cancelled"
     ]
   }

   有关事件模式匹配的更多信息，请参阅 AWS 文档中的 Amazon EventBridge 事件模式中的内容筛选。

6. 选择下一步。

7. 在选择目标中，在目标 1 下，选择 EventBridge API 目标。

8. 从列表中选择您刚刚创建的 API 目标。

9. 展开其他设置。

10. 在 “配置目标输入” 下，选择 “输入变压器” 和 “配置输入变压器”。这样可以确保仅发送原始事件详细信息部分中的 Salesforce 事件字段。

    输入路径必须是： 

    {
      "Name": "$.detail-type",
      "awsapn__Account_Number__c": "$.account",
      "awsapn__EntityId__c": "$.detail.ChangeSetId"
    }

    模板必须是： 

    {
      "Name": Name,
      "awsapn__Account_Number__c": awsapn__Account_Number__c,
      "awsapn__EntityId__c": awsapn__EntityId__c
    }

11. 选择 “下一步”，然后选择 “下一步”。

12. 查看规则，然后选择创建规则。