Del via


Definere brugerdefineret kravtilknytning for serverbaseret SharePoint-integration

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Ved serverbaseret integration med SharePoint bruger Microsoft Dynamics 365 krav til at godkende og give Dynamics 365-brugerne adgang til de dokumenter, der er lagret i SharePoint. Du kan finde flere oplysninger om kravsbaseret godkendelse under Kravsbaseret identitet i SharePoint 2013.

Som standard har Dynamics 365 følgende krav til integration med SharePoint:

Scenarie

Krav

Dynamics 365 (online) og SharePoint Online

NameId (PUID)

Både Dynamics 365 og SharePoint benytter deres bruger-id fra Microsoft Azure Active Directory.

Dynamics 365 (online) og SharePoint (i det lokale miljø)

SMTP (email)

Ingen delt Active Directory-infrastruktur til brugeridentitet. Krav sendes som SMTP-adresse. Krav plukkes fra feltet WindowsLiveID i Dynamics 365 og tilknyttes arbejdsmailadresser fra SharePoint.

Dynamics 365 (i det lokale miljø) og SharePoint Online

SMTP (email)

Ingen delt Active Directory-infrastruktur til brugeridentitet. Krav sendes som SMTP-adresse. Krav plukkes fra feltet PrimaryEmailAddess i Dynamics 365 og tilknyttes arbejdsmailadresser fra SharePoint.

Dynamics 365 til det lokale miljø og SharePoint til det lokale miljø

Security Identifier (SID)

Både Dynamics 365 og SharePoint benytter Microsoft Windows Server Active Directory som bruger-id.

Du kan bruge UserMapping-objektet til at angive brugerdefinerede kravtilknytninger i Dynamics 365 for at bruge en anden værdi end standardværdien, som bruges af Dynamics 365 til at godkende og tillade Dynamics 365-brugere i SharePoint. For eksempel kan du anvende brugerens "efternavn" og "fornavn" i stedet for "mailadresse" til at godkende Dynamics 365 brugere i SharePoint. Brugerdefinerede kravtilknytninger tilsidesætter standardkravtilknytninger, som bruges af Dynamics 365. Du kan definere flere brugerdefinerede kravtilknytninger i Dynamics 365. Som standard kan kun brugere med rollen Systemadministrator få adgang til UserMapping-objektet.

Når du vil definere en brugerdefineret kravtilknytning i Dynamics 365, skal du oprette en UserMapping-objektpost og bruge de attributværdier, der er angivet i følgende tabel.

Attribut

Værdi

Beskrivelse

UserMapping.PartnerApplicationType

  • 0: SharePoint

  • 1: Kun til intern brug.

Den partnerprogramtype, som kravtilknytningen skal bruges til. I den aktuelle version understøttes kun 0 (SharePoint).

UserMapping.SystemUserAttributeName

Strengværdi

Det logiske navn på attributten i SystemUser (bruger)objektet, som værdien til kravene anvendes fra.

Bemærk

Hvis attributten, der anvendes til brugerdefineret kravtilknytning, ikke indeholder en værdi, bruges standardkravtilknytningen af Dynamics 365. Hvis du f.eks. vil bruge fornavnet på brugeren som attributten for brugerdefineret kravtilknytning, og en brugers fornavn mangler, bruger Dynamics 365 standardkravtilknytningen (PUID eller mail).

UserMapping.ClaimType

Strengværdi

Angiv kravtypen, der skal sendes til SharePoint. Du kan få vist en liste over kravtyper under Kravtypemedlemmer.

Bemærk

Den nævnte kravtypeliste er kun til reference. Der er ikke nødvendigvis alle kravtyper, der vises der, som understøttes af SharePoint, eller de indeholder muligvis ikke alle former for kravtyper, der understøttes af SharePoint.

Følgende eksempelkode viser, hvordan du kan definere en brugerdefineret kravtilknytning ved hjælp af UserMapping-objektet.

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

Bemærk

Alle forekomster af UserMapping-objektet med gyldige værdier tilsidesætter standardtilknytningskrav, som bruges af Dynamics 365.

Som standard understøtter SharePoint følgende kravtyper: NameId (PUID), SMTP (mail) og UPN (User Principal Name). Hvis du overfører krav af en anden type, skal du også oprette tilsvarende kravtypetilknytninger i SharePoint.Flere oplysninger:New-SPClaimTypeMapping

Se også

Meddelelser og metoder for objektet UserMapping
Integrere Microsoft Dynamics 365 med SharePoint

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret