Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice
maxLevel4
exclude.*ndice

...


...

Speaking of New SmartSync... Image Modified

...

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

Image Removed

Instalar o SmartSync

Para realizar a instalação do SmartSync, siga os passos abaixo:

01. Confira os pré-requisitos a seguir.

Painel
borderColor#f2f2f2
bgColor#f2f2f2
  • Check all requirements listed in the Portability Matrix.
  • Have the full
  • Verifique todos os requisitos informados na Matriz de portabilidade.
  • Ter instalado o pacote ASP.NET completo. No momento da instalação, você pode ser direcionado ao link de instalação se desejar (veja a imagem). A opção a ser baixada é a Hosting Bundle.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 O servidor em que o SmartSync está instalado deve, obrigatoriamente, ser capaz de acessar os domínios do Identity (*.fluigidentity.com e and *.customerfi.com) para que a sincronização e a autenticação dos usuários do Active Directory sejam efetuadas. Você deve providenciar para que as devidas exceções sejam adicionadas ao proxy e firewall de sua rede.
  • Não é obrigatório instalar o SmartSync no mesmo servidor do diretório Active Directory, desde que a comunicação entre ambos (ping) esteja totalmente liberada.

02. Baixe o instalador conforme instruído no item Baixar instalador do SmartSync na documentação de Active Directory.

03. Clique com o botão direito do mouse sobre o instalador do SmartSync e selecione a opção Executar como administrador ou Instalar (dependendo da versão do sistema operacional).

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

02Download 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 installation04. Acione Avançar até concluir a instalação.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Após a instalação do SmartSync no servidor, é necessário configurá-lo com os diretórios Active Directory para que a sincronização dos usuários e/ou grupos possa ser iniciada.

Existem dois processos em execução para o SmartSync:

  • SmartsyncApplication: responsável por fazer todo o monitoramento do que recebe e envia para o Identity, onde é feito o controle dos usuários e grupos que são sincronizados.
  • SmartsyncWebApi: responsável pela parte visual do SmartSync, onde é possível ver os status, configurar, baixar logs.

Após a instalação e configuração do SmartSync, é necessário manter o processo SmartsyncApplication em execução.

Configuração inicial do SmartSync

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

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.

Painel
borderColor#fdf7e8
bgColor#fdf7e8
HTML
<div class="lms">
	<div class="lms-callout">
		<div class="lms-callout-image">
			<img class="lms-callout-thumb" src="http://tdn.totvs.com/download/thumbnails/286221066/importante.png" width="24" height="24">
		</div>
		<div class="lms-callout-body">
			<p class="lms-callout-text"
><b>IMPORTANTE
><b>PLEASE NOTE!</
b><br>Caso
b><br>SmartSync 
venha
creates 
a
Windows 
ser
services 
feita
automatically 
a
at 
migração
the 
de
time 
um
of 
Active Directory antigo
installation. However, 
durante
if 
a
you 
migração
need 
não
to 
será
create 
possível
it 
validar
manually, 
o
the 
login
steps 
e
are 
senha
in 
no
the 
AD,
<b>Windows 
os
Service 
usuários
Manual 
que
Creation</b> 
precisarem
section 
renovar
of this documentation.
</p>
		</div>
	</div>
</div>


Windows Service Manual Creation

...

SmartSync creates Windows services automatically at the time of installation.

01. Access the Windows prompt (cmd) and enter the following command to install the Windows service.

Bloco de código
sc create "SmartSync.Application" binpath="C:\Program Files\TOTVS\SmartSync\Application\SmartSync.Application.exe"

02. Still at the Windows prompt, type the command below to start the service.

Bloco de código
sc start "SmartSync.Application"


SmartSync initial setup

...

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

Painel
borderColor#fdf7e8
bgColor#fdf7e8
HTML
<div class="lms">
	<div class="lms-callout">
		<div class="lms-callout-image">
			<img class="lms-callout-thumb" src="http://tdn.totvs.com/download/thumbnails/286221066/importante.png" width="24" height="24">
		</div>
		<div class="lms-callout-body">
			<p class="lms-callout-text"><b>ATTENTION!</b><br>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.<br> Therefore, we recommend that this procedure be done during periods of lower system usage, such as in the early morning or on weekendso cache (validade de 14 dias desde a criação) não irão conseguir autenticar-se.<br> 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.</p>
		</div>
	</div>
</div>

...

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. 

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

Painel
borderColor#f2f2f2
bgColor#f2f2f2
titleoculto

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.

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 Finish04. Acione avançar e insira as informações do Active Directory cadastrado no TOTVS Identity.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

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

Image Removed

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. Image Added See image


Acess SmartSync

...

05. Acione Concluir para finalizarIn order for access to be possible, the SmartsyncApplication and SmartsyncWebApi services must have been previously initialized. When you open the applications, the browser will launch, opening the SmartSync home page which is located at http://localhost:5000/home.

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.
Painel
borderColor#f2f2f2
bgColor#f2f2f2

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. Image Removed 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.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

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

Image Removed

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.

Image Removed

Painel
titleoculto

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.

Image Removed

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.

SmartSync is organized under the tabs Home and Active Directory. 

If this is the first access, you will need to configure SmartSync, which consists of the Proxy and Active Directory steps (explained in the items Proxy settings and Add Active Directory of this documentation).


Home

...

The Home tab presents the main information about SmartSync.


Connecting to Identity

In this section, you will enter the environment to be connected to AD. The default setting is the production environment: https://app.fluigidentity.com/. 

Edit environment: Make protocol and environment changes in the fields below to test the connection to Identity.

Test connection: Check whether the connection was established for each environment where the registered AD points. 


Proxy settings

Proxy settings are not yet available in the current version of SmartSync.

In the default system configuration, SmartSync uses the proxy settings defined in the operating system to connect to AD Sync.


Event logs

Displays the logs recorded by SmartsyncWebApi and SmartsyncApplication. You can export this log in .txt format to see the details of the detected events.

Logs are stored according to the log level chosen:

  • Info: shows expected messages for regular use of SmartSync, as well as debug, warning and error messages.
  • Debug: shows debug messages that are only useful during development, as well as warning and error messages.
  • Warning: shows possible problems that are not yet errors, as well as error messages.
  • Error: shows problems that caused errors in SmartSync.

Events that are logged include application date and start, connected environment, connection tests, filters used to find users and groups, and Active Directory inclusion errors.


Export event logs

...

01In the Event Logs section, choose the desired log: SmartsyncWebApi or SmartsyncApplication.

02. Check the period you wish to track.

03. Click Export.

04. Locate the log to be exported.

05. Click Export.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

With this, the event log is downloaded and can be viewed in Notepad or your preferred text file reader.


Edit log level

...

01. In the Event logs section, click the Edit logs button.

02. Choose the log level you want: info, debug, warning or error.

03. Click Save05. Acione Exportar.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Com isso, o log de eventos é baixado e pode ser visualizado no Bloco de notas ou leitor de arquivos texto de sua preferênciaAfter saving the change, the chosen level will only be valid for the next logs generated.


Active Directory

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

...

On this tab, you can add the Active Directory directories that will be managed by SmartSync.

The Identity Status column identifies when the directory is active, enabling the import of users and permission groups

  • Disconnected: When an Active Directory is inactive, it does not synchronize.
  • Connected: When an Active Directory is active and synchronizing.

You can also see when a user/group import is in progress and when it is finished in each Active Directory.

  • Image Added→ Synchronizing: Importing of users and groups is still in progress.
  • Image Added Synchronized: Importing of users and groups has finished.


Add Active Directory

...

01. In SmartSync, make sure you are in the Active Directory tab.

02. Click the Add button.

03. In the open screen, fill in the information related to the Active Directory to be synchronized with

  • Image Removed → Desconectado: Quando um Active Directory está inativo não realiza a sincronização.
  •  Image RemovedConectado: 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.

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

Image Removed

Adicionar Active Directory

Image Removed

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.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

IP
IP no qual o The IP on which the Active Directory está executandois running

Domínio
Domínio da redeDomain
The network domain.

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

04. Click Add04. Clique em Adicionar.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

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.

...

If all the information is correct, the Active Directory will be added to the list and will start synchronizing information with Identity.

If there are any inconsistencies in the data entered, the Active Directory will not be added to the list. To identify the problem, check the log for the Event Logs item in this documentation.


Edit Active Directory

...

01. No SmartSync, certifique-se de estar na aba Active Directory In SmartSync, make sure you are in the Active Directory tab.

02. Localize o Locate the Active Directory a ser alteradoto change.

03. Acione Editar Image Removed localizado ao lado direito da coluna Situação Identity.Click Edit Image Added located to the right of the Identity Status column.

04. Update the necessary information on the open screen.04. Na tela aberta, corrija as informações necessárias. 

Painel
borderColor#f2f2f2
bgColor#f2f2f2

IP
IP no qual o The IP on which the Active Directory está executandois running

Domínio
Domínio da redeDomain
The network domain.

05. Clique em Editar para gravar as alterações Click Edit to save the changes.

...


Delete Active Directory

...

01. No In SmartSync, certifique-se de estar na aba make sure you are in the Active Directory tab.

02. Localize o Locate the Active Directory a ser excluidoto be deleted.

03. Acione Excluir Image Removed localizado ao lado direito da coluna Situação IdentityClick DeleteImage Added located to the right of the Identity Status column.

04. Na mensagem de confirmação, marque a caixa de confirmação In the confirmation message, check the confirmation box.

05. Acione Excluir Click Delete.

Painel
borderColor#f2f2f2
bgColor#f2f2f2

Ao excluir a configuração do When deleting the Active Directory , o processo de sincronização dos usuários e grupos irá parar definitivamenteconfiguration, the process of synchronizing users and groups will permanently cease.



Informações
titleFique atentoAttention!
Esta documentação é válida a partir da versão

This document is valid from 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

update. Previous updates may contain different information than what you see on your SmartSync.

HTML
<!-- Hotjar Tracking Code for http://help.fluig.com -->
<script>
    (function(h,o,t,j,a,r){
        h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
        h._hjSettings={hjid:743684,hjsv:6};
        a=o.getElementsByTagName('head')[0];
        r=o.createElement('script');r.async=1;
        r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
        a.appendChild(r);
    })(window,document,'https://static.hotjar.com/c/hotjar-','.js?sv=');
</script>

<script>
	$("b:contains('oculto')").parent().parent().hide();
</script>

<style type="text/css">
    .lms * {
      -webkit-box-sizing: border-box;
      -moz-box-sizing: border-box;
      box-sizing: border-box;
    }

    .lms-text-center {
      text-align: center;
    }

    .lms-full-height {
      height: 100%;
    }

    /* Component LMS Callout */

    .lms-callout {
      border: none;
      padding: 0px;

      display: -moz-box;
      -moz-flex-flow: row wrap;
      -moz-justify-content: center;
      -moz-align-items: center;

      display: -ms-flexbox;
      -ms-flex-flow: row wrap;
      -ms-justify-content: center;
      -ms-align-items: center;
      
      display: -webkit-flex;
      display: -webkit-box;
      -webkit-flex-flow: row wrap;
      -webkit-justify-content: center;
      -webkit-align-items: center;

      display: flex;
      flex-flow: row wrap;      
      justify-content: center;
      align-items: center;
    }
  
    .lms-callout .lms-callout-image {
      width: 24px;
    }

    .lms-callout .lms-callout-body {
      width: calc(100% - 24px);
      padding-left: 20px;
    }

	.lms-callout .lms-callout-citacao {
      border: 0px solid;
      border-left-width: 3px;
      border-left-color: #f36f21;
	  margin: 4px;
	  margin-left: 25px;
	  padding-left: 8px;
      font-size: 13px;
	}

    .lms-callout .lms-callout-thumb {
      width: 24px;
      height: 24px;
    }

    .lms-callout .lms-callout-text {
      color: #58595b;
      line-height: 1.75;
      margin: 0;
    }
</style>