Autenticação do Microsoft Dynamics 365 CRM

Conecte a UiPath ao Microsoft Dynamics 365 CRM usando a autenticação OAuth 2.0 no Automation Suite.

O UiPath Integration Service permite conectividade segura com sua instância do Microsoft Dynamics 365 CRM usando a autenticação baseada em OAuth 2.0. Depois de autenticado, você pode criar uma conexão que permita o acesso no nível da API aos dados do Dynamics 365 CRM para fluxos de trabalho de automação.

Adicionar uma conexão ao Microsoft Dynamics 365 CRM permite que os produtos da UiPath interajam com seus dados de CRM — incluindo leitura, gravação, modificação e exclusão de registros, dependendo das permissões do usuário autenticado no Dynamics 365 CRM.

Você pode criar uma conexão do Dynamics 365 CRM usando o método de autenticação de aplicativo Traga seu próprio OAuth 2.0 (registro de aplicativo personalizado).

Na tela de conexão, você deve fornecer os seguintes detalhes:

• ID do Cliente
• Segredo do cliente
• URL do tenant

Importante:

O URI de retorno de chamada/redirecionamento https://{yourDomain}/provisioning_/callback deve ser adicionado às configurações de registro do aplicativo do Azure AD em Redirecionar URIs com o tipo Web .

Esse URL de retorno de chamada é pré-configurado pela UiPath e não pode ser modificado na Interface Gráfica do Integration Service.

Campos obrigatórios explicados

Campo	Description
ID do Cliente	A ID do aplicativo do Azure AD (necessário apenas se estiver usando seu próprio aplicativo).
Segredo do cliente	O segredo que você gerou para seu aplicativo do Azure AD (necessário para aplicativo personalizado).
URL do tenant	URL de instância do seu Dynamics 365 CRM (para ambas as opções).
URL de retorno de chamada	Valor pré-preenchido mostrado ao usar um aplicativo personalizado; você deve registrar essa URL no Azure AD.

Recupere suas credenciais

Para localizar o URL do seu tenant, entre em contato com o administrador do Microsoft Dynamics.

Observação:

• O consentimento do administrador pode ser necessário em seu tenant para as permissões de aplicativos que você solicita.
• O aplicativo personalizado deve ser configurado com Permissões delegadas para o Dynamics CRM.

Caso você tenha acesso e use um tenant global único, siga estas etapas:

1. Acesse https://portal.azure.com.

2. Selecione Azure Active Directory.

3. Vá para Propriedades na seção Gerenciar .

4. Seu tenant é o ID do tenant, como por exemplo: sample083151e4.api.crm10.dynamics.com.

   Observação:

   Any mistake in the Tenant URL prevents you from authenticating and creating a connection.

Se você deseja criar seu próprio aplicativo OAuth 2.0 privado, siga as etapas descritas na documentação do Microsoft Dynamics 365:

• Início rápido: registrar um aplicativo com a plataforma de identidade da Microsoft
• Tutorial: registrar um aplicativo com o Microsoft Entra ID

Permissões e consentimentos

Para funcionar corretamente, a conexão do Dynamics 365 CRM requer os seguintes escopos do OAuth:

• user_impersonation
• offline_access
• User.Read

Você pode usar a conexão para habilitar as atividades Microsoft Dynamics 365 CRM no UiPath Studio para criar automações para gerenciar contas, leads, oportunidades, incidentes e outros recursos de CRM. Os vários casos de uso baseados em permissão que podem ser alcançados são os seguintes:

Escopo/Permissão	Use case	Atividade/Evento
user_impersonation (obrigatório)	O escopo user_impersonation é necessário para que a solicitação em seu fluxo de autenticação funcione com a API de gerenciamento do Azure. A representação é usada para executar a lógica de negócios (código) em nome de outro usuário do Microsoft DataVerse para fornecer um recurso ou serviço desejado usando a função apropriada e a segurança baseada em objeto desse usuário representado. Isso é necessário porque os serviços Web do Dataverso podem ser chamados por vários clientes e serviços em nome de um usuário do Dataverso, por exemplo, em um fluxo de trabalho ou solução de ISV personalizada.	N/A
offline_access (obrigatório)	O offline_access é necessário para receber o token de atualização no endpoint de solicitação de autenticação. Quando você troca um código de autorização no fluxo de código de autorização do OAuth 2.0 sem o escopo dooffline_access , você não receberá o token de atualização do endpoint do /token .	N/A
User.Read (obrigatório)	Permite que os usuários façam login no aplicativo, e permite que o aplicativo leia o perfil de usuários conectados. Isso também permite que o aplicativo leia informações básicas da empresa dos usuários conectados.	N/A

O consentimento do administrador pode ser necessário, dependendo de suas políticas corporativas do Azure AD.

Tokens de atualização para aplicativos OAuth

Os tokens de atualização para aplicativos OAuth podem ser invalidados ou revogados a qualquer momento pela Microsoft. Isso pode acontecer por diferentes motivos, como tempos limite e revogação. Para obter detalhes, consulte a documentação oficial da Microsoft.

Observação:

A invalidação de tokens resulta em conexões com falha e as automações não podem ser executadas sem corrigir as conexões.

Esse problema afeta todos os conectores baseados no Microsoft Graph.

Certifique-se de seguir as práticas recomendadas da Microsoft ao criar seus aplicativos OAuth. Para obter detalhes completos sobre como criar um aplicativo Microsoft OAuth, consulte a documentação da Microsoft.

Adicionar a conexão do Microsoft Dynamics 365

1. Selecione Integration Service no menu de navegação esquerdo.
2. Na lista Conectores , selecione Microsoft Dynamics 365 CRM. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione Conectar ao Microsoft Dynamics 365 CRM.
4. Você será redirecionado para a página de conexão.
5. Insira as credenciais necessárias.
6. Select Connect.

Para obter mais informações sobre o Microsoft Dynamics 365, consulte a documentação do Microsoft Dynamics 365.

Solução de problemas de configuração comuns

• URI de redirecionamento inválido – Certifique-se de que seu aplicativo do Azure AD tenha exatamente o URL de retorno de chamada https://{yourDomain}/provisioning_/callback.
• Permissões não concedidas – O consentimento do administrador pode ser necessário para escopos do Dynamics CRM.
• URL do tenant errado – Verifique se você está usando o URL base do CRM exato da sua organização.
• Problemas de token de atualização/consentimento – Eles podem levar a conexões com falha se a configuração do Azure AD for alterada após o consentimento inicial.