SFTP - Instrucciones de configuración

ÍNDICE

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

Alojamiento y autenticación

Su carpeta SFTP se aloja en un servidor SFTP independiente (a través de AWS). Cada cliente cuenta con un usuario único que accede directamente a su propia carpeta SFTP. Solo se permite autenticación por clave. Por ello, deberá generar un par de claves (pública y privada) y registrar la clave pública en el campo Public Key al momento de configurar su carpeta. La clave debe estar en formato openSSH RSA . Si necesita ayuda para crear las claves, consulte la sección Cómo crear una clave pública SSH para el servidor SFTP que encontrará más abajo.

Configuración

1. Ingrese la clave pública que generó en el campo Public Key . Si lo desea, puede modificar el valor del campo Username . El nombre de usuario debe comenzar con una letra, número o guion bajo, y tener entre 3 y 100 caracteres. Puede contener letras, números, guiones bajos, arrobas (@), puntos (.) y guiones (-). Username .

2. Copie los valores de Username, URL de dominio Spotnanay Número de puerto y guárdelos en un lugar seguro, ya que el equipo de su organización que configure el envío de archivos a la nueva carpeta los necesitará más adelante. 
   Nota: Una vez que la carpeta SFTP esté configurada, estos datos también estarán disponibles en la sección Administrar.

3. Indique la(s) dirección(es) de correo electrónico donde desea recibir los reportes sobre la carga de archivos en el campo SFTP email notification . Para más información, consulte la sección Reportes y gestión de errores que aparece más abajo.

4. Haga clic en Connect.

Cuando agregue una clave pública, el estado inicial será Unverified. Este será el estado que verá en OBT hasta que se reciba un archivo en la carpeta. Puede enviar un archivo de prueba o bien un archivo real de HR o de campos personalizados (solo se procesarán archivos en formatos admitidos). Si más adelante actualiza la clave pública, el estado volverá a Unverified hasta que se reciba el siguiente archivo.

Si desea eliminar su carpeta SFTP, haga clic en Disconnect. Esto eliminará la carpeta SFTP. Si en el futuro necesita configurarla nuevamente, deberá ingresar toda la información mencionada desde el principio.

Frecuencia y programación

Usted puede decidir con qué frecuencia y en qué horarios se cargarán los archivos. El procesamiento se inicia automáticamente en cuanto se detecta la creación de un archivo en la carpeta SFTP. Es decir, tan pronto como suba un archivo a su carpeta, nuestra aplicación comenzará a procesarlo. 

Para recomendaciones sobre la frecuencia y programación según el tipo de registro (por ejemplo, usuarios, campos personalizados, entidades legales), consulte la sección Frecuencia y programación en las instrucciones SFTP para cada tipo de registro.

Reportes y gestión de errores

Recopilamos información sobre cada archivo que sube y generamos un reporte interno después de cada carga. Este reporte se envía a la(s) dirección(es) de correo electrónico que indicó en el campo SFTP email notification durante la configuración. Por cada archivo cargado, el reporte incluirá: 

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

• las razones por las que una fila dentro del archivo no pudo cargarse. No realizamos actualizaciones parciales: si ocurre un error en una columna específica o falta un dato obligatorio en una fila, esa fila no se cargará. 

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

Puede utilizar el contenido de este archivo para identificar y corregir errores. Si no logra resolver el problema, comuníquese con soporte técnico. 

Preguntas frecuentes relacionadas

1. ¿Se acepta un archivo incremental que solo incluya los registros que deben actualizarse o agregarse?

   • Sí

2. ¿El archivo que sube (ya sea por SFTP o manualmente) debe incluir columnas opcionales aunque no las utilice?

   • No

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

Siga las siguientes instrucciones para generar la clave pública SSH que deberá proporcionarnos.

Formato

• Tipo: Cadena

• Restricciones de longitud: máximo 2048 caracteres.

Patrón

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

Creación de claves SSH 

Para crear las claves SSH, ejecute 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

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

Para instrucciones más detalladas sobre cómo cargar tipos de registros específicos mediante SFTP, consulte los siguientes temas según el tipo de registro:

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