對於與 SharePoint 的伺服器型整合,Dynamics 365 Customer Engagement (on-premises) 使用宣告來驗證和授權 Customer Engagement 使用者存取儲存在 SharePoint 中的文件。 如需宣告型驗證的詳細資訊,請參閱 SharePoint 2013 中的宣告型身分識別。
Customer Engagement 預設會使用下列宣告來與 SharePoint 整合:
| Scenario | Claims |
|---|---|
| Customer Engagement 和 SharePoint Online | NameId (PUID)Dynamics 365 Customer Engagement (on-premises) 和 SharePoint 都會共用 Azure Active Directory 以取得使用者身分識別。 |
| Customer Engagement 和 SharePoint 內部部署 | SMTP (email)沒有使用者身分識別的共用 Active Directory 基礎結構;以 SMTP 位址傳送的宣告。 宣告是從 Dynamics 365 Customer Engagement (on-premises) 的 WindowsLiveID 欄位中挑選,並從 SharePoint 對應至工作電子郵件地址。 |
| Dynamics 365 Customer Engagement (on-premises) 和 SharePoint Online | SMTP (email)沒有使用者身分識別的共用 Active Directory 基礎結構;以 SMTP 位址傳送的宣告。 宣告是從 Dynamics 365 Customer Engagement (on-premises) 的 PrimaryEmailAddess 欄位中挑選,並從 SharePoint 對應至工作電子郵件地址。 |
| Dynamics 365 Customer Engagement (on-premises) 和 SharePoint 內部部署 | SMTP (email)Dynamics 365 Customer Engagement (on-premises) 和 SharePoint 都會共用 Microsoft Windows Server Active Directory 以取得使用者身分識別。 |
您可以使用 UserMapping 實體,在 Customer Engagement 中指定自訂宣告對應,以使用 Customer Engagement 所用預設值以外的值來驗證和授權 SharePoint 中的 Customer Engagement 使用者。 例如,在 SharePoint 中驗證 Customer Engagement 使用者時,您可以使用的是使用者的「姓氏」和「名字」,而不是「電子郵件」。 自訂宣告對應會覆寫 Customer Engagement 所使用的預設宣告對應。 您可以在 Customer Engagement 中定義多個自訂宣告對應。 預設只有具有系統管理員角色的使用者才能存取實體 UserMapping。
若要在 Customer Engagement 中定義自訂宣告對應,請建立 UserMapping 實體記錄,並指定下表中列出的屬性值。
| Attribute | 價值觀 | Description |
|---|---|---|
UserMapping.PartnerApplicationType |
-
0:SharePoint- 1:僅供內部使用。 |
即將使用此宣告對應的合作夥伴應用程式類型。 在目前版本中,僅支援 0 (SharePoint)。 |
UserMapping.SystemUserAttributeName |
字串值 |
SystemUser (使用者) 實體中屬性的邏輯名稱,將從中使用宣告的值。
注意:如果用於自訂宣告對應的屬性不包含值,則 Customer Engagement 會使用預設宣告對應。 例如,如果您要用使用者的名字做為自訂宣告對應的屬性,但使用者的名字遺失時,Customer Engagement 會使用預設宣告對應 (PUID 或電子郵件)。 |
UserMapping.ClaimType |
字串值 | 指定要傳送至 SharePoint 的宣告類型。 如需宣告類型的清單,請參閱 ClaimTypes 成員。 注意:參考的宣告類型清單僅供參考。 其中列出的所有宣告類型可能不受 SharePoint 支援,或可能不包含 SharePoint 支援的任何宣告類型。 |
下列範例程式碼示範如何使用 UserMapping 實體來定義自訂宣告對應。
UserMapping customMapping = new UserMapping
{
PartnerApplicationType = new OptionSetValue(0),
SystemUserAttributeName = "personalemailaddress",
ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);
備註
值有效的 UserMapping 實體的任何執行個體都會覆寫 Customer Engagement 所使用的預設宣告對應。
SharePoint 預設支援下列宣告類型:NameId (PUID)、SMTP (電子郵件) 和 UPN (使用者主體名稱)。 如果您要傳遞任何其他類型的宣告,也必須在 SharePoint 中建立相應的宣告類型對應。 其他資訊:New-SPClaimTypeMapping
另請參閱
UserMapping 實體
將 Microsoft Dynamics 365 Customer Engagement (on-premises) 與 SharePoint 整合