Conector Microsoft Entra ID no Jitterbit Studio

Resumo

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

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

O conector Microsoft Entra ID fornece uma interface para criar uma conexão Microsoft Entra ID, a base utilizada para gerar instâncias de atividades do Microsoft Entra ID. Essas atividades, uma vez configuradas, interagem com o Microsoft Entra ID por meio da conexão.

O conector Microsoft Entra ID é acessado na aba Endpoints e conectores do projeto no painel de componentes de design (veja Painel de componentes de design).

Visão geral do conector

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

Juntos, uma conexão específica do Microsoft Entra ID e suas atividades são referidos como um endpoint Entra ID:

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

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

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

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

Pré-requisitos e versões de API suportadas

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

O conector Microsoft Entra ID requer o uso de uma versão de agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

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

Solução de problemas

Se você encontrar problemas com o conector Microsoft Entra ID, estas etapas de solução de problemas são recomendadas:

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 de organização Desativar Atualização Automática do Conector).

2. Certifique-se de que quaisquer registros de aplicativos do Microsoft Entra ID associados à conexão não estejam usando o Azure AD Graph obsoleto.

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

4. Ative o registro 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 registro 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 o registro detalhado do conector, consulte Registro 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 você estiver vendo erros relacionados a nomes de tipo incompatíveis com os metadados, tente ativar a Definir tipo OData na carga útil nas Configurações opcionais na configuração da conexão.

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

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