Autenticação do Microsoft Dynamics 365 CRM

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.

Tipos de autenticação compatíveis

Ao criar uma conexão do Dynamics 365 CRM, você pode escolher entre dois tipos de autenticação:

• Código de autorização do OAuth 2.0 (padrão e recomendado)
• Traga seu próprio aplicativo OAuth 2.0 (registro de aplicativo personalizado)

Código de autorização do OAuth 2.0

Esse é o método de autenticação mais simples. Essa opção usa o aplicativo do Azure AD gerenciado da UiPath para lidar com o login do usuário e a aquisição de tokens.

1. Na tela de criação de conexão, selecione Código de autorização do OAuth 2.0.

2. Insira a URL do tenant (https://<yourorg>.crm.dynamics.com)

   Observação:

   O valor do URL do tenant deve ser exatamente seu domínio base do Dynamics 365 CRM.

3. Clique em Conectar.

4. Você é redirecionado para as telas de login e consentimento da Microsoft para se autenticar.

   Este método não requer nenhuma configuração extra no Azure AD e é adequado para a maioria dos usuários.

Traga seu próprio aplicativo OAuth 2.0

Use essa opção se sua organização exigir controle centralizado sobre registros de aplicativos do Azure AD, escopos ou políticas de conformidade.

Quando você seleciona Trazer seu próprio aplicativo OAuth 2.0 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://{baseURL}/provisioning_/callback (por exemplo, https://cloud.uipath.com/provisioning_/callback) deve ser adicionado exatamente como exibido na tela de conexão às configurações de registro de seu 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.

Quando usar um aplicativo personalizado

Use essa opção se:

• Sua organização exige registros de aplicativos do Azure AD gerenciados pelo administrador.
• Você quer controle refinado sobre permissões e escopos de aplicativos.
• Você deve seguir as políticas de segurança internas para os aplicativos do OAuth.

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.

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.

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. Agora, você é redirecionado para a página de conexão. É possível escolher entre dois tipos de autenticação: Código de autorização do OAuth 2.0 ou Traga seu próprio aplicativo do OAuth 2.0.
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://{baseURL}/provisioning_/callback (por exemplo https://cloud.uipath.com/provisioning_/callback) registrado nos URIs de redirecionamento.
• 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.