Autenticando aplicativos .NET

Este artigo fornece diretrizes para o desenvolvimento de aplicativos codificados e criados usando .NET.

Aplicativos do .NET Framework

Quando você usa o .NET Framework para desenvolver seu aplicativo, use classes no namespace Xrm.Tooling para se autenticar e se conectar facilmente aos serviços Web do Microsoft Dataverse.

As classes Xrm.Tooling nos assemblies do SDK usam os métodos de interfaces IOrganizationService Esse estilo de programação é o mesmo estilo usado por plug-ins e atividades de fluxo de trabalho, para que você possa usá-lo em todos os lugares para aplicativos .NET Framework. Use a classe Microsoft.Xrm.Tooling.Connector.CrmServiceClient para conexão com o serviço Web.

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

• Você pode definir informações de conexão usando um 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 multithread.
• Fornece um controle de login comum do Windows Presentation Foundation (WPF) para uma experiência de login consistente em 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 pelas Xrm.Tooling classes, desde que use o OAuth.

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

Versões do .NET Framework

Use uma versão do .NET Framework com suporte ao criar novos aplicativos cliente.

Aplicativos do .NET Framework sem usar assemblies do SDK

Se você preferir não depender de nenhum assembli do SDK, poderá usar os padrões descritos em Usar 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 do .NET Core

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

Para o desenvolvimento de aplicativos .NET Core, há uma classe DataverseServiceClient baseada na classe CrmServiceClient mencionada anteriormente. Você pode baixar o pacote Microsoft.PowerPlatform.Dataverse.Client do NuGet.org para começar a usar esta nova classe cliente para esse 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 existente baseado no .NET Framework que usa CrmServiceClient, substitua a classe DataverseServiceClient por CrmServiceClient no seu código. Defina 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 Microsoft. Pacote PowerPlatform.Dataverse.Client para o projeto.

Consulte também

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