Ir para o conteúdo

Conexão com o Active Directory

Introdução

Uma conexão com o Active Directory, criada usando o conector do Active Directory, estabelece acesso à versão local do Active Directory. Essas atividades, uma vez configuradas, interagem com o Active Directory através da conexão.

Importante

Recomendamos o uso do conector do Active Directory v2 para conectar-se à versão local do Active Directory, pois permite propriedades de configuração adicionais.

Criar ou editar uma conexão com o Active Directory

Uma nova conexão com o Active Directory é criada usando o conector do Active Directory a partir de uma dessas localizações:

Uma conexão existente com o Active Directory pode ser editada a partir dessas localizações:

Configurar uma conexão Active Directory

Cada elemento da interface do usuário da tela de configuração da conexão Active Directory é 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 único para cada conexão Active Directory e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint Active Directory, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Autenticação: Quando selecionado (padrão), mostra configurações adicionais. Para documentação, consulte Estabelecendo uma conexão e Propriedades de configurações adicionais:

    • Servidor: Insira o servidor.

    • Porta: Insira a porta.

    • Usuário: Insira o usuário. Um usuário pode ser definido usando o formato de nome de logon de nível inferior ou o formato de nome distinto. Por exemplo: Domain\user1 ou CN=user1,CN=Users,DC=Domain.

    • Senha: Insira a senha.

    • Usar SSL: Quando selecionado, especifica o uso de SSL.

    • Base DN: Insira o nome do domínio base no formato de nome distinto. Por exemplo: DC=Domain.

  • Mecanismo de Autenticação: Selecione o mecanismo de autorização, um dos:

    -   **SIMPLIFICADO**

-   **DIGESTMD5**

-   **NEGOCIAR**

  • Escopo: Selecione o escopo, um dos:

    -   **SUBÁRVORETOTAL**

-   **NÍVELÚNICO**

-   **OBJETOBASICO**

  • Versão LDAP: Selecione a versão LDAP, uma das:

    -   **2**

-   **3**

  • SSL: Quando selecionado, mostra configurações adicionais. Para documentação, veja Estabelecendo uma conexão e Propriedades de configurações adicionais:

    • Certificado do Servidor SSL: Insira o certificado do servidor SSL.

  • Usar Configurações de Proxy: Selecione para usar configurações de proxy de agente privado.

  • Configurações Avançadas: Quando selecionado, mostra a tabela de Propriedades de Configurações Avançadas, que é usada para adicionar propriedades de configuração adicionais como pares chave-valor.

    • Adicionar: Adiciona uma linha à tabela. Insira um par chave-valor para cada propriedade.
    • Enviar: Salva o par chave-valor na tabela. Visível ao passar o mouse sobre uma linha no modo de edição.
    • Descartar: Descartar uma nova linha ou quaisquer edições feitas em uma linha existente. Visível ao passar o mouse sobre uma linha no modo de edição.
    • Editar: Permite editar um par chave-valor existente. Visível ao passar o mouse sobre uma linha existente.
    • Excluir: Exclui a linha da tabela. Visível ao passar o mouse sobre uma linha existente.
    • Limpar Tudo: Exclui todas as linhas da tabela.

    Importante

    Os campos na tabela de Propriedades de Configurações Avançadas exibem o ícone de variável apenas no modo de edição. Para que os valores de variável desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

Os campos na tabela Propriedades de Configurações Avançadas não suportam o uso de variáveis para passar JSON bruto. Se o seu caso de uso não suportar a definição de JSON bruto nos campos diretamente, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escapando {"success": "true"}; torna-se {\"success\": \"true\"};.

  • Teste: Clique para verificar a conexão usando a configuração especificada. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de Desativar Atualização Automática do Conector política da organização.

  • 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 pede para você confirmar 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 pede para você confirmar que deseja excluir a conexão.

Próximas etapas

Após a criação de uma conexão de conector do Active Directory, 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 a partir do painel do projeto e da paleta de componentes de design. Para detalhes, veja Menus de ações em Noções básicas sobre conectores.

Estes tipos de atividade estão disponíveis:

  • Consulta: Recupera registros de uma tabela no Active Directory e é destinado a ser usado como uma fonte em uma operação.

  • Criar: Insere um registro em uma tabela no Active Directory e é destinado a ser usado como um destino em uma operação.

  • Atualizar: Atualiza um registro em uma tabela no Active Directory e é destinado a ser usado como um destino em uma operação.

  • Excluir: Exclui um registro de uma tabela no Active Directory e é destinado a ser usado como um destino em uma operação.