# 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:

| Área | Páginas | Disponível para |
|---|---|---|
| **Home** | Agents, Status | Todos os conetores |
| **Configure** | Data source, Identity | Conetores de autenticação |
| **Configure** | Provisioning target, Identity | Conetores de aprovisionamento |
| **Insight** | Logs, Diagnostics | Diagnostics para conetores de autenticação, Logs para todos os conetores |
| **Explore** | Users, Groups, Directory structure | Conetores de autenticação |
| **Update** | Release notes, Update | Todos 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**

| Campo | Significado |
|---|---|
| **Protocol** | `ldaps://` (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**, **Port** | Endereç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 password** | A 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 DN** | A 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 certificates** | Desativa 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:

| Categoria | Conteúdo |
|---|---|
| **Logs** | Os ficheiros de log do conetor. Incluídos por predefinição. |
| **Settings** | A configuração da origem de dados: anfitrião, bind DN, base DN e filtros. A bind password é omitida. |
| **Connection test** | O resultado de um novo teste de ligação. |
| **Users**, **Groups**, **Directory structure** | Os 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

- [Instalar um Enterprise Connector](https://dts-identity.com/pt/docs/directories/enterprise-connector-installation.md) para requisitos, instalação, atualizações e remoção.
- [Enterprise Connectors](https://dts-identity.com/pt/docs/directories/enterprise-connectors.md) para o lado da consola.
- [Diretórios de utilizadores](https://dts-identity.com/pt/docs/directories/user-directories.md) para a sincronização, a reescrita de palavras-passe e as próprias definições de diretório.
