Árvore de páginas


Hablando de Nuevo SmartSync...


SmartSync es una aplicación que se encarga de sincronizar datos entre Identity y Active Directory. Los datos sincronizados incluyen la creación de nuevos usuarios, el cambio de datos como nombre, apellido, correo electrónico y los grupos vinculados.

Instalar SmartSync


Para instalar SmartSync, siga los pasos que se detallan a continuación:

01. Verifique los requisitos previos a continuación.

  • Verifique todos los requisitos informados en la Matriz de portabilidad.
  • Tener instalado el paquete ASP.NET completo. En el momento de la instalación, puede ser dirigido al enlace de instalación si lo desea (vea la imagen). La opción para descargar es Hosting Bundle.
  • El servidor donde está instalado SmartSync obligatoriamente, debe poder acceder a los dominios de Identity (*.fluigidentity.com y *.customerfi.com) para que se lleve a cabo la sincronización y la autenticación de los usuarios de Active Directory. Debe asegurarse de que se agreguen las excepciones necesarias al proxy y firewall de su red.
  • No es obligatorio instalar SmartSync en el mismo servidor que el directorio de Active Directory, siempre que la comunicación entre ambos (ping) esté completamente habilitada.

02Descargue el instalador como se indica en el ítem Descargar instalador de SmartSync en la documentación de Active Directory.

03. Haga clic en el botón derecho del mousesobre el instalador de SmartSync y seleccione la opción Ejecutar como administrador Instalar (dependiendo de la versión del sistema operativo).

04. Haga clic en Siguiente hasta que finalice la instalación. 

Después de instalar SmartSync en el servidor, es necesario configurarlo con los directorios de Active Directory para que se pueda iniciar la sincronización de usuarios y/o grupos.

Hay dos procesos en ejecución para SmartSync:

  • SmartsyncApplication: responsable de hacer todo el seguimiento de lo que recibe y envía a Identity, donde se controlan los usuarios y grupos que se sincronizan.
  • SmartsyncWebApi: responsable de la parte visual de SmartSync, donde se puede ver el estado, configurar, descargar registros.

Después de la instalación y configuración de SmartSync, es necesario mantener el proceso SmartsyncApplication en ejecución.

¡IMPORTANTE!
SmartSync hace la creación de los servicios de Windows automáticamente en el momento de la instalación. Sin embargo, si es necesario crear manualmente, los pasos están en el punto Creación manual del servicio de Windows en esta documentación.


Creación manual del servicio de Windows


SmartSync hace la creación de los servicios de Windows automáticamente en el momento de la instalación.

01. Acceda al prompt de Windows (cmd) y escriba el siguiente comando para instalar el servicio de Windows.

sc create "SmartSync.Application" binpath="C:\Program Files\TOTVS\SmartSync\Application\SmartSync.Application.exe"

02. Aún en el prompt de Windows, escriba el siguiente comando para iniciar el servicio.

sc start "SmartSync.Application"


Configuración inicial de SmartSync


Para realizar esta acción, SmartSync debe estar instalado y ejecutándose en el servidor.

IMPORTANTE!
En caso de que la migración se realice desde un Active Directory antiguo, durante la migración no será posible validar el nombre de usuario y la contraseña en el AD, los usuarios que necesiten renovar la caché (vigencia de 14 días desde la creación) no podrán autenticarse.
Por este motivo, recomendamos que este procedimiento se realice durante los períodos de menor uso del sistema, por ejemplo, durante la noche o el fin de semana.

01. Abra la aplicación y active el botón Configurar.

02. Incluya la información del protocolo y del entorno, que puede ser producción o customerfi. Haga clic en Probar para asegurarse de que la comunicación se está llevando a cabo. 

03. Haga clic en Siguientepara continuar con la configuración de SmartSync. La configuración de proxy aún no está disponible en la versión actual de SmartSync.

04. Haga clic en Siguiente e ingrese la información de Active Directory registrado en TOTVS Identity.Abra a aplicação e acione o botão Configurar. 

IP/Nombre del servidor
Solo el IP o el nombre del servidor de AD, sin el protocolo 'LDAP://' y sin el puerto de servicio.

Usuario Contraseña
Nombre de usuario y contraseña de administración de Active Directory (las credenciales de administrador son obligatorias).

Dominio
Dominio raíz. Base DN o primer nivel. Esta información la debe proporcionar el administrador de Active Directory.

Token
Token copiado del directorio en Identity. Para conocer más detalles sobre el token, verifique el ítem Copiar token del diretorio de la documentación de Active Directory.

05.  Haga clic en Concluir para finalizar.

Si los datos son correctos, luego de finalizar la configuración, se mostrará la pantalla principal de SmartSync con la información del AD configurado.

Si los datos son incorrectos, se mostrará un mensaje de error y será necesario generar un nuevo token para realizar un nuevo intento de configuración.


Cambiar puerto de SmartSync


Para realizar esta acción, SmartSync debe estar detenido y cerrado. El cambio de puerto se puede hacer en cualquier momento.

01. Abra el archivo appsettings.json con la ayuda de un editor de texto. Puede abrirse en el bloc de notas de Windows.

02. Ubique el campo Url y cambie el puerto. El puerto predeterminado es el 5325.  Vea la imagen


Acceda al SmartSync


