发布日期: 2016年11月
适用于: Dynamics CRM 2015
本演练演示如何使用插件注册工具配置 Microsoft Azure Active Directory 访问控制服务 (ACS) 和注册服务终结点步骤。 一旦配置,Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 可以将当前操作的执行上下文发布到 Microsoft Azure 解决方案终结点。 对于本演练,注册该步骤以便将 Account 实体的 CreateRequest 消息的执行上下文发布到 Microsoft Azure 服务总线。
开始本演练之前,必须完成以下必备条件:
访问 Plug-in Registration 工具。 可以在 SDK 的 Tools\PluginRegistration 文件夹中找到该工具的可执行文件。下载 Microsoft Dynamics CRM SDK 包。
获取 Microsoft Dynamics CRM 2015 或 Microsoft Dynamics CRM Online 上的帐户。
您的系统用户帐户必须具有系统定制员或系统管理员角色。 有关详细信息,请参阅如何在 Microsoft Dynamics CRM 2015 中使用基于角色的安全性控制访问实体。
能够访问 Microsoft Azure 平台服务命名空间,该命名空间使用 ACS 将向 Microsoft Dynamics 365 发布消息的版本 2。有关 创建 ACS 命名空间参阅创建新服务命名空间。
如果使用的是 Microsoft Dynamics CRM 2015,必须根据配置 Azure 与 Microsoft Dynamics CRM 2015 集成主题中的说明对服务器进行配置,以实现 Microsoft Azure 集成。
必须有一个积极监听 Microsoft Dynamics 365 的指定解决方案终结点的监听程序应用程序,才能成功发布到 Microsoft Azure 服务总线。 有关详细信息,请参阅为 Windows Azure 解决方案编写监听程序。
步骤
该演练包含以下步骤:
连接到 Microsoft Dynamics CRM 服务器
创建服务终结点配置
配置 ACS
为事件注册一个服务终结点步骤
测试终结点注册
连接到 Microsoft Dynamics CRM 服务器
请按照下面的步骤使用插件注册工具连接到 Microsoft Dynamics 365 服务器。
运行 Plug-in Registration 工具。
选择“创建新连接”。
在“登录”对话框中,选择与要用其注册服务终结点的 Microsoft Dynamics 365 服务器对应的部署类型单选按钮。 “本地”单选按钮包括 IFD 部署,“联机”按钮针对 Microsoft Dynamics CRM Online 的 Windows Live 提供商,“Office 365”按钮针对 Microsoft Dynamics CRM Online 的 Microsoft Online Services 提供商。
联机部署的登录表单
本地部署的登录表单
如果您检查“始终显示可用组织列表”,在您选择“登录”后,将呈现您所属的组织列表。 这使您能够选择要用其注册服务终结点的组织。 否则,使用您的默认组织。
输入有关服务器和登录帐户的指示信息,然后选择“登录”。
创建服务终结点配置
请按照下面的步骤注册 Microsoft Azure 服务终结点。
选择要用其注册服务终结点的组织的选项卡。
在工具栏选项卡中,选择“注册”,然后选择“注册新服务终结点”。
如下图所示以及后面表中所述,使用与您的解决方案相关的信息来填写“服务终结点注册”对话框。 确保您指定的合同与解决方案监听程序应用程序使用的合同相同。
.jpeg)
UI 元素
description
名称(字段)
您的服务终结点注册的名称。
说明(字段)
此终结点注册的说明。
解决方案命名空间(字段)
解决方案的服务命名空间的名称。
路径(字段)
您项目的路径。 例如,如果是 https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo 的 URL 服务终结点,那么路径为 TwoWayService/Demo。
合同(下拉菜单)
终结点合同。 监听程序应用程序必须使用此合同来读取已发布的消息。 有关详细信息,请参阅为 Windows Azure 解决方案编写监听程序。
声明(下拉菜单)
发送到 Microsoft Azure 的声明。 对标准声明使用“无”。 指定“用户 ID”或“用户信息”以便发送有关登录用户的其他信息。
联合模式(复选框)
选中此框以便使用联合模式。
ID(字段)
使用终结点配置 ID 自动填写的不可写字段。
保存并配置 ACS(按钮)
保存您输入的配置,并自动执行 ACS 配置过程。 提供完成主题演练: 配置 Microsoft Azure ACS 与 Microsoft Dynamics CRM 2015 集成 中所述内容的交互式方式。
保存并验证身份(按钮)
保存您输入的配置,并验证 ACS 是否配置正确。
保存(按钮)
保存您输入的配置并关闭对话框。
如果您尚未配置 ACS 与 Microsoft Dynamics 365 的集成,并且希望插件注册工具为您执行配置,请选择“保存并配置 ACS”,然后按照本演练下一部分中的说明操作。 如果已经配置了 ACS ,请选择“保存并验证身份验证”或“保存”,并继续按照 为事件注册一个服务终结点步骤 中的说明操作。
配置 ACS
请按照下面的步骤配置 Microsoft Azure Active Directory 访问控制服务 (ACS)。
选择“保存并配置 ACS”后,会出现“ACS 配置”对话框。 按下表所述将相应的数据值输入到窗体字段中。
字段名称
描述
管理密钥
您的解决方案的管理密钥。 您可以从 Azure 管理门户 获得该密钥值。
获取服务总线命名空间的管理密钥
在左窗格中,选择“服务总线”,然后在列表中选择目标命名空间。
在页面底部,选择“连接信息”。
在“访问连接信息”对话框中显示“默认密钥”。 这是管理密钥。
备注
如果您更改了对称密钥,请将该密钥而不是默认密钥输入到“管理密钥”字段。 如果您未这样做,可能会收到错误,附带类似“ACS50012:身份验证失败”的说明。
证书文件
用于配置 Microsoft Dynamics 365 与 Microsoft Azure 集成的公用证书文件。
对于 Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 2015 更新,您可以从服务器下载此证书文件。 在 Microsoft Dynamics 365 Web 应用程序中,选择“设置 > 自定义”,然后选择“开发人员资源”。 使用以下“Microsoft Azure 服务总线 颁发者证书”下提供的链接下载并保存证书文件。
颁发者名称
颁发者的名称。 此名称必须与用于为 Microsoft Azure 集成配置 Microsoft Dynamics 365 的名称相同。 您可以从前面的说明中提到的“开发人员资源”网页获得颁发者名称。
有关详细信息,请参阅配置 Azure 与 Microsoft Dynamics CRM 2015 集成。
选择“配置 ACS”。 在窗体的输出区域显示配置过程的日志。
选择“关闭”。
在“服务终结点注册”对话框中,选择“保存并验证身份验证”。 验证完成以后,您可以关闭对话框。
为事件注册一个服务终结点步骤
请按照下面的步骤在服务器终结点注册一个事件步骤。
选择以前在工具的树视图中注册的服务终结点。
导航到“注册”菜单,并选择“注册新步骤”。
如下图所示为帐户创建事件填写“注册新步骤”对话框。
.jpeg)
选择“注册新步骤”。
无论何时创建客户,Microsoft Dynamics 365 现在都会将包含执行上下文的当前消息发布到服务总线。 该发布将异步执行,不会立即执行。
测试终结点注册
注册终结点以后,您可以测试它。 监听程序必须正在运行或者是目标终结点上的可用队列,以便从插件发布到服务总线。
针对已为其注册服务终结点的同一组织打开 Microsoft Dynamics 365 web 应用程序。
选择“创建”按钮
,然后选择“客户”。将客户名称(如 Adventure Works Cycle)输入到“客户名称”字段,然后选择“保存”。
等待大概 10 分钟,以便发布到 Microsoft Azure 服务总线。
选择“设置 > 系统作业”。
打开具有与您为服务终结点指定的同一名称的系统作业。 检查状态以便查看发布是成功、正在等待还是失败。
如果需要,通过选择工具树视图中的终结点并选择“取消注册”,可以立即取消注册终结点。
另请参阅
Microsoft Dynamics CRM 2015 的 Azure 扩展
Azure 与 Microsoft Dynamics CRM 的集成
活动目录和基于声明的身份验证
© 2017 Microsoft。 保留所有权利。 版权