SFTP – Ohjeet käyttöönottoon

SISÄLLYSLUETTELO

• SFTP – Ohjeet käyttöönottoon
  • Palvelun isännöinti ja tunnistautuminen
  • Konfigurointi
  • Siirtojen ajoitus ja tiheys
  • Raportointi ja virheiden käsittely
    • Liittyvät usein kysytyt kysymykset
  • Näin luot julkisen SSH-avaimen SFTP-palvelimelle
    • Muoto
    • Rakenne
    • SSH-avainten luominen 
    • Esimerkkiavaimesta
  • Ohjeet tiettyjen tietueiden siirtoon

Palvelun isännöinti ja tunnistautuminen

SFTP-kansiosi sijaitsee omalla SFTP-palvelimellaan (AWS:n kautta). Jokaiselle asiakkaalle luodaan oma käyttäjätunnus, jolla pääsee suoraan omaan kansioon. Tuemme avainpohjaista tunnistautumista. Sinun tulee siis luoda julkinen ja yksityinen avainpari sekä syöttää julkinen avain kohtaan Public Key kansion käyttöönoton yhteydessä. Avaimen tulee olla openSSH RSA –muodossa. Katso tarkemmat ohjeet avaimen luomiseen kohdasta Näin luot julkisen SSH-avaimen SFTP-palvelimelle alla.

Konfigurointi

1. Syötä luomasi julkinen avain kenttään Public Key . Voit halutessasi päivittää myös kentän Username . Kentän Username arvon tulee alkaa kirjaimella, numerolla tai alaviivalla, ja olla 3–100 merkkiä pitkä. Sallittuja merkkejä ovat kirjaimet, numerot, alaviiva (_), at-merkki (@), piste (.) ja tavuviiva (-).

2. Tallenna Username, Spotnana domain URLja Port number turvalliseen paikkaan, sillä näitä tietoja tarvitaan myöhemmin, kun organisaatiosi tiimi ottaa kansioon tiedonsiirrot käyttöön. 
   Huomio: Kun SFTP-kansion käyttöönotto on valmis, nämä tiedot löytyvät myös kohdasta Manage.

3. Syötä sähköpostiosoite(t), joihin haluat vastaanottaa tiedostosiirtoraportit kenttään SFTP email notification . Lisätietoja saat kohdasta Raportointi ja virheiden käsittely alla.

4. Napsauta Connect.

Kun julkinen avain on lisätty, alkuperäinen tila on Unverified. Tämä tila näkyy OBT:ssa, kunnes kansioon vastaanotetaan ensimmäinen tiedosto. Tiedosto voi olla testitiedosto, HR-siirto tai oma mukautettu tiedosto (vain tuetut tiedostomuodot käsitellään). Jos julkista avainta päivitetään myöhemmin, tila palautuu Unverified -tilaan, kunnes seuraava tiedosto saapuu.

Jos haluat poistaa SFTP-kansion, napsauta Disconnect. Tämä poistaa SFTP-kansion käytöstä. Jos tarvitset kansion uudelleen, kaikki yllä mainitut tiedot on syötettävä alusta alkaen.

Siirtojen ajoitus ja tiheys

Päätät itse, milloin ja kuinka usein tiedostoja siirretään. Tiedostojen käsittely käynnistyy heti, kun tiedosto siirretään SFTP-kansioon – sovelluksemme alkaa käsitellä tiedostoa välittömästi. 

Jos haluat suosituksia siirtotiheyksistä eri tietuetyypeille (esim. käyttäjät, mukautetut kentät, oikeushenkilöt), katso Siirtojen ajoitus ja tiheys -osio SFTP-ohjeissa kullekin tietuetyypille.

Raportointi ja virheiden käsittely

Keräämme tietoa tiedostosiirroista ja laadimme jokaisesta siirrosta sisäisen raportin. Tämä raportti lähetetään niihin sähköpostiosoitteisiin, jotka annoit kentässä SFTP email notification käyttöönoton yhteydessä. Jokaisesta siirretystä tiedostosta raportissa näkyy: 

• syyt, miksi tiedoston siirto epäonnistui (esim. väärä tiedostomuoto, puuttuvat sarakenimet jne.).

• syyt, miksi yksittäistä riviä tiedostossa ei voitu siirtää. Osittaisia päivityksiä ei tehdä, vaan rivi hylätään, jos siinä on virheellinen sarake tai pakollinen tieto puuttuu. 

• siirron tila (odottaa, onnistui, epäonnistui).

Raportin avulla voit selvittää mahdollisia virheitä. Jos et saa virhettä korjattua, ota yhteyttä tekniseen tukeen. 

Liittyvät usein kysytyt kysymykset

1. Hyväksymmekö lisätiedoston, joka sisältää vain päivitettävät tai lisättävät tietueet?

   • Kyllä

2. Tuleeko siirtämässäsi tiedostossa (riippumatta siitä, lähetetäänkö se SFTP:n kautta vai manuaalisesti) olla mukana myös valinnaiset sarakkeet, vaikka et käyttäisi niitä?

   • Ei

Näin luot julkisen SSH-avaimen SFTP-palvelimelle

Seuraa alla olevia ohjeita luodaksesi julkisen SSH-avaimen, jonka toimitat meille.

Muoto

• Tyyppi: Merkkijono

• Pituusrajoitus: enintään 2048 merkkiä.

Rakenne

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

SSH-avainten luominen 

Luo SSH-avaimet suorittamalla tämä komento Windowsin komentokehotteessa tai macOS-, Linux- tai UNIX-terminaalissa:

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

Missä 

• -t määrittää salauksen tyypin

• -b on avaimen pituus (biteissä)

• -f on avaimen nimi

Esimerkkiavaimesta

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

Ohjeet tiettyjen tietueiden siirtoon

Löydät tarkemmat ohjeet eri tietuetyyppien siirtoon SFTP:n kautta seuraavista aiheista:

• HR-siirrot (käyttäjät)
• Roolit
• Mukautetut kentät
• Toimistot
• Oikeushenkilöt