Definir mapeamento de declarações personalizadas para integração baseada em servidor com o SharePoint

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Para a integração baseada em servidor com o SharePoint, o Microsoft Dynamics 365 usa declarações para autenticar e autorizar usuários do Dynamics 365 a acessarem os documentos armazenados no SharePoint. Para obter mais informações sobre a autenticação baseada em declarações, consulte Identidade baseada em declarações no SharePoint 2013.

Por padrão, o Dynamics 365 usa as seguintes declarações para integração com o SharePoint:

Cenário	Reclamações
Dynamics 365 (online) e SharePoint Online	NameId (PUID) O Dynamics 365 e o SharePoint compartilham o Active Directory do Microsoft Azure para identidade de usuário.
Dynamics 365 (online) e SharePoint no local	SMTP (email) Sem infraestrutura de diretório ativa e compartilhada para identidade do usuário; declarações enviadas como endereço SMTP. As declarações são selecionadas do campo WindowsLiveID no Dynamics 365 e mapeadas para funcionarem com o endereço de email do SharePoint.
Dynamics 365 (local) e SharePoint Online	SMTP (email) Sem infraestrutura de diretório ativa e compartilhada para identidade do usuário; declarações enviadas como endereço SMTP. As declarações são selecionadas do campo PrimaryEmailAddess no Dynamics 365 e mapeadas para funcionarem com o endereço de email do SharePoint.
Dynamics 365 local e SharePoint local	Security Identifier (SID) O Dynamics 365 e o SharePoint compartilham o Microsoft Windows Server Active Directory para identidade do usuário.

Você pode usar a entidade UserMapping para especificar mapeamentos de declaração personalizados no Dynamics 365 para usar um valor que não seja o valor padrão usado pelo Dynamics 365 para autenticar e autorizar usuários de Dynamics 365 no SharePoint. Por exemplo, você pode usar o “sobrenome” e “nome” do usuário em vez do ”email” para autenticar usuários do Dynamics 365 no SharePoint. Os mapeamentos de declaração personalizados substituem os mapeamentos de declaração padrão usados pelo Dynamics 365. Você pode definir vários mapeamentos de declaração personalizados no Dynamics 365. Por padrão, somente os usuários com a função Administrador do Sistema têm acesso à entidade UserMapping.

Para definir um mapeamento de declaração personalizado no Dynamics 365, crie um registro de entidade UserMapping e especifique os valores de atributos listados na tabela a seguir.

Atributo	Valor	Descrição
UserMapping.PartnerApplicationType	0: SharePoint 1: Somente para uso interno.	O tipo de aplicação de parceiro para a qual esse mapeamento de declaração deve ser usado. Na versão atual, somente 0 (SharePoint) tem suporte.
UserMapping.SystemUserAttributeName	Valor da cadeia de caracteres	O nome lógico do atributo na entidade (usuário) SystemUser do qual o valor será usado para as declarações. Observação Se o atributo usado no mapeamento personalizado de declarações não contém um valor, o mapeamento de declarações padrão é usado pelo Dynamics 365. Por exemplo, se você quiser usar o nome do usuário como o atributo para o mapeamento personalizado de declarações, e o nome de um usuário estiver ausente, o Dynamics 365 usará o mapeamento de declarações padrão (PUID ou email).
UserMapping.ClaimType	Valor da cadeia de caracteres	Especifique o tipo de declaração a ser enviada ao SharePoint. Para obter uma lista de tipos de declarações, consulte Membros de ClaimTypes. Observação A lista de tipos de declarações referenciadas é apenas para referência. Todos os tipos de declaração listados podem não ter suporte do SharePoint, ou podem não conter todos os tipos de declaração com suporte do SharePoint.

O código de exemplo a seguir mostra como definir um mapeamento de declarações personalizado usando a entidade UserMapping.

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

Observação

Qualquer instância da entidade UserMapping com valores válidos substituirá os mapeamentos de declaração padrão usados pelo Dynamics 365.

Por padrão, o SharePoint dá suporte aos seguintes tipos de declaração: NameId (PUID), SMTP (email) e UPN (nome principal do usuário). Se estiver passando uma declaração de qualquer outro tipo, você também precisará criar mapeamentos do tipo de declaração correspondente no SharePoint.Para obter mais informações:New-SPClaimTypeMapping

Confira Também

Mensagens e métodos da entidade UserMapping
Integrar o Microsoft Dynamics 365 com o SharePoint

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais