Create a new FTP server data instance and configure the information that Pega Platform uses to find and log into an external FTP server.
- In the header of Dev Studio, click .
- On the Create FTP Server page, in the FTP Server short description field, enter a description of the FTP Server.
- In the Server Name field, specify a name for the FTP
server.This name does not need to match the network name. Begin the name with a letter, and use only alphanumeric characters, ampersands, and hyphens.
- Click Create and open.
Result: The FTP Server rule form opens on the Environment tab.
- In the Host name field, enter a Domain Name Server (DNS) name
for the FTP server.
ftp.myserver.comAlternatively, identify an IP address.
This field supports the Global Resource Settings syntax (= PageName.PropertyName). The default property name for this field is pyHostName. For more information, see Fields that support the Global Resource Settings syntax.
- Optional: In the Port number field, identify a TCP/IP port for this FTP
server. The system automatically selects standard ports at run time if they are not specified, such as port 21 for FTP and FTP Secure (FTPS), and port 22 for SSH FTP (SFTP). This field supports the Global Resource Settings syntax ( =PageName.PropertyName). The default property name for this field is pyPortNumber.
- In the Authentication section, select Use authentication to enable authentication.
- Optional: In the Authentication profile field, press the Down arrow key to
select the authentication profile that contains the user name and password for the account
that Pega Platform uses to connect to the FTP server.If this field is left blank, Pega Platform attempts to make an anonymous FTP connection.
- Optional: Click the Open icon to edit the selected authentication profile
or to create a new one.For more information, see Authentication profiles.
- In the Protocol section, select the protocol based on your FTP
Choices Actions FTP No additional steps required. SSH FTP (SFTP)
- In the Server key field, select the Keystore record
that contains the SSH public key of the FTP server to restrict the FTP servers
to which connections are made.The Keystore type value on the Keystore record should be KEY. When this field is blank, the Pega Platform can connect to any SFTP host regardless of its public certificate.
- In the Client key field, select the client private
key, which is uploaded to the Keystore record.The private key is used to identify the FTP client when connecting to the FTP server. The Keystore type value on the Keystore record must be KEY.
FTP Secure (FTPS)
- In the Lowest allowable SSL/TLS version field, select
the lowest allowable SSL/TLS version.
Note: Pega Platform displays a guardrail warning for versions that are considered vulnerable.
- Optional: In the Truststore field, press the Down arrow key to select the Truststore record that contains the server certificates for FTP server verification, or click the Open icon to open the selected Truststore or to create a new one.
- Optional: In the Keystore field, select the Keystore record that contains the client certificates for Pega client application verification by the FTP server, or click the Open icon to edit the selected Keystore or to create a new one.
- To encrypt data, select Encrypt data channel.This check box is enabled by default for encryption of FTP authentication and data channels. Authentication over FTP always uses encryption. If you are using mutual SSL or a secure network, you might want to deselect this option because performance can be impacted when using it.
- In the Server key field, select the Keystore record that contains the SSH public key of the FTP server to restrict the FTP servers to which connections are made.
- Click Save.