SFTP - Instrucciones para la configuración

ÍNDICE

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

Alojamiento y autenticación

Nosotros alojamos tu carpeta SFTP en un servidor exclusivo (utilizando AWS). Cada cliente recibe una cuenta de usuario única con acceso directo a su propia carpeta SFTP. Solo manejamos autenticación por clave. Por eso, tendrás que generar un par de claves (pública y privada) y luego ingresar la clave pública en el campo Clave pública al momento de configurar tu carpeta. La clave debe estar en formato openSSH RSA formato. Para generar las llaves, consulta Cómo crear una clave pública SSH para el servidor SFTP más abajo.

Configuración

1. Ingresa la clave pública que generaste en el campo Clave pública. Si lo necesitas, también puedes actualizar el campo Nombre de usuario . El valor en el campo Nombre de usuario debe comenzar con una letra, número o guion bajo, y tener entre 3 y 100 caracteres. Puede incluir letras, números, guiones bajos, arrobas (@), puntos (.) y guiones (-).

2. Copia los valores de Nombre de usuario, URL de dominio de Spotnana y Número de puerto y guárdalos en un lugar seguro, ya que el equipo de tu organización que se encargue de configurar el envío de archivos a la nueva carpeta los va a necesitar más adelante. 
   Nota: Cuando termines de configurar la carpeta SFTP, podrás volver a consultar estos valores en Administrar.

3. Ingresa el o los correos electrónicos donde quieres recibir los reportes sobre la carga de tus archivos en el campo Notificación por correo SFTP. Para más información, revisa la sección Reportes y manejo de errores más abajo.

4. Haz clic en Conectar.

Cuando agregues una clave pública, el estado inicial aparecerá como No verificado. Así se mostrará en OBT hasta que se reciba un archivo en la carpeta. Puedes enviar un archivo de prueba o un archivo real de HR o de campos personalizados (solo se procesarán archivos en los formatos compatibles). Además, si luego cambias la clave pública, el estado volverá a No verificado hasta que se reciba un nuevo archivo.

Si quieres eliminar tu carpeta SFTP, haz clic en Desconectar. Esto eliminará tu carpeta SFTP. Si después necesitas configurarla de nuevo, tendrás que ingresar toda la información mencionada arriba desde cero.

Frecuencia y programación

Tú decides cada cuánto y cuándo subir los archivos. Usamos un disparador que detecta cuando se crea un archivo para iniciar el procesamiento. Esto significa que, en cuanto subas un archivo a tu carpeta en nuestro servidor SFTP, nuestra aplicación empezará a procesarlo de inmediato. 

Si necesitas recomendaciones sobre la frecuencia y el horario para cada tipo de registro (por ejemplo, usuarios, campos personalizados, entidades legales), consulta la sección de Frecuencia y programación en las instrucciones SFTP para cada tipo de registro.

Reportes y manejo de errores

Recolectamos información sobre los archivos que subes y la usamos para generar un reporte interno después de cada carga. Este reporte se envía al correo electrónico que ingresaste en el campo Notificación por correo SFTP durante la configuración. Por cada archivo que subas, el reporte incluirá: 

• los motivos por los que una carga falló (formato incorrecto, nombres de columnas faltantes, etc.).

• los motivos por los que alguna fila dentro del archivo no pudo subirse. No realizamos actualizaciones parciales; si hay un error en una columna específica o falta un campo obligatorio en esa fila, la fila completa será rechazada. 

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

Puedes usar la información de este archivo para revisar y resolver cualquier error. Si no logras corregirlo, comunícate con soporte técnico. 

Preguntas frecuentes relacionadas

1. ¿Aceptan un archivo incremental que solo incluya los registros que necesitan actualizarse o agregarse?

   • Sí

2. ¿El archivo que subes (ya sea por SFTP o manualmente) debe incluir las columnas opcionales aunque no las estés usando?

   • No

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

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

Formato

• Tipo: Cadena

• Restricciones de longitud: máximo 2048 caracteres.

Patrón

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

Cómo crear claves SSH

Para generar tus claves SSH, abre la línea de comandos en Windows o el terminal en macOS, Linux o UNIX y ejecuta el siguiente comando:

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

Donde:

• -t es el tipo de cifrado

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

• -f es el nombre de la clave

Ejemplo de clave

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 detalladas para cargar tipos de registros específicos por SFTP, revisa los siguientes temas según el tipo de registro:

• Alimentaciones de RRHH (usuarios)
• Campos personalizados
• Oficinas
• Entidades legales