Autenticando aplicativos .NET

Este tópico fornece diretrizes ao desenvolver aplicativos codificados e criados usando .NET.

aplicativos do .NET Framework

Se você estiver usando o .NET Framework ao desenvolver seu aplicativo, poderá usar classes no namespace Xrm.Tooling para autenticar e conectar-se facilmente aos serviços Web Microsoft Dataverse.

As classes nos assemblies do SDK usam os métodos de interfaces Xrm.Tooling. Esse é o mesmo estilo de programação usado por plug-ins e atividades de fluxo de trabalho, tornando-o um estilo que você pode usar em todos os lugares para aplicativos .NET Framework. É recomendável usar a Microsoft.Xrm.Tooling.Connectorclasse .CrmServiceClient para conexão de serviço Web.

As Xrm.Tooling classes oferecem muitos benefícios, incluindo:

• Você pode definir informações de conexão usando um connection string.
• Dá suporte à autenticação baseada em declarações OAuth e Microsoft 365.
• Segurança de thread para ações executadas em um ambiente com vários threads.
• Fornece um controle comum de login do Windows Presentation Foundation (WPF) para uma experiência de login consistente nos seus aplicativos cliente do Windows.
• Suporte para armazenamento seguro das credenciais de entrada e reutilização das credenciais armazenadas para entrar automaticamente após a entrada inicial.
• Rastreamento diagnóstico incorporado e relatório de desempenho das ações realizadas, que você pode configurar com base nos requisitos da sua organização.
• Suporte para autenticação de certificado X.509.

As Xrm.Tooling classes são otimizadas para usar os métodos de IOrganizationService interface.

Se você quiser usar a API Web, poderá usar o Microsoft.Xrm.Tooling.Connectormétodo .CrmServiceClient.ExecuteCrmWebRequest para compor solicitações usando a API Web com todos os outros benefícios fornecidos com as Xrm.Tooling classes, desde que você use o OAuth.

Mais informações: Crie aplicativos cliente do Windows usando as ferramentas XRM

versões do .NET Framework

Use .NET Framework versão 4.6.2 ou superior ao criar aplicativos cliente. Somente aplicativos que usam o TLS (Transport Level Security) 1.2 ou uma segurança melhor podem se conectar. O TLS 1.2 não é o protocolo padrão usado pelo .NET Framework 4.5.2, mas está no .NET Framework 4.6.2 ou posterior.

aplicativos do .NET Framework sem usar assemblies do SDK

Se você preferir não ter uma dependência em nenhum assembli do SDK, também poderá usar os padrões descritos em Use OAuth com Microsoft Dataverse sem depender de nenhum assembli do SDK. Sem os assemblies do SDK, você só pode usar os serviços Web OData Restful (API Web e OData Global Discovery Service). Os Exemplos de Operações de Dados da API Web (C#) demonstram essa abordagem.

aplicativos .NET Core e .NET 6

As APIs do SDK disponíveis em Microsoft.CrmSdk.XrmTooling.CoreAssembly e outros pacotes NuGet pertencentes ao "crmsdk" não dão suporte ao desenvolvimento de código .NET Core.

Para o desenvolvimento de aplicativos .NET Core, há uma classe DataverseServiceClient, padronizada após a classe CrmServiceClient mencionada anteriormente. Você pode baixar o pacote Microsoft.PowerPlatform.Dataverse.Client de Nuget.org para começar a usar essa nova classe de cliente de serviço em seus aplicativos. A documentação e o código de exemplo para as classes DataverseServiceClient e relacionadas serão disponibilizados em uma futura versão da documentação.

Para atualizar o código de aplicativo baseado no .NET Framework existente que usa CrmServiceClient, comece substituindo a classe DataverseServiceClient por CrmServiceClient em seu código. Você precisará definir o tipo de projeto para criar um aplicativo .NET Core, remover quaisquer referências específicas do .NET Framework e pacotes NuGet e, em seguida, adicionar o pacote Microsoft.PowerPlatform.Dataverse.Client ao projeto.

Consulte também

Autenticação com serviços Web do Dataverse
Usar o OAuth com o Dataverse