Secure Ad Hoc Transfer's Configuration File

Secure Ad Hoc Transfer uses a configuration file, web.config, located by default in C:\Inetpub\EFTAdHoc. The installer captures and records all necessary values; however, you can manually change those settings in the IIS Manager. Alternately, you can manually edit web.config (e.g., in a text editor or Visual Studio), but you have to be very careful with your edits so as not to introduce errors in the formatting of the file. You should create a backup copy of the file before editing.

To open the EFTAdHoc Properties

  1. Open the Internet Information Services manager. (Click Start, Programs > Administrative Tools > Internet Information Services (IIS) Manager.)

  2. Expand the Web Sites node, then expand the Default Web Site node.

  3. Right-click EFTAdHoc, then click Properties.

  4. In the Properties dialog box, click the ASP.NET tab. (If the Properties dialog box does not have an ASP.NET tab, refer to AdHoc Properties Missing ASP.NET Tab.)

  5. Click Edit Configuration. The ASP.NET Configuration Settings dialog box appears.

  6. Click the General tab. The settings in the web.config file for the SAT Module appear in the Application settings area.

  7. To change a value, click it, then click Edit. In the Edit/Add Application Settings dialog box, type the new value, then click OK. Do not remove any of the keys.

  8. After you have viewed/edited the configuration, click OK to close the dialog boxes, then, in the IIS Manager, click File > Close. It is not necessary to restart the service or reboot.

Any changes you make to the file must be replicated on any computer running EFT Server.

EFT Server Configuration

Variable

Description

Default/Range

EFTServerIPAddress

EFT Server Admin GUI IP address

IP Address

EFTServerPort

EFT Server Admin GUI port

1100

EFTAdminUsername

EFT Server Admin GUI username

n/a

EFTAdminPassword

EFT Server Admin GUI password (use encode.htm to obfuscate)

n/a

EFTSite

EFT Server Site name under which SAT module settings level will be created

GSEFTServer Auth

SettingsLevel

EFT Server Settings Level under which SAT module users will be created

Ad-Hoc

Global Configuration Variables

Variable

Description

Default / Range

URLPattern

URL pattern that should be used in the outgoing e-mails

 https://server1.com:443/

ExpiryDays

Number of days before SAT module user accounts expire.

7

TempUserNameLength

SAT Module username length

8

LogPath

Path where the verbose debugging log file will be created (if enabled)

File path must be explicitly defined and the IUSR_<computername> must have write permission to this path

 

If authentication is enabled for SAT then “Authenticated Users” must have write permission to this path.

sendmail.log

UseLogFiles

True (1)  =  the application will log errors, configuration errors, and event information

False (0)  = the application will not log any debug information

0

LogLevel

Log level for debugging.   Where 0 is the least log output and 5 is the greatest amount of log output.

0. debug

1. error

2. info

3. verbose

4. internal

0-5

TempFolder

Temporary folder for file uploads on IIS server

c:\inetpub\EFTAdhoc\temp\upload\

Mail Content Configuration

Variable

Description

Default / Range

EmailTemplateFormat

E-mail template format, Plain Text or HTML,  to be used when the system sends an e-mail. The templates used depend on this variable setting. (e.g., UsernamePasswordTemplate.tlt or UsernamePasswordTemplateTextPlain.tlt)

0 =HTML

1 = Plain Text

EmailBehavior

SAT default e-mail behavior allowing username and password to be send in separate e-mails or single-click authentication. Single-Click authentication allows the user to automatically log into the Web Transfer Client using an authentication link.

0 or 1 = Username and Password in one e-mail to recipient

2 = Username and Password in separate e-mails to recipient

3 = Username and Password in separate e-mails to sender

4 = Username to recipient and Password to sender

5 = Single-Click Authentication

UsernamePasswordTemplate

E-mail template containing the username and password as one e-mail message. Used when EmailBehavior is set to 1.

UsernamePasswordMessage.tlt

SingleClickAuthMessageTemplate

E-mail template containing the username and password as one e-mail message. Used when EmailBehavior is set to 5.

SingleClickAuthenticationMessage.tlt

UsernameMessageTemplate

E-mail template containing the username and password as one e-mail message. Used when EmailBehavior is set to 2-4.

UsernameMessage.tlt

PasswordMessageTemplate

E-mail template containing the username and password as one e-mail message. Used when EmailBehavior is set to 2-4.

