定義 SharePoint 伺服器架構整合的自訂宣告對應

文章
03/04/2017

發佈日期： 2017年1月

適用對象： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

針對與 SharePoint 的伺服器架構整合，Microsoft Dynamics 365 會使用宣告來驗證並授權 Dynamics 365 使用者存取儲存在 SharePoint 中的文件。如需宣告型驗證的詳細資訊，請參閱 SharePoint 2013 中的宣告型身分識別。

根據預設，Dynamics 365 使用下列宣告與 SharePoint 整合：

情況	理賠
Dynamics 365 (線上) 和 SharePoint Online	NameId (PUID) Dynamics 365 和 SharePoint 都會共用 Microsoft Azure Active Directory 以進行使用者身分識別。
Dynamics 365 (線上) 和 SharePoint 內部部署	SMTP (email) 沒有適用於使用者身分識別的共用 Active Directory 基礎結構；宣告已傳送做為 SMTP 位址。宣告是從 Dynamics 365 的 WindowsLiveID 欄位中所選取，並對應至 SharePoint 中的工作電子郵件地址。
Dynamics 365 內部部署和 SharePoint Online	SMTP (email) 沒有適用於使用者身分識別的共用 Active Directory 基礎結構；宣告已傳送做為 SMTP 位址。宣告是從 Dynamics 365 的 PrimaryEmailAddess 欄位中所選取，並對應至 SharePoint 中的工作電子郵件地址。
Dynamics 365 內部部署和 SharePoint 內部部署	Security Identifier (SID) Dynamics 365 與 SharePoint 都會共用 Microsoft Windows Server Active Directory 以進行使用者身分識別。

您可以使用 UserMapping 實體指定 Dynamics 365 中的自訂宣告對應使用另一個值，而不要使用 Dynamics 365 用來在 SharePoint 中驗證和授權 Dynamics 365 使用者的預設值。例如，您可以使用使用者的「姓氏」和「名字」，而不使用「電子郵件」來驗證 SharePoint 中的 Dynamics 365 使用者。自訂宣告對應會覆寫 Dynamics 365 使用的預設宣告對應。您可以在 Dynamics 365 中定義多個自訂宣告對應。根據預設，只有具有系統管理員角色的使用者才能存取 UserMapping 實體。

若要在 Dynamics 365 中定義自訂宣告對應，請建立 UserMapping 實體記錄並指定下表中所列的屬性值。

屬性	值	描述
UserMapping.PartnerApplicationType	0：SharePoint 1：僅供內部使用。	即將使用這個宣告對應的合作夥伴應用程式類型。在目前版本中，僅支援 0 (SharePoint)。
UserMapping.SystemUserAttributeName	字串值	SystemUser (使用者) 實體中屬性的邏輯名稱，將使用其中的宣告值。備註如果用於自訂宣告對應的屬性未包含值，Dynamics 365 會使用預設宣告對應。例如，如果您想要使用使用者的名字做為自訂宣告對應的屬性，但使用者的名字遺失，則 Dynamics 365 會使用預設宣告對應 (PUID 或電子郵件)。
UserMapping.ClaimType	字串值	指定要傳送至 SharePoint 的宣告類型。如需宣告類型的清單，請參閱 ClaimTypes 成員。備註參考的宣告類型清單僅供參考。此處列出的所有宣告類型可能不受 SharePoint 支援，或是可能未包含 SharePoint 支援的所有宣告類型。

下列範例程式碼顯示如何使用 UserMapping 實體定義自訂宣告對應。

UserMapping customMapping = new UserMapping
{
   PartnerApplicationType = new OptionSetValue(0),
   SystemUserAttributeName = "personalemailaddress",
   ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);

備註

包含有效值的任何 UserMapping 實體執行個體都將覆寫 Dynamics 365 使用的預設宣告對應。

根據預設，SharePoint 支援下列宣告類型：NameId (PUID)、SMTP (電子郵件) 和 UPN (使用者主體名稱)。如果要傳遞任何其他類型的宣告，您也必須在 SharePoint 中建立對應的宣告類型對應。其他資訊：New-SPClaimTypeMapping

另請參閱

UserMapping 實體訊息和方法
 整合 Microsoft Dynamics 365 與 SharePoint

Microsoft Dynamics 365

分享方式：

定義 SharePoint 伺服器架構整合的自訂宣告對應

另請參閱

更多資源