配置基于服务器认证的Dynamics 365 Customer Engagement和SharePoint Online集成
我是微软Dynamics 365 & Power Platform方面的工程师罗勇，也是2015年7月到2018年6月连续三年Dynamics CRM/Business Solutions方面的微软最有价值专家(Microsoft MVP)，欢迎关注我的微信公众号 MSFTDynamics365erLuoYong ，回复384或者20191215可方便获取本文，同时可以在第一间得到我发布的最新博文信息，follow me!
本文主要根据官方文档 Configure server-based authentication with Customer Engagement (on-premises) and SharePoint Online ，做了一些补充和说明，方便阅读者配置成功。
官方文档首先讲了 Permissions required ，可以看到需要一个具有System Administrator (中文版的话则是 系统管理员) 角色的Dynamics 365 Customer Engagement账号，我这里用的是 luoyong\crmadmin （或者说是 crmadmin@luoyong.me），还需要一个你要连接的SharePoint Online所在订阅的具有 Global Administrator 的账号，我这里用的是 admin@CRM558602.onmicrosoft.com 。还需要的工具就是要在Dynamics 365 Customer Engagement上安装 Microsoft Dynamics CRM Hybrid Connector 组件。这个组件是免费的，记得安装，安装时候的地区不要选China，选香港特别行政区或者其他地方。
还需要如下两个工具来辅助，请安装到Dynamics 365部署服务所在服务器：
Microsoft Online Services Sign-In Assistant for IT Professionals Beta
Azure Active Directory Module for Windows PowerShell (64-bit version)
开始第一个配置步骤，也就是官方配置手册中的 Prepare the certificate 步骤，到Dynamics 365部署服务所在服务器上执行如下的PowerShell命令 (我这里更改为了自己的命令)：
$CertificateScriptWithCommand = ".\CertificateReconfiguration.ps1 -certificateFile c:\Personalcertfile.pfx -password yourpassword -updateCrm -certificateType S2STokenIssuer -serviceAccount luoyong\crmsvc -storeFindType FindBySubjectDistinguishedName" Invoke-Expression -command $CertificateScriptWithCommand
你会发现执行报错，如下图：
怎么解决？需要切换到Dynamics 365 Customer Engagement的安装目录，例如使用 cd "C:\Program Files\Dynamics 365\Tools" 切换后就可以了：
然后以管理员身份打开PowerShell执行如下命令：
Import-Module MSOnline -force
Import-Module MSOnlineExt -force
然后执行如下命令连接到Office 365：
$msolcred = get-credential connect-msolservice -credential $msolcred
然后再顺次执行如下命令：，当然c:\Personalcertfile.pfx 和 c:\Personalcertfile.cer 两个文件要存在，密码要正确。
$STSCertificate = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2 -ArgumentList c:\Personalcertfile.pfx, F2HrCf3H $PFXCertificateBin = $STSCertificate.GetRawCertData() $Certificate = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2 $Certificate.Import(“c:\Personalcertfile.cer”) $CERCertificateBin = $Certificate.GetRawCertData() $CredentialValue = [System.Convert]::ToBase64String($CERCertificateBin)
下面代码中的 $RootDomain 的值请换成自己的。
$RootDomain = “CRM558602.onmicrosoft.com” $CRMAppId = "00000007-0000-0000-c000-000000000000" New-MsolServicePrincipalCredential -AppPrincipalId $CRMAppId -Type asymmetric -Usage Verify -Value $CredentialValue $CRM = Get-MsolServicePrincipal -AppPrincipalId $CRMAppId $ServicePrincipalName = $CRM.ServicePrincipalNames $ServicePrincipalName.Remove("$CRMAppId/$RootDomain") $ServicePrincipalName.Add("$CRMAppId/$RootDomain") Set-MsolServicePrincipal -AppPrincipalId $CRMAppId -ServicePrincipalNames $ServicePrincipalName
Add-PSSnapin Microsoft.Crm.PowerShell $setting = New-Object "Microsoft.Xrm.Sdk.Deployment.ConfigurationEntity" $setting.LogicalName = "ServerSettings" $setting.Attributes = New-Object "Microsoft.Xrm.Sdk.Deployment.AttributeCollection" $attribute1 = New-Object "System.Collections.Generic.KeyValuePair[String, Object]" ("S2SDefaultAuthorizationServerPrincipalId", "00000001-0000-0000-c000-000000000000") $setting.Attributes.Add($attribute1) $attribute2 = New-Object "System.Collections.Generic.KeyValuePair[String, Object]" ("S2SDefaultAuthorizationServerMetadataUrl", "https://accounts.accesscontrol.windows.net/metadata/json/1") $setting.Attributes.Add($attribute2) Set-CrmAdvancedSetting -Entity $setting
剩下的就是Dynamics 365 Customer Engagement中的配置了，当然再配置之前现在SharePoint Online中新建一个站点，比如我这里是新建了 https://crm558602.sharepoint.com/sites/D365Demo 这个站点，通过如下PowerShell命令获取 tenant ID
$CRMContextId = (Get-MsolCompanyInformation).ObjectID $CRMContextId
以具有系统管理员的角色登录到Dynamics 365 Customer Engagement，导航到 【设置】>【文档管理】，点击 启用基于服务器的 SharePoint 集成 ，对于 SharePoint 网站，选择联机，然后选择下一步。在“准备网站”阶段，输入以下信息。输入 SharePoint Online 网站集 URL，我使用的是 https://crm558602.sharepoint.com/sites/D365Demo ，输入租户 ID，我这里使用的是前面命令获取的 e44473fd-1587-4556-a3ce-1d1d6280b241 。如果配置的错误是 Failed to connect to SharePointSite 的话，根据我的文章 Dynamics 365 启用跟踪及读取跟踪文件工具 查看日志，若日志中说明是有类似下面的错误导致的：
Crm Exception: Message: At least 1 Claim must not be NULL, current claims are : smtp= , ErrorCode: -2147220970
请参考 Mehmet Ozdemir 的文章CRM 2016 On-Premise to SharePoint Online Gotcha’s ，简单说就是为用户配置一个Office 365邮箱，例如，我的主要电子邮件配置为 admin@CRM558602.onmicrosoft.com ：
这是验证通过的截图：
这是配置完成的截图：
点击上图中的【文档管理设置向导】连接，我的SharePoint站点设置如下：
完成后我上传一个文档看看：
上传成功后点击 【打开位置】按钮
的确在SharePoint Online中可以看到这个文档，URL是 https://crm558602.sharepoint.com/sites/D365Demo/account/Forms/AllItems.aspx?RootFolder=%2Fsites%2FD365Demo%2Faccount%2FA%2D%20Datum%20%E5%85%AC%E5%8F%B8%20%28%E7%A4%BA%E4%BE%8B%29%2Fincident%2F%E6%B5%8B%E8%AF%95%E6%A1%88%E4%BE%8B%5F4F76365F5A1BEA11A865000D3A6F652B&FolderCTID=0x01200007D8B02046624842A9980305B2591CA9 。
