Building Your Event-Driven Architecture : Integration Server Administrator’s Guide : Configuring Integration Server to Connect to an SFTP Server : Creating an SFTP User Alias
Creating an SFTP User Alias
 
Editing an SFTP User Alias
Testing the Connection to the SFTP Server
An SFTP user alias is a named set of parameters that contains SFTP user account details and client configurations that Integration Server uses to function as an SFTP client.
In many organizations, a system administrator provides the SFTP user account information that you require to create an SFTP user alias.
You can have multiple SFTP user aliases for the same SFTP user account. Each SFTP user alias name in an Integration Server must be unique.
Keep the following points in mind when configuring Integration Server to act as an SFTP client:
*Integration Server supports password authentication and public key authentication for authenticating itself as the client to the SFTP server.
*For both password and public key authentication, you must have an account on the SFTP server that is set up for SFTP access.
*For public key authentication, the SFTP server and Integration Server must have access to their own private key and each other's public key.
Important:  
You must create at least one SFTP server alias before creating an SFTP user alias.
To create an SFTP user alias
1. Open Integration Server Administrator.
2. In the Navigation panel, select Settings > SFTP.
3. Click User Alias Settings.
4. Click Create User Alias.
5. Under SFTP User Alias Properties, provide the following information:
For this parameter...
Specify...
Alias
A name for the alias.
An SFTP user alias name:
*Can contain only underscores (_) and periods (.) as the special characters.
*Cannot begin with the string "http://".
*Can be of a maximum length of 255 characters.
User Name
The user name for the SFTP user account.
Authentication Type
The type of authentication that Integration Server uses to authenticate itself to the SFTP server. Client authentication can be either by password or by public and private keys.
Select...
To...
Password
Use password authentication.
Public Key
Authenticate Integration Server by using public and private keys.
To use this authentication type, the SFTP server and Integration Server must each have access to their own private key and each other's public key. If you select public key authentication, Integration Server saves the private key file in the Integration Server_directory /instances/instance_name/config/sftp/identities folder.
Password
If you are using password authentication, enter the password for the specified user to connect to the SFTP server.
Re-type Password
Re-enter the above password.
Private Key Location
If you selected Public Key as the authentication type, enter the location of the private key of the specified SFTP user.
PassPhrase
If you selected Public Key as the authentication type and if the private key you specified requires a passphrase, enter the passphrase for the private key file of the specified user.
Re-type PassPhrase
Re-enter the above passphrase.
SFTP Server Alias
The alias of the SFTP server to which you want the specified user to connect.
Preferred Key Exchange Algorithm
The algorithms that Integration Server presents to the SFTP server for key exchange.
You can specify the order in which Integration Server presents the algorithms to the SFTP server by moving the available algorithms up or down by clicking Up or Down. The SFTP server has its own set of preferred algorithms configured. At the time of key exchange, one of the algorithms supported by both Integration Server and the SFTP server will be chosen.
Maximum Retries
The number of times Integration Server attempts to connect to the SFTP server. The maximum allowed value is 6. The minimum allowed value is 1. The default is 6 retries.
Connection Timeout (seconds)
The amount of time (measured in seconds) Integration Server waits for a response from the SFTP server before timing out and terminating the request. The default is 0, which indicates that the session will never time out.
Session Timeout (minutes)
The number of minutes you want Integration Server to wait before terminating an idle session. The default is 10 minutes.
Compression
Whether or not to compress the data to reduce the amount of data that is transmitted. Integration Server supports compression using the compression algorithm zlib.
Note:  
You can use compression only if the SFTP server that you are connecting to supports compression.
Select...
To...
zlib
Compress the data that is transmitted between the SFTP server and Integration Server.
None
Not compress the data.
Compression Level
The compression level to use if you selected the compression algorithm zlib in the Compression field. The minimum allowed value is 1 (fast, less compression). The maximum allowed value is 6 (slow, most compression). The default is 6.
Proxy Alias
The proxy alias through which the request is to be routed. The proxy alias can be HTTP, HTTPS, or SOCKS. If a proxy alias is not specified, Integration Server makes outbound requests using each enabled proxy server alias until the request is sent successfully or all proxy servers have been tried. For more information about proxy aliases, see Creating a Proxy Server Alias.
6. Click Save Changes.
Integration Server saves the user alias configuration in the Integration Server_directory /instances/instance_name/config/sftp/sftpUserAliases.cnf file.
Copyright © 2016 - 2016 Software AG, Darmstadt, Germany.
Product LogoContact Support   |   Community   |   Feedback