サーバー ベースの SharePoint 統合に対するユーザー定義要求のマッピングの定義

  • [アーティクル]

 

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

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

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

シナリオ

主張

Dynamics 365 (オンライン) および SharePoint Online

NameId (PUID)

Dynamics 365 と SharePoint がユーザー ID について Microsoft Azure Active Directory を共有します。

Dynamics 365 (オンライン) と SharePoint 設置型

SMTP (email)

ユーザー ID について共有されたアクティブなディレクトリ インフラストラクチャはありません。要求はSMTP アドレスとして送信されます。 要求は、Dynamics 365 の WindowsLiveID フィールドから選択され、SharePoint の勤務先電子メール アドレスにマッピングされます。

Dynamics 365 設置型および SharePoint Online

SMTP (email)

ユーザー ID について共有されたアクティブなディレクトリ インフラストラクチャはありません。要求はSMTP アドレスとして送信されます。 要求は、Dynamics 365 の PrimaryEmailAddess フィールドから選択され、SharePoint の勤務先電子メール アドレスにマッピングされます。

Dynamics 365 設置型および SharePoint 設置型

Security Identifier (SID)

Dynamics 365 と SharePoint の両方が、ユーザー ID について Microsoft Windows Server Active Directory を共有します。

Dynamics 365 で使用される規定値以外の値を使用して、SharePoint で Dynamics 365 ユーザーを認証および承認するために、Dynamics 365 でのユーザー定義の要求のマッピングの指定に UserMapping エンティティを使用できます。 たとえば、"E-mail" の代わりにユーザーの "名" と "姓" を使用して、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 または E-mail) を使用します。

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

関連項目

UserMapping エンティティのメッセージおよびメソッド
Microsoft Dynamics 365 を SharePoint と統合

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権