PasswordMessage.tlt

UploadNotificationTemplate

E-mail template used for upload notification e-mails from SendUploadNotification.wsf script.

SendUploadNotificationMessage.tlt

UsernamePasswordTemplateTextPlain

Plain Text E-mail template containing the username and password as one e-mail message. Used when EmailBehavior is set to 1

UsernamePasswordMessageTextPlain.tlt

SingleClickAuthMessageTemplateTextPlain

Plain Text E-mail template containing the username and password as one e-mail message. Used when EmailBehavior is set to 5.

SingleClickAuthenticationMessageTextPlain.tlt

UsernameMessageTemplateTextPlain

Plain Text E-mail template containing the username and password as one e-mail message. Used when EmailBehavior is set to 2-4.

UsernameMessageTextPlain.tlt

PasswordMessageTemplateTextPlain

Plain Text E-mail template containing the username and password as one e-mail message. Used when EmailBehavior is set to 2-4.

PasswordMessageTextPlain.tlt

UploadNotificationTemplateTextPlain

Plain Text E-mail template used for upload notification e-mails from SendUploadNotification.wsf script.

SendUploadNotificationMessageTextPlain.tlt

ImageLogo

Image logo used in the e-mail templates (not used in the Plain Text templates)

e-mail_logo.gif

RemoveImageLogoAttachment

Removes the logo image attachment from all e-mail messages if set to True.

False

SMTP Configuration

Variable

Description

Default / Range

SMTPServer

SMTP server hostname or IP address through which notifications will be sent

n/a

SMTPDomain

SMTP server hostname or IP address for sending notification mails, used only with cdoNTLM SMTP Authentication.

Blank if SMTPAuthenticate is 0.

SMTPServerPort

Port used by SAT module for SMTP communication

25

SMTPAuthenticate

SMTP server authentication mode.

cdoAnonymous=0

cdoBasic=1

cdoNTLM=2

0

SendUserName

SMTP username for authentication (when required)

n/a

SendPassword

SMTP password used for authentication (when required)

n/a

Smart E-Mail Options

Variable

Description

Default / Range

UseSmartEmailTextBoxes

When set to true, enables smart e-mail text boxes. SAT will identify users based on first and last name for all Sites if the full name and e-mail fields are populated.

True

CacheDurationnEFTUsersMins

The duration in minutes before caching users used for Smart E-mail text boxes.

60

E-Mail Filtering Options

Variable

Description

Default / Range

EnableEmailFiltering

When set to true enables white/blacklist filtering options to destination domains for To/Cc/Bcc e-mail addresses.

False

WhiteListDestinationDomain

Specifies the allowed destination domain when BlackListDestinationDomain is set to *.

Use comma to separate list of domains

WhiteListDestinationDomain value="globalscape.com" BlackListDestinationDomain value="*"

(Only allow e-mails to globalscape.com domain.)

BlackListDestinationDomain

Specifies the restricted destination domains when WhiteListDestinationDomain is set to *.

Use comma to separate list of domain.

 WhiteListDestinationDomain value="*"

 BlackListDestinationDomain value="globalscape.com,domainname.com"

(Allow all e-mails except to globalscape.com or domainname.com domains.)

SAT Module EFT Server Communication Configuration

Variable

Description

Default / Range

UploadProtocol

Internal protocol used for transferring from SAT module storage to EFT Server

-1 = Local File Copy

0 = FTP

1 = FTP Implicit SSL

2 = FTP Explicit SSL

3 = SFTP2

4 = HTTP

5 = HTTPS

6 = SOCKS4

7 = SOCKS5

8 = FTP AUTH TLS

5 (HTTPS)

(See Using the PCI Module with the Secure Ad Hoc Transfer Module for details of this setting with HS-PCI-enabled Sites.)

If you expect to upload large files, e.g., 1 GB or larger, we strongly recommend that you install EFT Server on the same computer as IIS and, in the web.config file, set UploadProtocol to Local File Copy (-1).

UploadPort

Port used when Upload Protocol is 0 through 8

443

Script Configuration

Variable

Description

Default / Range

WaitForUploadsDurationSec

Used for the Send Upload Notification script.  

Duration in seconds to wait for uploaded files prior to sending e-mail notification

The frequency of the timer event rule that is monitoring home folders affects the delay between uploaded files and the notification message.

30