Définir le mappage de revendication personnalisé pour l’intégration basée sur SharePoint
Pour l’intégration basée sur serveur avec SharePoint, Dynamics 365 Customer Engagement (on-premises) utilise des revendications pour authentifier et autoriser les utilisateurs Customer Engagement à 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, Customer Engagement utilise les revendications suivantes pour l’intégration avec SharePoint :
| Scénario | Sinistres |
|---|---|
| Customer Engagement et SharePoint en ligne | NameId (PUID)Dynamics 365 Customer Engagement (on-premises) et SharePoint partagent Azure Active Directory pour l’identité de l’utilisateur. |
| Customer Engagement 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 Customer Engagement (on-premises) et mappées à l’adresse e-mail professionnelle SharePoint. |
| Dynamics 365 Customer Engagement (on-premises) 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 Customer Engagement (on-premises) et mappées à l’adresse e-mail professionnelle SharePoint. |
| Dynamics 365 Customer Engagement (on-premises) et SharePoint local | SMTP (email)Dynamics 365 Customer Engagement (on-premises) et SharePoint partagent Active Directory de Microsoft Windows Server pour l’identité de l’utilisateur. |
Vous pouvez utiliser l’entité UserMapping pour indiquer que les mappages de revendication personnalisés dans Customer Engagement afin qu’ils utilisent une valeur autre que celle par défaut utilisée par Customer Engagement pour authentifier et autoriser les utilisateurs Customer Engagement 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 Customer Engagement dans SharePoint. Les mappages de revendication personnalisés remplacent les mappages de revendication par défaut utilisés par Customer Engagement. Vous pouvez définir plusieurs mappages de revendication personnalisés dans Customer Engagement. 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 Customer Engagement, créez un enregistrement d’entité UserMapping et spécifiez les valeurs d’attribut répertoriées dans le tableau suivant.
| Attribute | active | Description |
|---|---|---|
UserMapping.PartnerApplicationType |
- 0: SharePoint- 1 : Utilisation interne uniquement. |
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. Remarque : si l’attribut utilisé pour le mappage de revendication personnalisé ne contient aucune valeur, le mappage de revendication par défaut est utilisé par Customer Engagement. 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, Customer Engagement 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. Remarque : 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);
Note
Toute instance de l’entité UserMapping avec les valeurs valides remplacera les mappages de revendication par défaut utilisés par Customer Engagement.
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. Plus d’informations : Nouveau SPClaimTypeMapping
Voir aussi
Entité UserMapping
Intégrer Microsoft Dynamics 365 Customer Engagement (on-premises) avec SharePoint