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 4 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.


SmartSync initial setup

To perform this action, SmartSync must be installed and running on the server..

ATTENTION!
If an old Active Directory is migrated, during the migration it will not be possible to validate the login and password in AD. Users who need to refresh the cache (valid for 14 days from the time of creation) will not be able to authenticate.
Therefore, we recommend that this procedure be done during periods of lower system usage, such as in the early morning or on weekends.

01. Open the application and click the Configure button.

02. Include the protocol and environment information, which can be production or customerfi. Click Test to ensure that communication is occurring.

03. Click Next to continue configuring SmartSync. Proxy settings are not yet available in the current version of SmartSync.

04. Click Next and enter the Active Directory information registered in TOTVS Identity.

IP/Server name
Only the IP or AD server name, without the 'LDAP://' protocol and the service port.

User and Password
Active Directory admin login and password (admin credentials required).

Domain
Root domain. Base DN or first level. This information must be provided by the Active Directory administrator.

Token
Token copied from the directory in Identity. For more details about the token, check the item Copy token from directory in the Active Directory documentation.

05. Click Finish.

If the data is correct, after the configuration is complete, the main SmartSync screen will be displayed with the configured AD information.

If the data is incorrect, an error message will be displayed, and a new token must be generated to attempt configuration again.


Switch SmartSync port

To perform this action, SmartSync must be stopped and closed. The port can be changed at any time.

01. Open the appsettings.json file with the help of a text editor. It can be opened in Windows Notepad

02. Locate the URL field and change the port. The default port is 5325.  See image


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