Ir para o conteúdo

Conexão do Microsoft Entra ID

Introdução

Uma conexão do Microsoft Entra ID, criada usando o conector do Microsoft Entra ID, estabelece acesso ao Microsoft Entra ID. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Microsoft Entra ID associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Para conectar-se a instâncias locais do Microsoft Active Directory, use o conector do Active Directory v2.

Nota

Este conector suporta a política de organização Habilitar Reautenticação em Caso de Alteração. Se habilitada, uma alteração no Host ou ID do Locatário nesta conexão requer que os usuários reentrem o Segredo do Cliente e/ou a Senha (dependendo dos Tipos de Concessão selecionados) para a conexão.

Importante

O Microsoft Entra ID era anteriormente conhecido como Microsoft Azure AD.

Criar ou editar uma conexão do Microsoft Entra ID

Uma nova conexão do Microsoft Entra ID é criada usando o conector do Microsoft Entra ID a partir de uma dessas localizações:

Uma conexão existente do Microsoft Entra ID pode ser editada a partir dessas localizações:

Configurar uma conexão do Microsoft Entra ID

Cada elemento da interface do usuário da tela de configuração da conexão do Microsoft Entra ID é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão do Microsoft Entra ID e não deve conter barras / ou dois-pontos :. Este nome também é usado para identificar o endpoint do Microsoft Entra ID, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Host: Preenchido automaticamente como https://login.microsoftonline.com.

  • ID do Locatário: Insira o ID do locatário para a instância do Microsoft Entra ID.

  • Recurso: Preenchido automaticamente como https://graph.microsoft.com.

  • Tipos de Concessão: Use o menu para selecionar o tipo de concessão, seja Credenciais do Cliente ou Concessão de Senha:

  • Credenciais do Cliente: Corresponde ao fluxo de concessão de credenciais do cliente OAuth 2.0.

  • Concessão de Senha: Corresponde ao fluxo de concessão de credenciais de senha do proprietário do recurso OAuth 2.0.

  • ID do Cliente: Insira o ID do Aplicativo (cliente) de um registro de aplicativo criado para o conector, que pode ser encontrado na página Visão Geral do registro do aplicativo no centro de administração do Microsoft Entra.

  • Segredo do Cliente: Insira o Valor do segredo do cliente para o aplicativo registrado, que pode ser encontrado na página Certificados e segredos no centro de administração do Microsoft Entra.

  • Nome de Usuário: Se Concessão de Senha for selecionada como o Tipo de Concessão, insira o endereço de email para a instância do Microsoft Entra ID.

  • Senha: Se Concessão de Senha for selecionada como o Tipo de Concessão, insira a senha para a instância do Microsoft Entra ID.

  • Escopo: Insira uma lista de escopos separados por espaço que o aplicativo requer (opcional).

  • Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar configurações de proxy do agente privado.

  • Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a política organizacional Desativar Atualização Automática do Conector.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximas etapas

Após a criação de uma conexão do Microsoft Entra ID, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Fundamentos do conector.

Estes tipos de atividade estão disponíveis:

  • Consulta: Consulta dados de objeto no Microsoft Entra ID e é destinada a ser usada como uma fonte em uma operação.

  • Criar: Cria dados de objeto no Microsoft Entra ID e é destinada a ser usada como um alvo em uma operação.

  • Atualizar: Atualiza dados de objeto no Microsoft Entra ID e é destinada a ser usada como um alvo em uma operação.

  • Excluir: Exclui dados de objeto do Microsoft Entra ID e é destinada a ser usada como um alvo em uma operação.