Skip to Content

Configurar e operar um Enterprise Connector

Origem de dados, TLS, estado, logs e diagnóstico na aplicação Enterprise Connector instalada na sua própria máquina.

Depois de um conetor estar inscrito, a sua configuração reside na aplicação do conetor, na máquina dentro da sua rede, e não na consola. Esta página descreve essa aplicação.

A janela da aplicação

No canto superior esquerdo, o seletor de conetores determina qual dos conetores instalados está a ser consultado. Todas as páginas abaixo do seletor dizem respeito ao conetor selecionado, pelo que deve verificá-lo em primeiro lugar quando uma página apresentar valores inesperados.

As páginas disponíveis dependem do tipo do conetor selecionado:

ÁreaPáginasDisponível para
HomeAgents, StatusTodos os conetores
ConfigureData source, IdentityConetores de autenticação
ConfigureProvisioning target, IdentityConetores de aprovisionamento
InsightLogs, DiagnosticsDiagnostics para conetores de autenticação, Logs para todos os conetores
ExploreUsers, Groups, Directory structureConetores de autenticação
UpdateRelease notes, UpdateTodos os conetores

Data source (conetores de autenticação)

Configure → Data source contém a ligação ao Active Directory ou LDAP. As alterações produzem efeito sem reiniciar o serviço.

Ligação

CampoSignificado
Protocolldaps:// (cifrado, recomendado) ou ldap://. A escolha da variante não cifrada apresenta um aviso, porque nesse caso as credenciais de bind e os dados do diretório circulam em claro.
Host, PortEndereço do controlador de domínio ou do servidor LDAP, normalmente a porta 636 para LDAPS e a porta 389 para LDAP.
Bind DN, Bind passwordA conta de serviço com que o conetor se autentica. O acesso de leitura é suficiente enquanto a sincronização ascendente e a reescrita de palavras-passe não estiverem ativadas.
Base DNA raiz da sub-árvore em que o conetor trabalha.
Custom CA certificates (PEM)Certificados das autoridades em que a ligação LDAPS deve confiar, para além do arquivo de certificados do sistema. Independentes dos certificados configurados para a ligação à plataforma.
Ignore invalid certificatesDesativa a verificação de certificados na ligação LDAPS. Utilize esta opção apenas como medida temporária.

Users e Groups aceitam, cada um, um additional base DN acrescentado ao base DN, bem como um filtro. Em conjunto, determinam que objetos o conetor entrega à plataforma. Filtros restritos mantêm a sincronização rápida e evitam que contas de serviço ou de sistema acabem por figurar como utilizadores.

Test settings executa um teste de ligação com os valores atualmente presentes no formulário e comunica o resultado, incluindo as contagens de objetos. Utilize-o após cada alteração, antes de guardar.

As operações de diretório utilizam, por predefinição, um tempo limite de dez segundos, suficiente para um controlador de domínio sob carga numa ligação lenta. Um início de sessão de utilizador que o exceda é considerado um início de sessão falhado, pelo que os tempos limite repetidos devem ser investigados do lado do diretório, em vez de se aumentar a tolerância.

Provisioning target (conetores de aprovisionamento)

Configure → Provisioning target controla o que um conetor de aprovisionamento pode alcançar:

  • Allowed target origins é a lista dos sistemas para os quais este conetor pode encaminhar pedidos de aprovisionamento, uma entrada por linha. Uma entrada pode indicar uma origin, por exemplo https://scim.example, ou uma origin com um prefixo de caminho para a restringir ainda mais. Uma lista vazia recusa tudo, e esse é o estado pretendido até que um destino seja deliberadamente autorizado.
  • Custom CA certificates e Ignore invalid certificates funcionam como os seus equivalentes na página da origem de dados, aplicados à ligação ao destino.

A lista de autorizações é um limite de contenção: delimita que sistemas dentro da sua rede podem, de todo, ser alcançados através deste conetor. Mantenha-a tão restrita quanto a integração permitir.

Identity (ligação à plataforma)

