Definieren von benutzerdefinierter Anspruchszuordnung für SharePoint serverbasierte Integration
Für die serverbasierte Integration mit SharePoint verwendet Dynamics 365 Customer Engagement (on-premises) Ansprüche zur Authentifizierung und Autorisierung von Customer Engagement-Benutzenden für den Zugriff auf in SharePoint gespeicherte Dokumente. Weitere Informationen zur anspruchsbasierten Authentifizierung finden Sie unter Anspruchsbasierte Identität in SharePoint 2013.
Standardmäßig verwendet Customer Engagement die folgenden Ansprüche zur Integration mit SharePoint:
| Szenario | Ansprüche |
|---|---|
| Customer Engagement und SharePoint Online | NameId (PUID)Sowohl Dynamics 365 Customer Engagement (on-premises) und SharePoint teilen Azure Active Directory für die Benutzeridentität. |
| Customer Engagement und SharePoint Lokal | SMTP (email)Keine freigegebene Active Directory-Infrastruktur für Benutzeridentität; SMTP-Adresse als Ansprüche gesendet. Die Ansprüche werden vom Feld WindowsLiveID in Dynamics 365 Customer Engagement (on-premises) undsssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss ausgewählt und der E-Mail-Adresse von SharePoint zugeordnet. |
| Dynamics 365 Customer Engagement (on-premises) und SharePoint Online | SMTP (email)Keine freigegebene Active Directory-Infrastruktur für Benutzeridentität; SMTP-Adresse als Ansprüche gesendet. Die Ansprüche werden vom Feld PrimaryEmailAddess in Dynamics 365 Customer Engagement (on-premises) ausgewählt und in der E-Mail-Adresse von SharePoint zugeordnet.„” |
| Dynamics 365 Customer Engagement (on-premises) und SharePoint (lokal) | SMTP (email)Sowohl Dynamics 365 Customer Engagement (on-premises) als auch SharePoint nutzen Microsoft Windows Server Active Directory für die Benutzeridentität. |
Sie können die Entität UserMapping verwenden, um angepasste Zuordnungen von Ansprüchen in Customer Engagement festzulegen, um einen anderen Wert als den Standardwert zu verwenden, der von Customer Engagement verwendet wird, um Benutzer von Customer Engagement in SharePoint zu authentifizieren und zu autorisieren. So können Sie z.B. den „Nachnamen“ und „Vornamen“ des Benutzers anstelle von „E-Mail“ verwenden, um die Benutzer von Customer Engagement in SharePoint zu authentifizieren. Angepasste Zuordnungen von Ansprüchen setzen die von Customer Engagement verwendeten Standard-Zuordnungen von Ansprüchen außer Kraft. Sie können mehrere angepasste Zuordnungen von Ansprüchen in Customer Engagement definieren. Standardmäßig haben nur Benutzer mit Systemadministratorrolle Zugriff auf die UserMapping-Entität.
Um eine angepasste Zuordnung von Ansprüchen in Customer Engagement zu definieren, erstellen Sie einen Datensatz der Entität UserMapping und geben die in der folgenden Tabelle aufgeführten Attributwerte an.
| Attribute | Wert | Beschreibung des Dataflows |
|---|---|---|
UserMapping.PartnerApplicationType |
- 0: SharePoint- 1: Nur für den internen Gebrauch. |
Der Partneranwendungstyp, für den diese Anspruchszuordnung verwendet werden soll. In der aktuellen Version wird nur 0 (SharePoint) unterstützt. |
UserMapping.SystemUserAttributeName |
Zeichenfolgenwert | Der logische Name des Attributs in der SystemUser (Benutzer)-Entität, aus der der Wert für die Ansprüche verwendet wird. Hinweis: Wenn das für die angepasste Zuordnung von Ansprüchen verwendete Attribut keinen Wert enthält, wird die Standardzuordnung von Ansprüchen durch Customer Engagement verwendet. Wenn Sie z.B. den Vornamen des Benutzers als Attribut für die angepasste Zuordnung von Ansprüchen verwenden möchten und der Vorname eines Benutzers fehlt, verwendet Customer Engagement die standardmäßige Zuordnung von Ansprüchen (PUID oder E-Mail). |
UserMapping.ClaimType |
Zeichenfolgenwert | Geben Sie den Anspruchstyp an, der an SharePoint gesendet werden soll. Eine Liste der Anspruchstypen finden Sie unter ClaimTypes-Mitglieder. Hinweis: Die Liste der genannten Anspruchsarten dient nur als Referenz. Alle Anspruchstypen, die dort aufgeführt sind, werden ggf. von SharePoint nicht unterstützt, oder enthalten ggf. nicht alle Anspruchstypen, die von SharePoint unterstützt werden. |
Der folgende Beispielcode zeigt, wie Sie eine benutzerdefinierte Anspruchszuordnung mithilfe der UserMapping-Entität definieren.
UserMapping customMapping = new UserMapping
{
PartnerApplicationType = new OptionSetValue(0),
SystemUserAttributeName = "personalemailaddress",
ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);
Notiz
Jede Instanz der Entität UserMapping mit gültigen Werten setzt die von Customer Engagement verwendeten Standardzuordnungen von Ansprüchen außer Kraft.
Standardmäßig unterstützt SharePoint die folgenden Anspruchstypen: NameId (PUID), SMTP (E-Mail), und UPN (Benutzerprinzipalname). Wenn Sie einen Anspruch eines anderen Typs übergeben, müssen Sie auch entsprechende Anspruchstypzuordnungen in SharePoint erstellen. Weitere Informationen:New-SPClaimTypeMapping
Siehe auch
UserMapping-Entität
Integrieren Microsoft Dynamics 365 Customer Engagement (on-premises) mit SharePoint