PANKKILINJAN FTP - KUVAUS
2 Sisällysluettelo SISÄLLYSLUETTELO...2 YLEISTÄ...3 YHTEYSKÄYTÄNTÖ...4 YHTEYDEN AVAAMINEN JA FTP-SISÄÄNKIRJAUS...4 ASIAKKAAN JA PANKIN TODENNUS...5 PALVELUN PYYNTÖ...5 AINEISTON LÄHETYS...5 AINEISTON VASTAANOTTO...6 YHTEYDEN LOPETTAMINEN JA PURKAMINEN...6 MUUT MÄÄRITYKSET...7 MERKISTÖ...7 TIEDOSTOJEN NIMET...7 FTP-MÄÄRITYKSET...8 VERKOT...8 AVOIN INTERNETYHTEYS...8 IP-OSOITE...9 SIIRTOESIMERKIT...10 AINEISTON LÄHETYS...10 AINEISTON VASTAANOTTO...12
3 Yleistä Kuvauksessa määritellään miten TCP/IP:n FTP-tiedostosiirtoprotokolla käytetään Pankkilinjassa. FTP, eli File Transfer Protocol, on TCP/IP-yhteyksille kehitetty tiedostosiirtoprotokolla. Yhteystavaltaan käytetään FTPtä kuten Kermit-yhteystapaa eli asiakkaan ja Pankkilinjan välillä siirretään aineistot tietyn nimisissä tiedostoissa. Toiminnoltaan asiakkaan järjestelmä toimii FTP-clienttinä ja Pankkilinja vastaavasti FTP-serverinä Toiminto noudattaa RFC 959 FTP-määrittelydokumenttia mahdollisimman tarkasti.
4 Yhteyskäytäntö Kuten muissakin eräsiirtopalveluissa asiakkaan järjestelmä toimii tässäkin aktiivisena osapuolena eli muodostaa yhteyden ja lähettää ja/tai noutaa tietyn nimisiä tiedostoja. Yhteyskäytännön vaiheet: yhteydenotto tunnistus aineistojen lähetys/vastaanotto yhteyden lopetus Ohjaustiedostojen sisällöt ovat samat kuin vastaavat tiedostot Kermit-palvelussa. Yhteyden avaaminen ja FTP-sisäänkirjaus 1. Asiakkaan järjestelmän FTP-ohjelma avaa yhteyden Pankkilinjan FTP-ohjelmaan. Pankkilinjan IP-osoite ja porttinumero on mainittu kohdassa IP-osoite. 2. Pankkilinja vastaa Ok-ilmoituksella (220). Ellei palvelu ole käytettävissä vastataan virheilmoituksella ja katkaistaan yhteys. 3. Asiakkaan ohjelma suorittaa FTP-tason sisäänkirjauksen vakiokäyttäjätunnuksella ja -salasanalla. Sisäänkirjauksella ei ole merkitystä tietoturvan kannalta, mutta on mukana yhteensopivuussyistä. käyttäjätunnuksena voidaan käyttää esimerkiksi ftp tai anonymous salasanana voi asiakas käyttää mitä tahansa merkkijonoa, mutta suositellaan käytettävän asiakkaan linjatunnusta.
5 Asiakkaan ja pankin todennus Asiakas lähettää Patu ESI-sanomansa tiedostossa ASIAKAS ftp-komennolla: put asiakas. Pankkilinja vastaa ESI-sanomalla joka lähetetään asiakkaan määrittelemään tiedostoon ftp-komennolla: get <tiedostonimi>. Mikäli siirrossa tapahtuu virhe tai ESI-tietue on virheellinen voi Pankkilinja vastata FTP-ohjelman virheilmoituksella ja yhteys katkaistaan. Palvelun pyyntö Asiakkaan pyytämä palvelu välitetään PALVELU-tiedostossa, ftp-komento: put palvelu. PALVELU-tiedosto sisältää vain yhden tietueen, eli sovellussanoman. Aineiston lähetys Aineiston lähetysvaiheet: aineiston lähetys koontisumman vastaanotto aineiston hyväksymisen tai hylkäämisen lähetys loppukuittauksen vastaanotto Aineiston lähetys Palvelupyynnön jälkeen lähetetään varsinainen aineistoa sisältävä tiedosto, ftpkomento: put <tiedosto>. Tiedoston nimi voi olla mikä tahansa muu kuin tässä ohjeessa mainitut, kts. Tiedostojen nimet kappale. Mikäli aineisto on suojattu, on aineiston ensimmäinen tietue SUO-sanoma ja viimeinen tietue VAR-sanoma. Koontisumman vastaanotto Kun aineistoa sisältävä tiedosto on lähetetty, otetaan vastaan koontisumman sisältävä tiedosto, ftp-komento get <tiedosto>. Tiedosto sisältää yhden tietueen, koontisummasanoman, jonka sisältö on kuvattu Asynkronisen Kermit-tiedostosiirron kuvauksessa.
6 Kun aineisto on suojattu, em. tiedosto sisältää PTE-sanoman ja koontisummasanoma sijaitsee PTE-sanoman KUITTAUS-kentässä. Hyväksyminen tai hylkääminen Koontisumman vastaanoton jälkeen lähetetään kuittaustiedostossa VASTAUS, ftpkomento: put vastaus. Tiedosto sisältää tekstin HYVAKSYTAAN,KUITATAAN tai HYLATAAN, KUITATAAN riippuen siitä halutaanko lähetetty aineisto jatkokäsittelyyn tai ei. Loppukuittaus Kun VASTAUS-tiedosto on lähetetty, otetaan vastaan loppukuittaustiedosto, ftpkomento: get <tiedosto>. Tiedosto sisältää vain yhden tietueen, jonka sisältö on EOF, mikäli kuittausta ei ole pyydetty. Mikäli asiakas on pyytänyt HYV/HYL-sanomassa kuittauksen, kuittaussanoman sisältö on seuraava: Nimi Muoto Pituus Lisätiedot EOF-teksti AN 7 EOF Sovellustunnus AN 2 Sovellussanomasta Tyhjä AN 3 Erätunniste AN 4 Sovellussanomasta Tyhjä AN 3 Erän tarkenne AN 4 Sovellussanomasta Tyhjä AN 3 HYV/HYL-teksti AN 11 HYVAKSYTTY/ HYLATAAN Päivämäärä N 6 PPKKVV Tyhjä AN 1 Kellonaika N 6 HHMMSS Tyhjä AN 30 80 Aineiston vastaanotto Lähetettyään aineiston vastaanottoa määrittävän palvelu-pyynnön, asiakas siirtyy vastaanottotilaan ftp-komennolla: get <tiedosto>. Yhteyden lopettaminen ja purkaminen Asiakas lopettaa yhteyden lähettämällä LOPETUS-nimisen tyhjän tiedoston ftpkomennolla: put LOPETUS. Yhteyden purkaminen ja ftp-ohjelman lopettaminen tapahtuu ftp-komennolla: bye.
7 Muut määritykset Merkistö Yleensä aineistotietojen ja Pankkilinja-järjestelmän sanomissa käytetään 7-bittistä skandinaavista ASCII-koodia. Koodin skandinaaviset merkit esitetään seuraavasti: Merkki Heksades.arvo Å 5D Ä 5B Ö 5C å 7D ä 7B ö 7C Vuoropuhelu Tiedostojen nimet Vuoropuhelu pankkiyhteysohjelman ja Pankkilinjan välillä käydään ohjaussanomien avulla. Ohjaussanomat ja tiedot lähetetään tiedostoina, joissa tietueet lopetetaan aina CRLF-merkeillä. Siirtoja ja yhteyttä ohjataan sekä tiedostojen nimillä että niiden sisällöllä. Seuraavat tiedostonimet ovat ohjauskäytössä eikä näitä näinollen saa käyttää aineistojen tiedostoniminä. ASIAKAS PALVELU VASTAUS Asiakkaan tunnistetiedot Palvelupyynnöt Lähetyksen hyväksyminen/hylkääminen KUITTAUS Kuittaustiedosto hyväksymisanomaan
8 LOPETUS Yhteyden lopetustiedosto (tyhjä) FTP-määritykset Tiedostonimet noudattavat PC/MS-DOS nimistandardia siten, että vain tiedoston alkuosalla on merkitystä ja mahdollista loppuosaa ei oteta huomioon. Tällöin asiakkaalla voi olla esim. useita PALVELU-tiedostoja kuten PALVELU.ML tai PALVELU.OP. Tämä koskee kaikkia ohjaustiedostonimiä. Siirtomuodon oletusarvot ovat stream ja ascii. Siirrot tapahtuvat komennoilla get ja put. Muut komennot aiheuttavat virheen. Verkot Asiakkaan järjestelmä tulee olla liitetty kiinteästi johonkin seuraavaan TCP/IPverkkoon: Sonera Oyj, verkko DataNet Elisa Communications Oyj/Oy Datatie Ab, verkko LanLink Verkoissa yhteydet suojataan verkkotasolla pääsylistoilla, joten asiakkaan ja Samlinkin välillä tulee olla jommankumman edellä mainitun palveluntajoajan ylläpitämä yhdysliikennesopimus. Avoin Internetyhteys Aineiston siirrossa avoimen Internetverkon yli on aina käytettävä PATUturvajärjestelmää (esittäytyminen ja suojaus), joka suojaa siirrettävän aineiston muuttamiselta. Koska PATU-turvajärjestelmä ei salaa aineistoa, voi se avoimessa verkossa joutua ulkopuolisten nähtäväksi. Avoimen yhteyden käytöstä sovitaan paikallispankin kanssa erikseen.
9 IP-osoite LanLink-verkossa: 195.237.81.7 DatNet-verkossa: 194.252.52.57 Avoin Internetyhteys: bankline.samlink.fi ( tai 194.240.69.250 ) Portteina käytetään standardi portteja (21 ja 20). Tähän osoitteeseen myös passiivinen ftp toteutettu.
10 Siirtoesimerkit Aineiston lähetys ftp> open 194.252.52.57 5500 Connected to 194.252.52.57. 220 SP-pankkilinja FTP server User (194.252.52.57:(none)): ftp 331 Password required for ftp. Password: 230 User ftp logged in. ftp> put asiakas.esi 150 Ready to receive file ASIAKAS.ESI. 226 File ASIAKAS.ESI received. 161 bytes sent in 0.00 seconds (161000.00 Kbytes/sec) ftp> get esip 150 Ready to send file esip. 226 File esip sent. 239 bytes received in 0.00 seconds (239000.00 Kbytes/sec) ftp> put palvelu.ml 150 Ready to receive file PALVELU.ML. 226 File PALVELU.ML received. 9 bytes sent in 0.00 seconds (9000.00 Kbytes/sec)
11 ftp> put palkat 150 Ready to receive file PALKAT. 226 File PALKAT received. 1640 bytes sent in 0.06 seconds (27.33 Kbytes/sec) ftp> get ksumma 150 Ready to send file ksumma. 226 File ksumma sent. 82 bytes received in 0.00 seconds (82000.00 Kbytes/sec) ftp> put vastaus 150 Ready to receive file VASTAUS. 226 File VASTAUS received. 10 bytes sent in 0.00 seconds (10000.00 Kbytes/sec) ftp> get eof 150 Ready to send file eof. 226 File eof sent. 5 bytes received in 0.00 seconds (5000.00 Kbytes/sec) ftp> put lopetus 150 Ready to receive file LOPETUS. ftp>bye
12 Aineiston vastaanotto ftp> open 195.237.81.7 5500 Connected to 195.237.81.7. 220 SP-pankkilinja FTP server User (172.20.20.84:(none)): 000000 331 Password required for 000000. Password: 230 User 000000 logged in. ftp> put asiakas.esi 150 Ready to receive file ASIAKAS.ESI. 226 File ASIAKAS.ESI received. 161 bytes sent in 0.06 seconds (2.68 Kbytes/sec) ftp> get esip 150 Ready to send file esip. 226 File esip sent. 239 bytes received in 0.05 seconds (4.78 Kbytes/sec) ftp> put palvelu.k6l 150 Ready to receive file PALVELU.K6L. 226 File PALVELU.K6L received. 12 bytes sent in 0.06 seconds (0.20 Kbytes/sec) ftp> get k6ldata
13 150 Ready to send file k6ldata. 226 File k6ldata sent. 20085 bytes received in 0.88 seconds (22.82 Kbytes/sec) ftp> put lopetus 150 Ready to receive file LOPETUS. ftp>bye