eBiss 3

Hilfe & Dokumentation

User Tools

Site Tools


en:kommunikation:kanal:sftpreceive



SFTP receive channel

The SFTP receive channel allows the connection of a directory via SFTP protocol. Messages from the directory stored in the channel are placed in the message basket (incoming).

Immediate retries

In case of error code

  • 1103 - Read remote file failed [4]: capacity < 0: (-257 < 0)
  • 32000 - Connection closed unexpectedly

and a “Retries on error” > 0, the error is written to the log and the download is retried after one second. A task is created if the error still occurs on the last attempt.

GENERATED src=“eBiss.Data.Resources.sFtpReceiveChannel” changed=““
Properties
NameDescription
NameThe name of the channel
Channel type nameThe Type of the channel
Message directionFor receive channels the direction of the received message (but require also for send channels)
Message boxThe message box
PublicTrue if the channel should be visible in the sub node
HostIP address of the email server e. g. 175.11.214.25.
PortPort (preferably 22).
UsernameLogin to SFTP server
PasswordThe password for logging in to the SFTP server
PathThe directory from which the files are to be read.
File maskThe file mask, which may contain the placeholders * and ?
Advanced file maskAfter the 'File mask' application and the file names read with it, the 'Extended File Mask' is applied. Regular expressions can be used here, see Regular Expressions.
Fetch sub directory levelsIf the value is greater than zero, then the files in the subdirectories are also read. The value specifies up to which level the subdirectories are read.
Identify partner by sub directoryThe relative path is used and with this a sftp address of a partner is searched and if found, then this partner is assigned to the message.
Action after receive fileSpecifies whether the files should be: Deleted, Moved, Move with time stamp
Move to pathThe fetched files are moved to the path
Rename fileAn optional parameter to rename the file name after retrieval. Is only evaluated if 'Action after receive file' is set to 'Move' or 'Move with timestamp'. You can use ${fn} and ${extension}. Renaming the file from e.g. 'info.csv' to 'info.sic' is achieved with the value: ${fn}.sic
Change logsThe changes to the element are logged. The logging is activated in the System settings, which is possible if a versioning license is available.
Properties (advanced)
NameDescription
Sender validationHow the sender address should be validated
Default senderThe default sender
Recipient validationHow the recipient address should be validated
Default recipientThe default recipient
Immediate retriesRetries, used by send channels. For some receive channels, the number of pickup attempts.
Auto uncompressCheck if receipt data are compressed and then uncompress them
Transfer modeSetting the transmission mode. Mode (Auto, Text, Binary) can be selected in the corresponding look main table.
Protocol versionThe default value -1 at this point means that the current default value for SFTP is used, which is currently version 3. We had a case where version 4 was necessary to achieve the desired replacement of CR to CRLF in connection with the text mode.
Sort order of read filesSequence in which the received data are read and processed.
Authentication certificateThe private certificate1) of the client, if the authentication with the server should be done via the certificate.
Auth. certificate passwordPassword of the certificate specified in “Certificate for Authentication”.
Auth. certificate subject
Certificate infoIf a certificate has been stored and recognized, the FingerPrint, the serial number and the expiration date are displayed here.
SSH encryption algorithmsEncryption algorithms supported by this component for the encryption of the ssh session. Values can be entered as a comma separated list, using the following values: 'aes256-ctr, aes256-cbc, aes192-ctr, aes192-cbc, aes128-ctr, aes128-cbc, 3des-ctr, 3des-cbc, cast128-cbc, blowfish-cbc, arcfour, arcfour128, arcfour256, aes256-gcm@openssh.com, aes128-gcm@openssh.com'. By default this component supports 'aes256-cbc' and '3des-cbc'.
SSH MAC algorithmsMAC algorithms supported by this component for the ssh session. Values can be entered as a comma separated list, using the following values: 'hmac-sha1, hmac-md5, hmac-sha1-96, hmac-md5-96, hmac-sha2-256, hmac-sha2-256-96, hmac-sha2-512, hmac-sha2-512-96, hmac-ripemd160, hmac-ripemd160-96'. By default this component supports 'sha1', 'sha1-96', 'md5' and 'md5-96'.
Additional SSH parametersThis value is passed directly to the SSH component and should never be set. A case we know of is 'The server key seems to be invalid when using the 'diffie-hellman-group-exchange' key exchange algorithms' solved with the value: SSHKeyExchangeAlgorithms=ecdh-sha2-nistp256,ecdh-sha2-nistp384,ecdh-sha2-nistp521
1)
PFX file (PKCS #12, .pfx, .p12) and Open SSH certificates (.ppk) are recognized. Putty certificates cannot be read, they should be exported as Open SSH certificate. If the certificate is not recognized please report to Pranke Support or read in using the following format: 'PEMKeyFile|<filename>', possible formats are: P7BFile, P7BBlob, SSHPublicKeyFile, PPKFile, PPKBlob, JKSFile, JKSBlob, PEMKeyFile, PEMKeyBlob, PublicKeyFile, PublicKeyBlob, SSHPublicKeyBlob
en/kommunikation/kanal/sftpreceive.txt · Last modified: 2024/04/25 11:11 (external edit)