Ir para o conteúdo

Conector Microsoft Entra ID para Jitterbit Integration 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.

Importante

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

O conector do Microsoft Entra ID fornece uma interface para criar uma conexão do Microsoft Entra ID, a base usada 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 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 que devem ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

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

Tipos de atividade do Microsoft Entra ID

  • Consulta: Consulta dados de objeto no Microsoft Entra ID e deve ser usado como fonte em uma operação.

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

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

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

Nota

Este conector é um Connector SDK, que pode ser consultado pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.

Pré-requisitos e versões de API suportadas

O conector Microsoft Entra ID requer que você crie um aplicativo registrado para conectar-se 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 do agente baixam automaticamente a versão mais recente do conector quando necessário.

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

Solução de problemas

Se você tiver 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 Desativar atualização automática do conector política da organização).

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

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

  4. Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

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

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

    Para obter mais informações sobre o registro detalhado de conectores, consulte Registro detalhado para conectores que usam agentes privados Jitterbit.

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

  7. Se você estiver vendo erros relacionados a nomes de tipos incompatíveis com os metadados, tente habilitar Definir tipo OData na 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 sejam usados juntos em uma única consultar. Caso contrário, ocorrerá um erro.

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