Définition d'un mappage de revendication personnalisé pour l'intégration basée sur SharePoint
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Pour l'intégration basée sur serveur avec SharePoint, Microsoft Dynamics 365 utilise des revendications pour authentifier et autoriser les utilisateurs Dynamics 365 à accéder aux documents stockés dans SharePoint. Pour plus d'informations sur l'authentification basée sur les revendications, voir Identité basée sur les revendications dans SharePoint 2013.
Par défaut, Dynamics 365 utilise les revendications suivantes pour l'intégration avec SharePoint :
Scénario |
Sinistres |
|---|---|
Dynamics 365 (en ligne) et SharePoint Online |
NameId (PUID) Dynamics 365 et SharePoint partagent Microsoft Azure Active Directory pour l'identité de l'utilisateur. |
Dynamics 365 (en ligne) et SharePoint local |
SMTP (email) Aucune infrastructure Active Directory partagée pour l'identité de l'utilisateur ; revendications envoyées comme adresse SMTP. Les revendications sont sélectionnées dans le champ WindowsLiveID de Dynamics 365 et mappées à l'adresse de messagerie du travail SharePoint. |
Dynamics 365 local et SharePoint Online |
SMTP (email) Aucune infrastructure Active Directory partagée pour l'identité de l'utilisateur ; revendications envoyées comme adresse SMTP. Les revendications sont sélectionnées dans le champ PrimaryEmailAddess de Dynamics 365 et mappées à l'adresse de messagerie du travail SharePoint. |
Dynamics 365 local et SharePoint local |
Security Identifier (SID) Dynamics 365 et SharePoint partagent le serveur Active Directory de Microsoft Windows pour l'identité de l'utilisateur. |
Vous pouvez utiliser l'entité UserMapping pour indiquer que les mappages de revendication personnalisés dans Dynamics 365 afin qu'ils utilisent une valeur autre que celle par défaut utilisée par Dynamics 365 pour authentifier et autoriser les utilisateurs Dynamics 365 dans SharePoint. Par exemple, vous pouvez utiliser le « nom » et le « prénom » de l'utilisateur au lieu de « courrier électronique » pour authentifier les utilisateurs Dynamics 365 dans SharePoint. Les mappages de revendication personnalisés remplacent les mappages de revendication par défaut utilisés par Dynamics 365. Vous pouvez définir plusieurs mappages de revendication personnalisés dans Dynamics 365. Par défaut, seuls les utilisateurs ayant le rôle administrateur système ont accès à l'entité UserMapping.
Pour définir un mappage de revendication personnalisé dans Dynamics 365, créez un enregistrement d'entité UserMapping et spécifiez les valeurs d'attribut répertoriées dans le tableau suivant.
Attribut |
Valeur |
Description |
|---|---|---|
UserMapping.PartnerApplicationType |
|
Type d'application partenaire pour laquelle ce mappage de revendication doit être utilisé. Dans la version actuelle, seul 0 (SharePoint) est pris en charge. |
UserMapping.SystemUserAttributeName |
Valeur de chaîne |
Le nom logique de l'attribut dans l'entité SystemUser (utilisateur) d'où la valeur des revendications sera utilisée. Notes Si l'attribut utilisé pour le mappage de revendication personnalisé ne contient aucune valeur, le mappage de revendication par défaut est utilisé par Dynamics 365. Par exemple, si vous voulez utiliser le prénom de l'utilisateur en tant qu'attribut de mappage de revendication personnalisé et que le prénom de l'utilisateur est manquant, Dynamics 365 utilise le mappage de revendication par défaut (PUID ou courrier électronique). |
UserMapping.ClaimType |
Valeur de chaîne |
Spécifiez le type de revendication à envoyer à SharePoint. Pour obtenir la liste des types de revendication, voir Membres ClaimTypes. Notes La liste des types de revendication référencée n'est utilisée que pour référence. Tous les types de revendication répertoriés ici peuvent ne pas être pris en charge par SharePoint, ou peuvent ne pas contenir tous les types de revendication pris en charge par SharePoint. |
L'exemple de code suivant montre comment définir un mappage de revendication personnalisé à l'aide de l'entité UserMapping.
UserMapping customMapping = new UserMapping
{
PartnerApplicationType = new OptionSetValue(0),
SystemUserAttributeName = "personalemailaddress",
ClaimType = "smtp"
};
_serviceProxy.Create(customMapping);
Notes
Toute instance de l'entité UserMapping avec les valeurs valides remplacera les mappages de revendication par défaut utilisés par Dynamics 365.
Par défaut, SharePoint prend en charge les types de revendication suivants : NameId (PUID), SMTP (courrier électronique), et nom d'utilisateur principal (UPN). Si vous transmettez une revendication pour tout autre type, vous devez également créer les types de mappages de revendication correspondants dans SharePoint.Pour plus d'informations :New-SPClaimTypeMapping
Voir aussi
Messages et méthodes de l'entité UserMapping
Intégration de Microsoft Dynamics 365 avec SharePoint
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright