Falando de Novo SmartSync


O SmartSync é um aplicativo responsável pela sincronização de dados entre o Identity e o Active Directory. Os dados sincronizados incluem a criação de novos usuários, alteração de dados como nome, sobrenome, e-mail e os grupos vinculados.

Instalar o SmartSync


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

01. Confira os pré-requisitos a seguir.

	<div class="checkbox">
      <label><input type="checkbox" value="">Verifique todos os requisitos informados na <a href = "https://tdn.totvs.com/x/eDAxE" style="color: #4bb9dc"><b>Matriz de portabilidade</b></a>.</label></div>  
	<div class="checkbox">
      <label><input type="checkbox" value="">Ter instalado o pacote ASP .NET completo. No momento da instalação, você pode ser direcionado ao link de instalação se desejar <a href = "https://tdn.totvs.com/pages/viewpageattachments.action?pageId=696706457&highlight=ASP+NET+completo.PNG&preview=/696706457/742218901/mensagem.PNG" style="color: #4bb9dc">(veja a imagem)</a>. A opção a ser baixada é a  <a href = "https://tdn.totvs.com/pages/viewpageattachments.action?pageId=696706457&highlight=ASP+NET+completo.PNG&preview=/696706457/742218981/ASP%20NET%20completo.PNG" style="color: #4bb9dc"><b>Hosting Bundle</b></a>.</label></div>  
	<div class="checkbox">
      <label><input type="checkbox" value="">O servidor em que o SmartSync está instalado deve, obrigatoriamente, ser capaz de acessar os domínios do Identity (*.fluigidentity.com e *.customerfi.com) para que a sincronização e a autenticação dos usuários do Active Directory sejam efetuadas. O cliente deve providenciar para que as devidas exceções sejam adicionadas ao proxy e firewall de sua rede.</label></div>
	<div class="checkbox">
      <label><input type="checkbox" value="">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.</label></div>

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

04. Acione Avançar até concluir a instalação.

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:

  • SmartSyncService: 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.
  • SmartSyncApi: 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 SmartSyncService 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.

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

02. Nas informações de proxy, acione Avançar. As configurações de proxy ainda não estão disponíveis na versão atual do SmartSync.

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.

03. Insira as informações do Active Directory cadastrado no TOTVS Identity.

IP/Nome do servidor

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

Host e Porta
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.

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


Acessar o SmartSync


Para que seja possível o acesso, é necessário que os serviços SmartSyncService e SmartSyncApi tenham sido previamente inicializados.

01. No navegador de sua preferência, acesse 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.

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 SmartSyncApi e SmartSyncService. É 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: SmartSyncApi ou SmartSyncService.

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.

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

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.



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.

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