Freigeben über

Definieren von benutzerdefinierter Anspruchszuordnung für serverbasierte SharePoint-Integration

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Für die serverbasierte Integration mit SharePoint verwendet Microsoft Dynamics CRM Online Ansprüche zur Authentifizierung und Autorisierung von Dynamics 365-Benutzern 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 CRM Online die folgenden Anspruchszuordnungen zur Integration mit SharePoint:

  • SharePoint Online: NameId (PUID)

  • SharePoint (lokal): SMTP (E-Mail)

Sie können die UserMapping-Entität verwenden, um benutzerdefinierte Anspruchszuordnungen in Dynamics 365 anzugeben, um einen anderen Wert als den Standardwert zu verwenden, den CRM Online nutzt, um Dynamics 365-Benutzer in SharePoint zu authentifizieren und autorisieren. Beispielsweise können Sie festlegen, dass der "Nachname" und "Vorname" des Benutzers und nicht "E-Mail" verwendet wird, um Dynamics 365-Benutzer in SharePoint zu authentifizieren. Benutzerdefinierte Anspruchszuordnungen werden im Allgemeinen für die Integration mit SharePoint (lokal) verwendet. Benutzerdefinierte Anspruchszuordnungen überschreiben die Standard-Anspruchszuordnungen, die Dynamics 365 verwendet. Sie können mehrere benutzerdefinierte Anspruchszuordnungen in Dynamics 365 definieren. Standardmäßig haben nur Benutzer mit Systemadministratorrolle Zugriff auf dieUserMapping-Entität.

Hinweis

Für Microsoft Dynamics CRM Online-Organisationen steht diese Funktion nur zur Verfügung, wenn die Organisation auf Dynamics CRM Online 2015 Update 1 aktualisiert hat. Diese Funktion ist nicht für Dynamics CRM (lokal) verfügbar.

Erstellen Sie zum Definieren einer benutzerdefinierten Anspruchszuordnung in Dynamics 365 einen UserMapping-Entitätsdatensatz, und geben Sie die Attributwerte an, die in der folgenden Tabelle aufgeführt werden.

Attribut

Wert

Beschreibung

UserMapping.PartnerApplicationType

  • 0: SharePoint

  • 1: Nur zur internen Verwendung.

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 Attribut, das für benutzerdefinierte Anspruchszuordnung verwendet wird, keinen Wert enthält, wird die standardmäßige Anspruchszuordnung vom Dynamics 365 verwendet. Wenn Sie z. B. auswählen, den Vornamen des Benutzers als das Attribut für die benutzerdefinierte Anspruchszuordnung zu verwenden und der Vorname eines Benutzers fehlt, verwendet Dynamics 365 die Standard-Anspruchszuordnung Standard (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 referenzierte Anspruchstypliste 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);

Hinweis

Jede Instanz der UserMapping-Entität mit gültigen Werten überschreibt die Standard-Anspruchszuordnungen, die von CRM Online verwendet werden.

Standardmäßig unterstützt SharePoint die folgenden Anspruchstypen: NameId (PUID), SMTP (E-Mail), und UPN (Benutzerprinzipalname). Wenn Sie einen Anspruch eines anderen Typs als die standardmäßig von SharePoint unterstützten übergeben, müssen Sie auch entsprechende Anspruchstypzuordnungen in SharePoint erstellen.Weitere Informationen:New-SPClaimTypeMapping

Siehe auch

UserMapping-Entitätsmeldungen und -methoden
Integrieren Sie Microsoft Dynamics CRM 2015 in SharePoint

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright