TOTVS Fluig English

Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 3 Próxima »


Speaking of New SmartSync... 

SmartSync is an application responsible for synchronizing data between Identity and Active Directory. The synchronized data includes creating new users and changing data such as first name, last name, e-mail, and linked groups.


Install SmartSync

Follow these steps to install SmartSync:

01. Check out the following requirements.

  • Check all requirements listed in the Portability Matrix.
  • Have the full ASP.NET package installed. At the time of installation, you can be directed to the installation link if you wish (see image). The option to download is the Hosting Bundle.
  • The server on which SmartSync is installed must necessarily be able to access the Identity domains (*.fluigidentity.com and *.customerfi.com) in order for users from Active Directory to be synchronized and authenticated. You must ensure that the proper exceptions are added to your network's proxy and firewall.
  • It is not mandatory to install SmartSync on the same server as the Active Directory, as long as the ping between the two is fully enabled.

02. Download the installer as instructed in the item Download the SmartSync installer in the Active Directory documentation.

03. Right-click the SmartSync installer and select the option Run as administrator or Install (depending on the operating system version).

04. Click Next to finish the installation.

Once SmartSync is installed on the server, you must configure it with the Active Directory directories so that synchronization of users and/or groups can be initiated.

There are two processes running for SmartSync:

  • SmartsyncApplication: responsible for monitoring all incoming and outgoing data to Identity, where user and group synchronization is managed.
  • SmartsyncWebApi: responsible for the visual aspect of SmartSync, where you can view statuses, configure settings, and download logs.

After installing and configuring SmartSync, you must keep the SmartsyncApplication process running.


Configuração inicial do SmartSync

Para realizar essa ação, é necessário que o SmartSync tenha sido instalado e executado no servidor.

IMPORTANTE!
Caso venha a ser feita a migração de um Active Directory antigo, durante a migração não será possível validar o login e senha no AD, os usuários que precisarem renovar o cache (validade de 14 dias desde a criação) não irão conseguir autenticar-se.
Por esse motivo, recomendamos que esse procedimento seja feito em período de menor utilização do sistema, por exemplo, durante a madrugada ou no fim de semana.

01. Abra a aplicação e acione o botão Configurar. 

02. Inclua as informações do protocolo e do ambiente, que pode ser produção ou customerfi. Acione Testar para garantir que a comunicação está ocorrendo. 

03. Acione Avançar para continuar a configuração do SmartSync. As configurações de proxy ainda não estão disponíveis na versão atual do SmartSync.

oculto

Tipo
A configuração de proxy pode ser: manual, padrão do sistema ou sem proxy.

  • Na configuração manual, é necessário informar o host, a porta, usuário e senha para conexão com o AD Sync. O botão Testar conexão ajuda a testar se a configuração informada está correta.
  • Na configuração padrão do sistema, o SmartSync utilizará as configurações de proxy definidas no sistema operacional para conectar-se ao AD Sync.
  • Sem proxy, o SmartSync tentará conectar-se diretamente ao AD Sync sem passar por um proxy.

04. Acione avançar e insira as informações do Active Directory cadastrado no TOTVS Identity.

IP/Nome do servidor
Apenas o IP ou nome do servidor de AD, sem o protocolo 'LDAP://' e sem a porta do serviço.

Usuário e Senha
Login e senha de administração do Active Directory (é obrigatório que as credenciais sejam de administrador).

Domínio
Domínio raiz. Base DN ou primeiro nível. Esta informação deve ser fornecida pelo administrador do Active Directory.

Token
Token copiado do diretório no Identity. Para mais detalhes sobre o token, verifique o item Copiar token do diretório da documentação do Active Directory.

05. Acione Concluir para finalizar.

Se os dados estiverem corretos, após a conclusão da configuração, a tela principal do SmartSync será apresentada com as informações do AD configurado.

Se os dados estiverem incorretos, será exibida mensagem de erro e será necessário gerar novo token para realizar uma nova tentativa de configuração.


Trocar porta do SmartSync

Para realizar essa ação, é necessário que o SmartSync esteja parado e fechado. A alteração de porta pode ser feita a qualquer momento.

1. Abra o arquivo appsettings.json com o auxílio de um editor de texto. Pode ser aberto no bloco de notas do Windows.

2. Localize o campo Url e altere a porta. A porta padrão é a 5325.  Veja a imagem


Acessar o SmartSync

Para que seja possível o acesso, é necessário que os serviços SmartsyncApplication e SmartsyncWebApi tenham sido previamente inicializados. Ao abrir as aplicações, o navegador será iniciado, abrindo a página inicial do SmartSync que fica em http://localhost:5000/home.

O SmartSync está organizado nas abas: Início e Active Directory. 

Caso seja o primeiro acesso, será necessário configurar o SmartSync, o que consiste nas etapas Proxy e Active Directory (explicadas nos itens Configurações de proxy e Adicionar Active Directory desta documentação).


Início

Na aba Início são apresentadas as principais informações sobre o SmartSync.


Conexão com o Identity

Nessa seção você preenche o ambiente a ser conectado com o AD, por padrão é o ambiente de produção: https://app.fluigidentity.com/. 

Editar ambiente: Realize alteração de protocolo e ambiente nos campos abaixo para testar conexão com Identity.

Testar conexão: Confira se a conexão foi estabelecida para cada ambiente em que o AD cadastrado aponta. 


Configurações de proxy

As configurações de proxy ainda não estão disponíveis na versão atual do SmartSync.

Na configuração padrão do sistema, o SmartSync utiliza as configurações de proxy definidas no sistema operacional para conectar-se ao AD Sync.

oculto

Tipo
Dados necessários para que o SmartSync use um proxy para acessar a rede externa. A configuração de proxy pode ser: manual, padrão do sistema ou sem proxy.

  • Na configuração manual, é necessário informar o host, a porta, usuário e senha para conexão com o AD Sync. O botão Testar conexão ajuda a testar se a configuração informada está correta.
  • Na configuração padrão do sistema, o SmartSync utilizará as configurações de proxy definidas no sistema operacional para conectar-se ao AD Sync.
  • Sem proxy, o SmartSync tentará conectar-se diretamente ao AD Sync sem passar por um proxy.


Logs de eventos

Apresenta os logs registrados pelo SmartsyncWebApi e SmartsyncApplication. É possível exportar esse log no formato .txt, para ver o detalhamento dos eventos detectados. Entre os eventos registrados, estão: data e início da aplicação, ambiente conectado, testes de conexão, filtros usados para encontrar usuários e grupos, erros na inclusão de diretórios Active Directory.

01. Na seção Logs de eventos, escolha o log desejado: SmartsyncWebApi ou SmartsyncApplication.

02. Verifique o período que deseja acompanhar.

03. Clique em Exportar.

04. Localize o log a ser exportado.

05. Acione Exportar.

Com isso, o log de eventos é baixado e pode ser visualizado no Bloco de notas ou leitor de arquivos texto de sua preferência.


Active Directory

Nessa aba é realizada a inclusão dos diretórios do Active Directory que serão gerenciados pelo SmartSync.

A coluna Situação Identity identifica quando o diretório está ativo para que seja possível a importação de usuários e grupos de permissão.

  • → Desconectado: Quando um Active Directory está inativo não realiza a sincronização.
  •  → Conectado: Quando um Active Directory está ativo e sincronizando.

Também é possível observar quando uma importação de usuários/grupos está em andamento e quando for finalizada, em cada Active Directory.

  • → Sincronizando: Importação de usuários e grupos ainda está sendo feita.
  • → Sincronizado: Importação de usuários e grupos finalizada.

Adicionar Active Directory

01. No SmartSync, certifique-se de estar na aba Active Directory.

02. Acione o botão Adicionar.

03. Na tela aberta, preencha as informações relacionadas ao Active Directory a ser sincronizado com o Identity.

IP
IP no qual o Active Directory está executando. 

Domínio
Domínio da rede.

Token
Token copiado do diretório no Identity. Para mais detalhes sobre o token, verifique o item Copiar token do diretório da documentação do Active Directory.

04. Clique em Adicionar.

Se todas as informações estiverem corretas, o Active Directory será adicionado na lista, e passará a sincronizar as informações com o Identity.

Caso tenha alguma inconsistência nos dados informados, o Active Directory não será adicionado na lista. Para identificar o problema, verifique o log conforme o item Logs de eventos dessa documentação.


Editar Active Directory

01. No SmartSync, certifique-se de estar na aba Active Directory.

02. Localize o Active Directory a ser alterado.

03. Acione Editar localizado ao lado direito da coluna Situação Identity.

04. Na tela aberta, corrija as informações necessárias. 

IP
IP no qual o Active Directory está executando. 

Domínio
Domínio da rede.

05. Clique em Editar para gravar as alterações.


Excluir Active Directory

01. No SmartSync, certifique-se de estar na aba Active Directory.

02. Localize o Active Directory a ser excluido.

03. Acione Excluir localizado ao lado direito da coluna Situação Identity.

04. Na mensagem de confirmação, marque a caixa de confirmação.

05. Acione Excluir.

Ao excluir a configuração do Active Directory, o processo de sincronização dos usuários e grupos irá parar definitivamente.



Fique atento!

Esta documentação é válida a partir da versão 5.0.0 ou superior do SmartSync. Se você utiliza uma atualização anterior, ela pode conter informações diferentes das quais você vê no seu ambiente.

  • Sem rótulos