# Enterprise Connectors

Gerir os conectores on-premises que ligam a sua rede à plataforma para autenticação, sincronização e aprovisionamento.

Um **Enterprise Connector** é um software leve que instala dentro da sua própria rede. Abre uma ligação de saída persistente à plataforma e mantém-na ativa; do seu lado, nada fica à escuta de ligações de entrada e a sua firewall não necessita de nenhuma regra de entrada. Os pedidos ao Active Directory ou ao LDAP seguem por essa ligação até ao connector, que comunica localmente com o diretório. Todos os connectors são geridos num único local em **Diretórios → Enterprise Connectors**, com uma visão geral de cada connector, do seu estado e da finalidade para que é utilizado.

## Tipos de connector

O tipo é escolhido ao criar o connector e **não pode ser alterado posteriormente**:

| Tipo | Finalidade | Associado a |
|---|---|---|
| **Autenticação** | Valida inícios de sessão contra o Active Directory / LDAP e sincroniza utilizadores para um diretório empresarial. | Exatamente um diretório de utilizadores. |
| **Aprovisionamento** | Encaminha o aprovisionamento de saída (SCIM) para aplicações que se encontram dentro da sua rede. | Nenhum diretório: são as aplicações que o selecionam. |

Um connector de autenticação tem de estar associado a um diretório. Um diretório pode ter **vários** connectors de autenticação: cada pedido de início de sessão e de sincronização é enviado para o connector com a menor latência medida nesse momento e, quando um connector deixa de estar disponível, os outros assumem.

## Criar e registar um connector

1. Abra **Diretórios → Enterprise Connectors** e opte por criar um novo connector.
2. Introduza um **nome** e escolha o **tipo**.
3. Para um connector de **autenticação**, selecione o **diretório** que irá servir. Isto é obrigatório: o primeiro connector de autenticação de um diretório estabelece a chave segura que o diretório utiliza para proteger as palavras-passe de ponta a ponta, pelo que tem de saber a que diretório pertence.
4. Guarde. O connector aparece com um **URL de aprovisionamento** e um estado pendente.
5. Instale o software do connector na sua rede e registe-o utilizando esse URL de aprovisionamento. Assim que se ligar, o seu estado muda para **Ready**. O procedimento completo, incluindo os requisitos e a transferência do instalador, está descrito em [Instalar um Enterprise Connector](https://dts-identity.com/pt/docs/directories/enterprise-connector-installation.md).

O URL de aprovisionamento é de utilização única e expira após alguns dias. Se expirar antes do registo, elimine o connector pendente e crie um novo.

### Vários connectors e a chave partilhada

Todos os connectors de autenticação do mesmo diretório têm de funcionar com o **mesmo par de chaves**. O primeiro connector a registar-se define a chave do diretório; cada connector posterior tem de apresentar a mesma, caso contrário o registo é recusado. Desta forma, a proteção das palavras-passe mantém-se consistente, independentemente do connector que processa um determinado início de sessão.

## Estado e monitorização

Cada connector apresenta o seu estado atual:

- **Ready**: ligado e disponível.
- **Ligado**: ligado, mas ainda não totalmente inicializado.
- **Pendente**: criado, mas ainda não registado.
- **Desligado**: atualmente sem ligação.

Abra um connector para ver os detalhes do anfitrião, a versão, a hora da última ligação e um gráfico em tempo real do tempo de ida e volta enquanto estiver ligado.

Cada mudança de estado é registada no registo de auditoria como `CONNECTOR_ONLINE` / `CONNECTOR_OFFLINE`. Quando a maioria dos connectors de autenticação registados de um diretório está offline, um evento adicional `DIRECTORY_DEGRADED` assinala que o início de sessão nesse diretório pode estar comprometido. Utilize o modelo de alarme **Diretório degradado** para ser notificado sobre esta situação.

### Aviso de atualização

Quando está disponível uma versão mais recente do connector, o dashboard de administração apresenta um aviso no topo da página com a lista dos connectors que executam uma versão mais antiga, e a entrada **Enterprise Connectors** na navegação apresenta um ponto vermelho. Os connectors que nunca comunicaram uma versão, ou que não são vistos há 30 dias, não são aí listados. A lista de connectors marca cada connector que não tem a versão mais recente com o distintivo **Update available**, incluindo connectors que estão offline há mais tempo. O aviso desaparece assim que todos os connectors ativos executam a versão mais recente.

## Aprovisionamento através de um connector

Quando uma aplicação aprovisiona utilizadores num sistema que se encontra dentro da sua rede, pode encaminhar esse aprovisionamento através de um ou mais connectors de **aprovisionamento**. No separador **Aprovisionamento** da aplicação, em **Conectividade**, selecione os connectors a utilizar, por ordem de prioridade. Quando há connectors selecionados, o aprovisionamento passa **apenas** por eles; quando nenhum está selecionado, a plataforma liga-se diretamente ao destino através da internet.

## Remover um connector

Um connector pode ser eliminado assim que estiver **offline**. Desligue ou pare primeiro o connector na sua rede e, em seguida, elimine-o aqui.

## Resolução de problemas

- **O connector permanece Pendente**: o URL de aprovisionamento não foi utilizado a tempo ou o connector não consegue alcançar a plataforma. Confirme a conectividade de saída e, se o URL tiver expirado, crie novamente o connector.
- **Registo recusado para um connector adicional**: um segundo connector de autenticação no mesmo diretório tem de utilizar o mesmo par de chaves que o primeiro. Reutilize a chave existente.
- **O connector liga-se, mas é rejeitado por uma chave pública divergente**: o connector utiliza um par de chaves diferente daquele que está armazenado para o seu diretório. Importe para este connector o par de chaves exportado do connector original do diretório; se esse par de chaves se tiver perdido, remova todos os connectors de autenticação do diretório e registe-os novamente.
- **Não é possível eliminar um connector**: ainda está online. Pare-o primeiro e, em seguida, elimine-o.

Para o software na sua própria rede, consulte [Instalar um Enterprise Connector](https://dts-identity.com/pt/docs/directories/enterprise-connector-installation.md) e [Configurar e operar um Enterprise Connector](https://dts-identity.com/pt/docs/directories/enterprise-connector-configuration.md).