Para que el acceso sea posible es necesario que previamente se hayan inicializado los servicios SmartsyncApplication y SmartsyncWebApi. Al abrir las aplicaciones, se iniciará el navegador, abriendo la página de inicio de SmartSync que se encuentra en http://localhost:5000/home.

SmartSync está organizado en las pestañas: Inicio y Active Directory. 

En caso de que sea el primer acceso, será necesario configurar SmartSync, que consta de las etapas Proxy y Active Directory (explicadas en los ítems Configuración de proxy y Agregar Active Directory de esta documentación).


Inicio


La información principal sobre SmartSync se muestra en la pestaña Inicio.


Conexión con Identity


En esta sección, complete el entorno para conectarse a AD, por defecto es el entorno de producción: https://app.fluigidentity.com/. 


Editar entorno

Cambie el protocolo y el entorno en los campos a continuación para probar la conexión con Identity.

Probar conexión

Verifique si se estableció la conexión en cada entorno a que apunta el AD registrado. 


Configuración de proxy


La configuración de proxy aún no está disponible en la versión actual de SmartSync.

En la configuración predeterminada del sistema, SmartSync utiliza la configuración de proxy definida en el sistema operativo para conectarse a AD Sync.


Registros de eventos


Presenta los registros grabados por SmartsyncWebApi y SmartsyncApplication. Es posible exportar este registro en formato .txt, para ver el detalle de los eventos detectados.

Los logs se almacenan de acuerdo con el nivel de log elegido, que son:

  • Info (información): muestra los mensajes esperados para el uso normal de SmartSync, así como los mensajes de debug, warning y error.
  • Debug (depuración): muestra los mensajes de la depuración que solo son útiles durante el desarrollo, así como los mensajes de warning y error.
  • Warning (aviso): muestra posibles problemas que aún no son errores, así como mensajes de error.
  • Error (error): muestra problemas que causaron errores en SmartSync.

Entre los eventos registrados están: la fecha e inicio de la aplicación, el entorno conectado, las pruebas de conexión, los filtros utilizados para encontrar usuarios y grupos, los errores en la inclusión de directorios de Active Directory.

Exportar registros

01. En la sección Registros de eventos, elija el registro que desea: SmartsyncWebApi o SmartsyncApplication.

02. Verifique el período del que desea hacer un seguimiento.

03. Haga clic en Exportar.

04. Ubique el registro que desea exportar.

05. Haga clic en Exportar.

Con ello, el registro de eventos se descarga y se puede visualizar en el Bloc de notas o en el lector de archivos de texto que usted elija.

Editar nivel del log

01. En la sección Logs de eventos, accione el botón Editar Logs.

02. Elija el nivel de log que desea: info, debug, warning o error.

03. Accione Guardar

Después de guardar la modificación, el nivel elegido es válido solo para los siguientes logs generados.


Active Directory


En esta pestaña se realiza la inclusión de los directorios de Active Directory que serán administrados por SmartSy.

La columna Estado de Identity identifica cuándo el directorio está activo para que se pueda realizar la importación de usuarios y grupos de permisos.

  • → Desconectado: Cuando un Active Directory está inactivo, no se sincroniza.
  •  Conectado: Cuando un Active Directory está ativo y sincronizando.

También se puede observar cuándo está en curso una importación de usuario/grupo y cuándo finaliza, en cada Active Directory.

  • → Sincronizando: La importación de usuarios y grupos aún se está realizando.
  • Sincronizado: Importación de usuarios y grupos finalizada.


Agregar Active Directory


01. En SmartSync, asegúrese de estar en la pestaña Active Directory.

02. Active el botón Agregar.

03. En la pantalla abierta, complete la información relacionada con Active Directory que se sincronizará con Identity.

IP
IP en la que se está ejecutando Active Directory. 

Domínio
Dominio de la red.

Token
Token copiado del directorio en Identity. Para obtener más detalles sobre el token, consulte el ítem Copiar token del diretorio dela documentación de Active Directory.

04. Haga clic en Agregar.

Si toda la información es correcta, Active Directory se agregará a la lista y comenzará a sincronizar la información con Identity.

Si hay alguna inconsistencia en los datos ingresados, Active Directory no se agregará a la lista. Para identificar el problema, verifique el registro del ítem Registro de eventos de esta documentación.


Editar Active Directory


01. En SmartSync, asegúrese de estar en la pestaña Active Directory.

02. Ubique Active Directory que se va a cambiar.

03. Active Editar ubicado a la derecha de la columna Estado de Identity.

04. En la pantalla abierta, corrija la información necesaria. 

IP
IP en el que se está ejecutando Active Directory. 

Domínio
Dominio de la red.

05. Haga clic en Editar para guardar los cambios.


Eliminar Active Directory


01. En SmartSync, asegúrese de estar en la pestaña Active Directory.

02. Ubique Active Directory que desea eliminar.

03. Active Eliminar ubicado a la derecha de la columna Estado de Identity.

04. En el mensaje de confirmación, marque la casilla de confirmación.

05. Active Eliminar.

Al eliminar la configuración de Active Directory, el proceso de sincronización de los usuarios y grupos se detendrá de forma definitiva.



¡Esté atento!

Esta documentación es válida a partir de la actualización 5.0.0. Si utiliza una actualización anterior, puede contener información diferente de la que ve en SmartSync.

  • Sem rótulos