サーバー ベースの SharePoint 統合に対するカスタムクレームのマッピングの定義

SharePoint とのサーバーベースの統合の場合、Dynamics 365 Customer Engagement (on-premises) は、SharePoint に格納されているドキュメントにアクセスする Customer Engagement ユーザーを、クレームを使用して、認証して許可します。 クレームベース認証の詳細については、 SharePoint 2013 におけるクレームベースの IDを参照してください。

既定では、Customer Engagement は、SharePoint との統合に次の要求を使用します。

シナリオ	請求
Customer Engagement と SharePoint Online	NameId (PUID) Dynamics 365 Customer Engagement (on-premises) と SharePoint が ユーザー ID について Azure Active Directory を共有します。
Customer Engagement と SharePoint オンプレミス	SMTP (email) ユーザー ID について共有されたアクティブなディレクトリ インフラストラクチャはありません。要求はSMTP アドレスとして送信されます。 要求は、Dynamics 365 Customer Engagement (on-premises) の WindowsLiveID フィールドから選択され、SharePoint の仕事用メール アドレスにマッピングされます。
Dynamics 365 Customer Engagement (on-premises) および SharePoint Online	SMTP (email) ユーザー ID について共有されたアクティブなディレクトリ インフラストラクチャはありません。要求は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 の両方が、ユーザー ID について Microsoft Windows Server Active Directory を共有します。

Customer Engagement で使用される規定値以外の値を使用して、SharePoint で Customer Engagement ユーザーを認証および承認するために、Customer Engagement でのユーザー定義の要求のマッピングの指定に UserMapping エンティティを使用できます。 たとえば、"E-mail" の代わりにユーザーの "名" と "姓" を使用して、SharePoint で Customer Engagement のユーザーを認証できます。 ユーザー定義の要求のマッピングは、Customer Engagement によって使用される既定の要求のマッピングを上書きします。 複数のユーザー定義の要求のマッピングを Customer Engagement で定義できます。 既定では、システム管理者ロールを持つユーザーのみが、UserMapping エンティティにアクセスできます。

ユーザー定義の要求のマッピングを Customer Engagement で定義するには、UserMapping エンティティ レコードを作成し、次の表に示す属性値を指定します。

Attribute	価値	説明設定
UserMapping.PartnerApplicationType	- 0: SharePoint - 1: 内部のみで使用します。	この要求のマッピングが使用されるパートナー アプリケーションの種類です。 現在のリリースでは、0 (SharePoint) のみがサポートされます。
UserMapping.SystemUserAttributeName	文字列値	SystemUser (ユーザー) エンティティ内の属性の論理名。そのエンティティ内のクレームの値が使用されます。 注: ユーザー定義の要求のマッピングに使用される属性に値が含まれていない場合、既定の要求のマッピングが Customer Engagement によって使用されます。 たとえば、ユーザー定義の要求のマッピングに、属性としてユーザーの名を使用したい場合、ユーザーの名が見つからないときは、Customer Engagement は既定の要求のマッピング (PUID または E-mail) を使用します。
UserMapping.ClaimType	文字列値	SharePoint に送信する要求の種類を指定します。 要求の種類の一覧については、「ClaimTypes のメンバー」を参照してください。 注: 参照されるクレームの種類の一覧は、参考のためです。 ここに記載した要求の種類のすべてが SharePoint によってサポートされているとは限らず、また SharePoint によってサポートされているすべての要求の種類を含んでるとは限りません。

次のサンプル コードは、UserMapping エンティティを使用して、ユーザー定義の要求のマッピングを定義する方法を示しています。

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

Note

有効な値を持つ UserMapping エンティティのインスタンスは、Customer Engagement によって使用される既定のマッピングを上書きします。

既定では、SharePoint は、NameId (PUID)、SMTP (E-mail)、および UPN (ユーザー プリンシパル名) の要求の種類をサポートします。 その他の種類の要求を渡す場合は、対応する要求の種類のマッピングを SharePoint で作成する必要もあります。 詳細:New-SPClaimTypeMapping

関連情報

UserMapping エンティティ
SharePoint と Microsoft Dynamics 365 Customer Engagement (on-premises) との統合