SFTP - Instrucciones de configuración

ÍNDICE

• SFTP - Instrucciones de configuración
  • Alojamiento y autenticación
  • Configuración
  • Frecuencia y programación
  • Reportes y manejo de errores
    • Preguntas frecuentes relacionadas
  • Cómo crear una llave pública SSH para el servidor SFTP
    • Formato
    • Patrón
    • Creación de llaves SSH 
    • Ejemplo de llave
  • Instrucciones para tipos de registros específicos

Alojamiento y autenticación

Tu carpeta SFTP estará alojada en un servidor SFTP exclusivo (a través de AWS). Cada cliente tiene su propio usuario con acceso directo a su carpeta SFTP específica. Solo manejamos autenticación por llave. Por eso, es necesario que generes un par de llaves (pública y privada) y coloques la llave pública en el campo Public Key al momento de configurar tu carpeta. La llave debe estar en formato openSSH RSA . Si necesitas ayuda para crear tus llaves, revisa la sección Cómo crear una llave pública SSH para el servidor SFTP que aparece más abajo.

Configuración

1. Ingresa la llave pública que generaste en el campo Public Key . Si lo deseas, puedes actualizar el campo Username . El valor que coloques en Username debe empezar con una letra, número o guion bajo, y tener entre 3 y 100 caracteres. Puedes usar letras, números, guiones bajos, arrobas (@), puntos (.) y guiones (-).

2. Copia los valores de Username, URL de dominio Spotnanay Número de puerto y guárdalos en un lugar seguro, ya que el equipo encargado de configurar el envío de archivos a la nueva carpeta los necesitará más adelante. 
   Nota: Una vez que termines la configuración de la carpeta SFTP, estos datos también estarán disponibles en la sección Manage.

3. Indica el o los correos electrónicos donde quieres recibir los reportes de carga de archivos en el campo SFTP email notification . Para más información, revisa la sección Reportes y manejo de errores de abajo.

4. Haz clic en Connect.

Cuando agregues una llave pública, el estado inicial será Unverified. Este será el estado que verás en el OBT hasta que se reciba un archivo en la carpeta. Puedes enviar un archivo de prueba o un archivo real de HR o campos personalizados (solo se procesan archivos en formatos compatibles). Si luego actualizas la llave pública, el estado volverá a Unverified hasta que se reciba el siguiente archivo.

Si quieres eliminar tu carpeta SFTP, haz clic en Disconnect. Esto eliminará tu carpeta SFTP. Si más adelante necesitas configurarla de nuevo, deberás ingresar toda la información desde cero, como se explicó antes.

Frecuencia y programación

Tú decides cada cuánto y cuándo subir archivos. Nosotros detectamos automáticamente cuando subes un archivo a tu carpeta SFTP y, en ese momento, nuestra aplicación empieza a procesarlo. 

Si quieres recomendaciones sobre frecuencia y horarios específicos para cada tipo de registro (por ejemplo, usuarios, campos personalizados, entidades legales), consulta la sección Frecuencia y programación dentro de las instrucciones SFTP para cada tipo de registro.

Reportes y manejo de errores

Recopilamos información de cada archivo que subes y generamos un reporte interno después de cada carga. Este reporte se envía al correo o correos que indicaste en el campo SFTP email notification durante la configuración. Por cada archivo subido, el reporte incluye: 

• los motivos por los que una carga pudo fallar (formato incorrecto, columnas faltantes, etc.).

• los motivos por los que alguna fila dentro del archivo no se pudo cargar. No hacemos actualizaciones parciales: si hay un error en una columna o falta un dato obligatorio en una fila, esa fila se marca como fallida. 

• el estado de la carga (pendiente, exitosa o fallida).

Puedes revisar este archivo para solucionar cualquier error. Si no logras resolverlo, comunícate con soporte técnico. 

Preguntas frecuentes relacionadas

1. ¿Aceptamos archivos incrementales que solo incluyan los registros que se deben actualizar o agregar?

   • Sí

2. ¿Es necesario que el archivo que subas (ya sea por SFTP o manual) incluya columnas opcionales aunque no las uses?

   • No

Cómo crear una llave pública SSH para el servidor SFTP

Sigue las instrucciones de abajo para crear la llave pública SSH que nos vas a proporcionar.

Formato

• Tipo: Cadena de texto

• Restricciones de longitud: Máximo 2048 caracteres.

Patrón

 ^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

Creación de llaves SSH 

Para crear llaves SSH, ejecuta este comando en la línea de comandos de Windows o en la terminal de macOS, Linux o UNIX:

ssh-keygen -t rsa -b 4096 -f key_name

Dónde: 

• -t es el tipo de cifrado

• -b es la longitud de la llave (en bits)

• -f es el nombre de la llave

Ejemplo de llave

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

Instrucciones para tipos de registros específicos

Si necesitas instrucciones más detalladas para cargar tipos de registros específicos por SFTP, revisa los siguientes temas según el tipo de registro:

• HR feeds (usuarios)
• Roles
• Campos personalizados
• Oficinas
• Entidades legales