SFTP - Instruccions de configuració

ÍNDEX

• SFTP - Instruccions de configuració
  • Allotjament i autenticació
  • Configuració
  • Freqüència i planificació
  • Informes i gestió d’errors
    • Preguntes freqüents relacionades
  • Com crear una clau pública SSH per al servidor SFTP
    • Format
    • Patró
    • Creació de claus SSH 
    • Exemple de clau
  • Instruccions per a tipus de registre específics

Allotjament i autenticació

El vostre directori SFTP estarà allotjat en un servidor SFTP independent (a través d’AWS). Cada client disposa d’un usuari exclusiu amb accés directe al seu directori SFTP. El sistema admet l’autenticació per clau. Per aquest motiu, caldrà que creeu un parell de claus (pública i privada) i indiqueu la clau pública al camp Clau pública durant la configuració del directori. La clau ha de ser en format openSSH RSA . Podeu consultar com crear les claus a la secció Com crear una clau pública SSH per al servidor SFTP a continuació.

Configuració

1. Introduïu la clau pública que heu generat al camp Clau pública . Si ho desitgeu, podeu modificar el valor del camp Nom d’usuari . El valor del camp Nom d’usuari ha de començar per una lletra, un número o un guió baix, i tenir entre 3 i 100 caràcters. S’hi permeten lletres, números, guions baixos, arroves (@), punts (.) i guions (-).

2. Guardeu el Nom d’usuari, l’URL de domini de Spotnanai el número de port en un lloc segur, ja que l’equip de la vostra organització que configuri l’enviament d’arxius a la nova carpeta els necessitarà més endavant. 
   Nota: Quan la carpeta SFTP estigui configurada, podreu tornar a consultar aquestes dades a l’apartat Gestiona.

3. Indiqueu l’adreça o adreces electròniques on voleu rebre els informes sobre les càrregues d’arxius al camp Notificació per correu electrònic SFTP . Per a més informació, consulteu la secció Informes i gestió d’errors a continuació.

4. Feu clic a Connecta.

Quan s’hagi afegit una clau pública, l’estat inicial serà No verificat. Aquest serà l’estat que es mostrarà a l’OBT fins que es rebi un arxiu al directori. Podeu enviar qualsevol arxiu de prova o bé un fitxer real d’usuaris, camps personalitzats o entitats legals (només es processaran els formats admesos). Si més endavant s’actualitza la clau pública, l’estat tornarà a ser No verificat fins que es rebi un nou arxiu.

Per eliminar la vostra carpeta SFTP, feu clic a Desconnecta. Això suprimirà la carpeta SFTP. Si més endavant la voleu tornar a configurar, haureu d’introduir de nou totes les dades indicades anteriorment.

Freqüència i planificació

Vosaltres decidiu quan i amb quina freqüència es pujaran els arxius. El sistema inicia el processament tan bon punt es crea l’arxiu al directori SFTP. Això vol dir que, tan aviat com pugeu un arxiu a la vostra carpeta del nostre servidor SFTP, l’aplicació començarà a processar-lo. 

Per a recomanacions de freqüència i planificació segons el tipus de registre (com ara usuaris, camps personalitzats o entitats legals), consulteu la secció Freqüència i planificació dins les instruccions SFTP de cada tipus de registre.

Informes i gestió d’errors

Recollim dades sobre les vostres càrregues d’arxius i, després de cada pujada, generem un informe intern. Aquest informe s’envia a les adreces electròniques que hàgiu especificat al camp Notificació per correu electrònic SFTP durant la configuració. Per a cada arxiu pujat, l’informe inclourà: 

• els motius pels quals una càrrega d’arxiu ha fallat (format incorrecte, columnes que falten, etc.).

• els motius pels quals una fila d’un arxiu no s’ha pogut pujar. No es fan actualitzacions parcials: si hi ha un error en una columna o falta un camp obligatori en una fila, aquesta fila fallarà. 

• l’estat de la càrrega (pendent, correcta o fallida).

Podeu utilitzar aquesta informació per resoldre errors. Si no aconseguiu solucionar-ho, poseu-vos en contacte amb el suport tècnic. 

Preguntes freqüents relacionades

1. Admetem arxius incrementals que només inclouen els registres que cal actualitzar o afegir?

   • Sí

2. Cal que l’arxiu que pugeu (ja sigui per SFTP o manualment) inclogui les columnes opcionals encara que no les feu servir?

   • No

Com crear una clau pública SSH per al servidor SFTP

Seguiu les instruccions següents per generar la clau pública SSH que ens haureu de facilitar.

Format

• Tipus: Cadena de text

• Restriccions de longitud: màxim 2048 caràcters.

Patró

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

Creació de claus SSH 

Per crear les claus SSH, executeu aquesta comanda a la línia d’ordres de Windows o al terminal de macOS, Linux o UNIX:

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

On 

• -t indica el tipus de xifrat

• -b indica la longitud de la clau (en bits)

• -f indica el nom de la clau

Exemple de clau

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

Instruccions per a tipus de registre específics

Si necessiteu instruccions concretes per carregar determinats tipus de registres mitjançant SFTP, consulteu els apartats següents segons el tipus de registre:

• HR feeds (usuaris)
• Rols
• Camps personalitzats
• Oficines
• Entitats legals