IBM Support

Configuring SSL FTP Server

Technote (troubleshooting)


Problem(Abstract)

This document includes steps to configure the iSeries FTP server to use SSL.

Resolving the problem

This document includes steps to configure the iSeries FTP server to use SSL.

Use the following steps to configure the iSeries FTP server to use SSL. This document was created under the assumption that the user has already accessed Digital Certificate Manager (DCM) and has already either purchased a third-party certificate, or has created their own certificate to assign to the FTP server.

1. In the CHGFTPA screen (F4 to prompt this command), set the Allow secure sockets layer option to *YES. The *ONLY option will also allow SSL FTP connections; however, it will not allow regular non-secure connections to come through. After making the change, restart the FTP server (ENDTCPSVR *FTP and then STRTCPSVR *FTP).

Screenshot of CHGFTPA option

2. Go to the Digital Certificate Manager application to assign a certificate to the FTP server application ID. You will need to make sure the HTTP Admin server is active and that it can be accessed. In the QHTTPSVR subsystem, there should be an ADMIN job. If Admin is not active, use the command STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN) to start it. The Admin page can be accessed by going to http://<systemname or IP address>:2001/QIBM/ICSS/Cert/Admin/qycucm1.ndm/main0


Screenshot of DCM main page

3. Click on the Select a Certificate Store button and choose the *SYSTEM store. Enter your store password when it prompts you (this was created by the individual who created the *SYSTEM store).

4. Once you are signed in, choose the Fast Path option, then select Work with server and client certificates. You will see the certificates you have to choose from on the right-hand side. Select the one you want to assign to the FTP server and click Assign to Applications.

Screenshot of choosing a server certificate

5. Check the box for i5/OS TCP/IP FTP Server and click Continue.

Screenshot of selecting the FTP server from the list of applications.

6. Click OK on the Application Status screen.
7. Restart the FTP server application ENDTCPSVR *FTP and then STRTCPSVR *FTP. Check NETSTAT option 3 to verify the FTP secure port is listening. You can use F13 to sort by local port and then F14 to display the local port to make it easier to find port 990 (the secure FTP listener).

Screenshot of the secure FTP port in a Listen status.

Anyone who wants to connect to the FTP server securely will likely need the CA (Certificate Authority) of the certificate that was used to secure the FTP server. You can export this CA and send it to whomever requires it.

8. In DCM again, click on the Work with CA certificates option in Fast Path.
9. Select the CA certificate you wish to export. If it was a locally signed certificate, you will see LOCAL_CERTIFICATE_AUTHORITY. Select the appropriate radio button and click the Export button below.

Screenshot of selecting the CA certificate from the list.

10. Make sure the File radio button is selected and click Continue.
11. Fill in the Export to File name: field. This file will go to the IFS, and you must include the path and name of the file you are creating. For example, to export to your personal home directory in the IFS, you would specify /home/myprofilename/cert.cer where myprofilename is your directory and cert.cer is whatever you want to call the certificate file. The extension can be .txt, .cer, .crt, or just about whatever you choose. Note: Windows OS recognizes the .cer extension as a certificate and is probably a good choice to use.

Screenshot of the path and file name

12. Send the file to whomever requires it. You may need to move the file to your PC if you do not have software to send it directly from the i5.

The client will then import the CA to whatever application they use for client side FTP. They can then attempt to connect to the FTP server securely.

Historical Number

522844747

Document information

More support for: IBM i
Communications-TCP

Software version: Version Independent

Operating system(s): IBM i

Reference #: N1012980

Modified date: 31 July 2013