Configure → Identity abrange a forma como o conetor comunica com a plataforma:

  • Custom CA certificates (PEM) são os certificados das autoridades em que a ligação à plataforma deve confiar, necessários quando a sua rede interceta o tráfego TLS ou quando o certificado da plataforma provém de uma autoridade privada. Esta definição é aplicada pelo serviço do conetor no arranque, pelo que o serviço tem de ser reiniciado após uma alteração.
  • Ignore invalid certificates desativa a verificação dessa ligação. Utilize esta opção apenas como medida temporária.
  • Export keypair reúne o par de chaves do conetor num bloco cifrado com uma frase-passe. É necessário para inscrever outro conetor para o mesmo diretório ou para mudar este conetor para outra máquina. A frase-passe protege a chave privada e não pode ser recuperada, pelo que ambas as partes devem ser guardadas em local seguro e o bloco exportado deve ser eliminado depois de utilizado.

Status

Home → Status mostra três indicadores para o conetor selecionado: o Service local, a ligação a Identity e a ligação à Data source ou ao Provisioning target. Por baixo, a atividade recente é apresentada em direto: execuções de sincronização com as respetivas contagens de utilizadores, inícios de sessão bem-sucedidos e falhados, alterações de palavra-passe e tráfego de aprovisionamento com o respetivo número de falhas.

Esta é a forma mais rápida de distinguir um problema do conetor de um problema da plataforma. Um conetor cujo serviço está disponível e cuja ligação à plataforma está ativa, mas cuja origem de dados está desligada, aponta para o serviço de diretório ou para as credenciais na página da origem de dados.

Explorar o diretório

Explore → Users, Groups e Directory structure mostram, diretamente a partir da origem, o que o conetor realmente vê com os base DN e os filtros atuais. Servem para verificar um filtro antes de ativar a sincronização e para determinar se um utilizador em falta na plataforma já falta na origem ou se está excluído por um filtro.

Logs

Insight → Logs lista os ficheiros de log do conetor selecionado e oferece uma vista Live que acompanha o ficheiro atual. Os ficheiros de log são rodados e limitados no tamanho, pelo que não podem crescer indefinidamente.

Os logs permanecem na máquina. Nada do seu conteúdo chega à plataforma enquanto não for enviado um pacote de diagnóstico.

Diagnóstico

Insight → Diagnostics compõe um pacote de suporte a partir das categorias selecionadas:

CategoriaConteúdo
LogsOs ficheiros de log do conetor. Incluídos por predefinição.
SettingsA configuração da origem de dados: anfitrião, bind DN, base DN e filtros. A bind password é omitida.
Connection testO resultado de um novo teste de ligação.
Users, Groups, Directory structureOs dados de diretório tal como o conetor os lê. Não incluídos por predefinição, por conterem dados pessoais.

Download guarda o pacote localmente, para que possa ser examinado antes de ser partilhado. Upload to support transfere-o diretamente. Reveja as categorias selecionadas antes do carregamento: as categorias de diretório contêm dados pessoais dos seus utilizadores.

Notas de operação

  • Os conetores funcionam como serviços Windows e continuam a trabalhar quando a janela da aplicação está fechada.
  • Parar um conetor de autenticação interrompe os inícios de sessão do respetivo diretório, a menos que outro conetor desse diretório esteja online.
  • A origem de dados, o destino de aprovisionamento e os filtros de diretório produzem efeito imediato. Os certificados para a ligação à plataforma produzem efeito após um reinício do serviço.
  • A página Update → Release notes lista as alterações de cada versão.

Resolução de problemas

  • O Identity está ligado, mas o conetor não é utilizável. O conetor alcançou a plataforma, mas não foi aceite. Normalmente, isto sucede a um registo de conetor eliminado ou recriado na consola. Volte a inscrever o conetor com um URL de aprovisionamento novo.
  • A origem de dados aparece como desligada. Teste a ligação na página da origem de dados. As causas frequentes são uma palavra-passe expirada da conta de bind, uma regra de firewall entre a máquina e o controlador de domínio e um certificado LDAPS em que a máquina não confia.
  • Os inícios de sessão falham enquanto a sincronização funciona. A conta de bind consegue ler, mas os utilizadores não conseguem efetuar o bind, ou o filtro de utilizadores exclui-os. Verifique o filtro de utilizadores na página da origem de dados e confirme a conta em Explore → Users.
  • Faltam utilizadores após uma sincronização. Verifique primeiro o additional base DN e o filtro de utilizadores e, em seguida, confirme em Explore → Users que o conetor vê, de todo, as contas.
  • Uma alteração de palavra-passe é recusada. Num diretório com proteção de palavras-passe de ponta a ponta, a política de palavras-passe é aplicada pelo conetor. Atualize o conetor quando a mensagem não corresponder à política configurada na consola.

Consulte também

Nesta página