Ir para o conteúdo

Conector Microsoft Entra ID no Jitterbit Studio

Resumo

O conector Microsoft Entra ID estabelece acesso ao Microsoft Entra ID.

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

Importante

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

O conector Microsoft Entra ID fornece uma interface para criar uma conexão Microsoft Entra ID, a base usada para gerar instâncias de atividades Microsoft Entra ID. Essas atividades, uma vez configuradas, interagem com o Microsoft Entra ID através da conexão.

Acessa-se o conector Microsoft Entra ID a partir da aba Endpoints e conectores do projeto da paleta de componentes de design (consulte Paleta de componentes de design).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão Microsoft Entra ID. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Juntos, uma conexão Microsoft Entra ID específica e suas atividades são chamados de endpoint Entra ID:

Tipos de atividade Microsoft Entra ID

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

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

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

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

Os endpoints criados com este conector são incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política organizacional Desabilitar atualização automática de conector.

O conector Microsoft Entra ID exige que você crie um aplicativo registrado para conectar com sucesso ao Microsoft Entra ID.

O conector Microsoft Entra ID usa a API Microsoft Graph v1.0. Consulte a documentação da API para obter informações sobre os nós de esquema e campos.

Solução de problemas

Se você enfrentar problemas com o conector Microsoft Entra ID, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política organizacional Desabilitar atualização automática de conector).

  2. Certifique-se de que qualquer registro de aplicativo do Microsoft Entra ID associado à conexão não está usando o Azure AD Graph descontinuado.

  3. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  4. Ative o log de depuração de operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  5. Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

    <logger name="org.jitterbit.connector.active.directory" level="DEBUG"/>

    Para mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

  6. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

  7. Se estiver vendo erros relacionados a nomes de tipo incompatíveis com os metadados, tente ativar a opção Definir tipo OData no payload em Configurações opcionais na configuração de conexão.

  8. Atividade de consulta: Certifique-se de que os parâmetros Top e Page Size não são usados juntos em uma única consulta. Caso contrário, ocorrerá um erro.

  9. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.

  10. Para problemas e resoluções específicas do conector Microsoft Entra ID, consulte o guia Solução de problemas do conector: