Aangepaste claimtoewijzing voor op SharePoint-server gebaseerde integratie definiëren
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Voor op een server gebaseerde integratie met SharePoint gebruikt Microsoft Dynamics 365 claims voor het verifiëren en autoriseren van Dynamics 365-gebruikers voor toegang tot de documenten die zijn opgeslagen in SharePoint. Zie Op claims gebaseerde identiteit in SharePoint 2013 voor meer informatie over op claims gebaseerde verificatie.
Standaard maakt Dynamics 365 gebruik van de volgende claims voor integratie met SharePoint:
Scenario |
Claims |
|---|---|
Dynamics 365 (online) en SharePoint Online |
NameId (PUID) Zowel Dynamics 365 als SharePoint delen Microsoft Azure Active Directory voor gebruikersidentiteit. |
Dynamics 365 (online) en SharePoint on-premises |
SMTP (email) Geen gedeelde geen active directory-infrastructuur voor gebruikersidentiteit; claims verzonden als SMTP-adres. De claims worden geselecteerd uit het veld WindowsLiveID in Dynamics 365 en toegewezen aan werke-mailadressen van SharePoint. |
Dynamics 365 on-premises en SharePoint Online |
SMTP (email) Geen gedeelde geen active directory-infrastructuur voor gebruikersidentiteit; claims verzonden als SMTP-adres. De claims worden geselecteerd uit het veld PrimaryEmailAddess in Dynamics 365 en toegewezen aan werke-mailadressen van SharePoint. |
Dynamics 365 on-premises en SharePoint on-premises |
Security Identifier (SID) Zowel Dynamics 365 als SharePoint delen Microsoft Windows Server Active Directory voor gebruikersidentiteit. |
U kunt de entiteit UserMapping gebruiken om aangepaste claimtoewijzingen op te geven in Dynamics 365 om een andere waarde te gebruiken dan de standaardwaarde die door Dynamics 365 wordt gebruikt om Dynamics 365-gebruikers in SharePoint te verifiëren en te autoriseren. Zo kunt u bijvoorbeeld de "achternaam" en "voornaam" van de gebruiker gebruiken in plaats van "e-mail" voor het verifiëren van Dynamics 365-gebruikers in SharePoint. Aangepaste claimtoewijzingen vervangen de standaardclaimtoewijzingen die worden gebruikt door Dynamics 365. U kunt meerdere aangepaste claimtoewijzingen definiëren in Dynamics 365. Standaard hebben alleen gebruikers met de beveiligingsrol Systeembeheerder toegang tot de entiteit UserMapping.
U kunt een aangepaste claimtoewijzing definiëren in Dynamics 365 door een entiteitsrecord UserMapping te maken en de kenmerkwaarden die staan vermeld in de volgende tabel op te geven.
Kenmerk |
Waarde |
Beschrijving |
|---|---|---|
UserMapping.PartnerApplicationType |
|
Het type partnertoepassing waarvoor deze claimtoewijzing moet worden gebruikt. In de huidige versie wordt alleen 0 (SharePoint) is ondersteund . |
UserMapping.SystemUserAttributeName |
Tekenreekswaarde |
De logische naam van het kenmerk in de (gebruikers)entiteit SystemUser van waaruit de waarde voor de claims zal worden gebruikt. Notitie Als het kenmerk dat wordt gebruikt voor aangepaste claimtoewijzingen geen waarde bevat, wordt de standaardclaimtoewijzing gebruikt door Dynamics 365. Als u bijvoorbeeld de voornaam van de gebruiker als kenmerk voor aangepaste claimtoewijzing wilt gebruiken en de voornaam van een gebruiker ontbreekt, wordt in Dynamics 365 gebruikgemaakt van de standaardclaimtoewijzing (UID of e-mail). |
UserMapping.ClaimType |
Tekenreekswaarde |
Geef het claimtype op dat naar SharePoint-moet worden verzonden. Zie ClaimTypes-leden voor een lijst van claimtypen. Notitie De lijst met claimtypen waarnaar wordt verwezen dient uitsluitend ter referentie. Alle hier vermelde claimtypen worden mogelijk niet ondersteund door SharePoint of bevatten niet alle claimtypen die worden ondersteund door SharePoint. |
De volgende voorbeeldcode toont hoe een aangepaste claimtoewijzing kan worden gedefinieerd met de entiteit UserMapping.
UserMapping customMapping = new UserMapping
{
PartnerApplicationType = new OptionSetValue(0),
SystemUserAttributeName = "personalemailaddress",
ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);
Notitie
Elk willekeurig exemplaar van de entiteit UserMapping met geldige waarden vervangt de standaardclaimtoewijzingen die worden gebruikt door Dynamics 365.
Standaard ondersteunt SharePoint de volgende claimtypen: NameId (PUID), SMTP (e-mail) en UPN (user principal name). Als u een claim van een ander type doorgeeft, moet u tevens overeenkomstige claimtypetoewijzingen maken in SharePoint.Meer informatie:New-SPClaimTypeMapping
Zie ook
Berichten en methoden van de entiteit UserMapping
Microsoft Dynamics 365 integreren met SharePoint
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht