User guide - For testing SFTP and HTTP/S data communication with Nets Danmark A/S P. 1-9
Index General information... 3 Introduction... 3 Rights... 3 Limitations... 3 Prerequisites... 3 Preparations... 4 How to get started... 4 Establish a mail box for test purpose... 4 Generate your private key... 4 Testing SFTP connection... 4 Testing HTTP/S connection... 4 Test cases... 5 Introduction... 5 Sending files... 5 Fetching data files... 5 Appendix 1: Content of data files... 6 Transmission receipt... 6 Validation receipt no. 1... 6 Validation receipt no. 2... 7 Data file 1... 8 Data file no. 2... 8 Data file no. 3... 8 Kontact Nets... 9 Kontact addresses... 9 P. 2-9
General information Introduction This user guide is intended for customers who want to test their SFTP- or HTTP/S data communication software with Nets Danmark A/S hereafter mentioned as Nets. (Nets is the result of the merge of PBS and Norwegian BBS). Remark: It is a prerequisite that you have a brief knowledge about the data communication solution to get the full understanding of this User guide. The guide describes how to make an interface test against a test server at Nets. This gives you the opportunity to test that the software at your own server can communicate with Nets. Please notice that this test does not include any kind of validation of any transactions transmitted. The purpose with this test is only to enable you to control your procedures concerning generating you private key and to control that you have developed your scripts handling the data communication correctly. If you discover problems using this facility, please contact ServiceDesk at Nets. Information about contacting Nets you can find in the chapter: Contact. Rights All rights to this guide and the corresponding product belong to Nets. Copying, forwarding or in any other manner making this material or parts thereof available to third parties without the consent of Nets is not permitted. Limitations 1: All User Guides for the SFTP solution generally are in force. Please notice that there are other IP addresses for the key generation and for the SFTP connection. They are described in the following chapters. 2: The data files that you can receive from your test mailbox at Nets do not contain any relevant data compared to normal data files you exchange with Nets. However it is possible to receive all kind of data file types: Dfiles, T-files and so on. The standard for naming the data files also roules for the test system. 3: If you have received data files from your mailbox, up to one hour will pass before there will be new data files ready for you to receive. This is caused by the fact that the test system is checking once per hour if there is a need to place new files in your mailbox. 4: Your mailbox for test purposes will be available for 30 days after you have generated your private key. If you have a need to test for longer period, please contact ServiceDesk at Nets. Prerequisites It is assumed that you have installed your chip card reader. P. 3-9
Preparations How to get started This section describes how you prepare the test of your SFTP connection. Establish a mail box for test purpose Contact ServiceDesk at Nets and ask them to generate an SFTP mailbox for test purpose. When calling you should have your User ID at hand. ServiceDesk creates a mailbox on the test server at Nets. The User Id for this mailbox will be the same as for your mailbox on production with one exception: The first character of your User id is changed to the character T. A mailbox on production named ABCDEFGH will be named TBCDEFGH on test. The password for your mailbox on test will be set to the same value as your User Id. You are requested to change this initial password to a password only known by you. Generate your private key Testing SFTP connection Reference: User Guide Key generation for SFTP solution. Follow the guidelines in the User Guide, but remember that you should log on to https://ft.test.pbs.dk/key instead of the website described on page 7 in the User Guide. ALSO remember to type in the User ID corresponding to your test mailbox. References: Installation and user guide CLC. This user guide is available for both Windows- and Unix users. The User guides mentioned above are at force, but remember that the DNS, at DNS for Nets test server is HTTPS://FT.TEST.PBS.DK IP-address is 92.60.159.21. Also remember to use the User ID, which is valid for your test mailbox when you connect to the test server. Testing HTTP/S connection References : User Guide HTTP/S solution. The User Guide above is at force, but remember that you should use the URL HTTPS://FT.TEST.PBS.DK instead of the one mentioned in the User Guide. Also remember to use the User ID and password, which is valid for your test mailbox. P. 4-9
Test cases Introduction In this section you will find suggestions for test cases you can establish. Please notice that those mentioned only are suggestions. You can of course make other test cases where you combine your send- and receive commands in other ways than mentioned. Sending files With the SFTP connection it is possible to schedule the jobs/scripts to send data files automatic. Testing this function can include the following cases in accordance with the way you have configured the SFTP solution : 1: Test that the transmission of data files are as supposed and in accordance with your put -commands 2: Test that the transmission of data files is as expected and in accordance with your way of scheduling (e.g. Crontrab for Unix users). Please notice that when you have sent one ore more data files to your test mailbox, you can not use SFTP commands to control if the files have been placed in your mailbox by submitting a get or mget command for those files. This is caused by the fact that get commands only will deliver files to you, which have been created by Nets and therefore are meant to be fetched by you. So you should use your own log file to control this. Fetching data files With the SFTP connection it is possible to schedule jobs / scripts to get data files from you mailbox at Nets automatic. In order to test this Nets will put a number of files in your mailbox. Once an hour we are checking if the files are present. If not, we will put them there. The following files will be placed in your mailbox for your retrieval : D12345678.BS1 D12345678.BS2 D12345678.LS1 T123456782411 V12345678.BS1 V12345678.BS2 The content of the data files is shown in appendix 1. Please notice that the content of the data files has no relation to production data or to data that you are sending to Nets. When you have received data files from your mailbox, up to one hour will pass before you can fetch the data files again. Test for example that you can retrieve all data files starting with D for a given sub system (e.g. BS), that you can retrieve all data files starting with T or V. P. 5-9
Appendix 1: Content of data files Transmission receipt Transmission receipt named T12345678.BS1 contains : PBCNET40BS1 05062411 050624092412+PN00DATA ACCEPTERET Denne leverance har navnet T123456782411.BS1 Leverancer, der starter med T er transmissionskvitteringer, der viser om transmissionen er gået godt. Denne transmissionskvittering har ikke nogen sammenhæng med dataleverancer du selv har sendt ind til testsystemet. Indholdet i denne testleverance afspejler ikke produktionsdata hverken i opbygning eller indhold. Validation receipt no. 1 The validation receipt named V12345678.BS1 contains : PBCNET41KSI 05062724 050627091123-PN10FEJL UNDER BEHANDLING I PBS ******************************************************************* VALIDERINGSKVITTERING FOR MODTAGET FIL Her anføres antal af accepterede records og evt. afviste records Denne dataleverance har navnet V12345678.BS1. Denne valideringskvittering har ikke nogen sammenhæng til leverancer, du selv har sendt ind til testsystemet. Opbygningen af denne valideringskvittering har ikke nogen sammenhæng til produktionsvilkår hverken indholdsmæssigt eller opbygningsmæssigt. MED VENLIG HILSEN PBS A/S ******************************************************************** P. 6-9
Validation receipt no. 2 The validation reciept named V12345678.BS2 contains : PBCNET41BS2 05062724 050627091123-PN10FEJL UNDER BEHANDLING I PBS ******************************************************************* VALIDERINGSKVITTERING FOR MODTAGET FIL Her anføres antal af accepterede records og evt. afviste records Denne dataleverance har navnet V12345678.BS1 Denne valideringskvittering har ikke nogen sammenhæng til leverancer, du selv har sendt ind til testsystemet. Opbygningen af denne valideringskvittering har ikke nogen sammenhæng til produktionsvilkår hverken indholdsmæssigt eller opbygningsmæssigt. MED VENLIG HILSEN PBS A/S ******************************************************************* * P. 7-9
Data file 1 The data file named D12345678.BS1 contains: BS00211111111BS106023925197001 070605 Denne leverance har navnet D12345678.BS1 Dataleverancer, der starter med D er leverancer til dig fra et PBSsystem Indholdet i denne testleverance afspejler ikke produktionsdata hverken i opbygning eller indhold. Data file no. 2 The data file named D12345678.BS2 contains: BS00211111111BS106023925197001 070605 Denne leverance har navnet D12345678.BS2 Dataleverancer, der starter med D er leverancer til dig fra et PBSsystem Indholdet i denne testleverance afspejler ikke produktionsdata hverken i opbygning eller indhold. Data file no. 3 The data file named D12345678.LS1 contains: LS00211111111LS106023925197001 070605 Denne leverance har navnet D12345678.LS1 Dataleverancer, der starter med D er leverancer til dig fra et PBSsystem Indholdet i denne testleverance afspejler ikke produktionsdata hverken i opbygning eller indhold. P. 8-9
Kontact Nets Kontact addresses If you have problems with your login or file transfer you can contact Nets technical department, ServiceDesk, using: Telehone 44 89 73 73, enter 2 E-mail address servicedesk@pbs.dk Business hours Monday Thursday 08:30 16:30 Friday : 09:00 16:00 P. 9-9