Autenticando aplicativos .NET

Este tópico fornece diretrizes ao desenvolver aplicativos codificados e criados usando o .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 se conectar facilmente aos serviços Web do Microsoft Dataverse.

As classes nos assemblies do SDK usam os métodos de interfaces IOrganizationService. 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 do .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 uma cadeia de conexão.
• Dá suporte à autenticação baseada em declarações do OAuth e do Microsoft 365.
• Segurança de thread para ações executadas em um ambiente com vários threads.
• Fornece um controle de logon comum do WPF (Windows Presentation Foundation) para uma experiência de entrada consistente de 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: Criar aplicativos cliente do Windows usando as ferramentas XRM

Versões do .NET Framework

Use o .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 Usar OAuth com o 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 no Microsoft.CrmSdk.XrmTooling.CoreAssembly e em outros pacotes NuGet de propriedade do "crmsdk" não dão suporte ao desenvolvimento de código do .NET Core.

Para o desenvolvimento de aplicativos do .NET Core, há uma DataverseServiceClient classe padronizada após a CrmServiceClient classe 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 CrmServiceClient pela classe DataverseServiceClient no 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