FTP command authorization list definition file
Format
[ftp-command.allow=FTP-command-that-can-be-executed]
[ftp-command.site.allow=Commands-that-can-be-executed-with-SITE-command] |
Function
Specifies the FTP commands that can be executed before and after the transmission and before and after the execution of list commands.
The FTP command authorization list definition file includes two types of files, the file for FTP adapters and the file for FTP receptions.
You can create the FTP command authorization list definition files on any path with any names. However, the absolute paths of the FTP command authorization list definition files must be specified in the following properties respectively:
- FTP command authorization list definition file (for FTP adapters)
The ftpadp.cscthrough-filepath property of the FTP-adapter runtime-environment property file
- FTP command authorization list definition file (for FTP receptions)
The urecp-ftp.ftp-command-allow.filepath property of the FTP reception configuration file
The contents specified in the FTP command authorization list definition file become valid when the FTP reception or the FTP adapter starts.
File storage location
- For the FTP command authorization list definition file (for FTP adapters)
Service-platform-installation-directory\CSC\custom-adapter\FTP\config\templates\cscthrough.properties
- For the FTP command authorization list definition file (for FTP receptions)
Service-platform-installation-directory\CSC\config\ftprecp\templates\ftp_command_allow.properties
- Note
- The stored file becomes the template file. To create the definition file, copy the template file to any directory and then edit the file.
Specifiable properties
ftp-command.allow=FTP-command-that-can-be-executed ~ <Character strings or one-byte asterisks (*)>
Specifies the FTP commands that can be executed for the business processes before or after the transmission. The characters are not case sensitive.
If you omit this property, the execution of all the FTP commands, except the SITE command, will not be permitted.
- Note
- The settings for this property are applied only to the FTP reception or the FTP adapter in which the path of this definition file is specified in the FTP reception configuration file or FTP-adapter runtime-environment property file.
- The ftp-command.site.allow property specifies whether the commands set as arguments of the SITE command can be executed. Therefore, you need not specify the SITE command in this property.
- To specify multiple commands, specify command, command, ..., by using commas (,) as delimiters. The one-byte spaces and tab characters before and after the commas are ignored.
- If you specify one-byte asterisks (*) only, all the FTP commands, except the SITE command supported by the service platform, can be executed.
- The commands STOR, APPE, STOU, RETR, LIST, and NLST are not supported by the service platform. Therefore, even if you specify these commands, they cannot be executed. Similarly, even if you specify one-byte asterisks (*), the commands cannot be executed.
ftp-command.site.allow=Commands-that-can-be-executed-with-SITE-command ~ <Character strings or one-byte asterisks (*)>
Specifies the commands that are uniquely supported by the FTP server and that can be executed for the business processes before or after the transmission. The command specified as the first argument of the SITE command becomes the target of this property. The characters are not case sensitive.
If you omit this property, none of the SITE commands can be executed.
- Note
- The settings for this property are applied only to the FTP reception or the FTP adapter in which the path of this definition file is specified in the FTP reception configuration file or FTP-adapter runtime-environment property file.
- The SITE FSIZE command is processed with the FTP inbound adapter. Therefore, even if you specify FSIZE in the value of this property, the value is ignored.
- To specify multiple commands, specify command, command, ..., by using commas (,) as delimiters. The one-byte spaces and tab characters before and after the commas are ignored.
- If you specify one-byte asterisks (*) only, all the SITE commands, except FSIZE, can be executed.
Example of coding
An example of coding is as follows:
ftp-command.allow=STAT, RNFR, RNTO, DELE, RMD
ftp-command.site.allow=CHMOD, UMASK |
The details for the example of coding are as follows:
- Permitted FTP commands (except the SITE command): Commands STAT, RNFR, RNTO, DELE, and RMD
- Permitted SITE commands: Commands CHMOD and UMASK