Preferences

For the initial configuration, we recommend to set at least the following preferences. For a comprehensive list of all preferences, see “Managing Preferences” in the admin help.

System-wide Preferences

HTTPS for Links

SSL Server Mode Required: If True, the website will use https (rather than http) when building links. Before you enable this option, make sure the IIS web server is configured properly for SSL/TLS (see Enable HTTPS for Secure Communication).

SSO Authentication

XFRACAS uses Windows authentication by default. Alternatively, if your web server is set up to support SSO authentication, XFRACAS will check for the Auth_User variable by default. If your SSO method has been configured to use a different variable, set the following preferences:

  • Single Sign-On (SSO) Authentication Enabled: If True, your web server is set up for SSO authentication and uses a variable other than Auth_User.
  • Single Sign-On (SSO) Server Variable: This is the alternative variable that XFRACAS needs to check for SSO authentication.

The admin/TESTSSO.aspx page on the website provides additional details to help with troubleshooting this configuration.

Location of the XFRACAS Website

XFRACAS Server - Filesystem Prefix: The absolute path on the web server where the website’s IIS folder is installed (e.g., C:\inetpub\wwwroot\XFRACAS\).

XFRACAS Server - IIS Prefix: The path that can be used to build links to pages within the XFRACAS website (e.g., servername/XFRACAS or 10.0.0.2/xfracas).

Link to SEP (if Applicable)

Display SEP Command: If True, the XFRACAS ribbon will include a link to your organization’s SEP web portal.

SEP Server - IIS Prefix: The path that can be used to build the link to the SEP web portal (e.g., servername/SEP).

Upload Files for Attachments

Attachments - Allow Uploaded Files: If True, the Attachments window will include the option for users to upload files. The files may be stored in the database or uploaded to a designated folder on the web server, depending on how you configure the related preferences.

Attachments - Store Uploaded Files in Database: If True, files will be stored in the database. If False, files will be stored in a designated folder on the web server.

Attachments - Uploaded Files Filesystem Prefix: If applicable, this is the absolute path to the folder on the web server where uploaded attachments will be stored (e.g., C:\inetpub\wwwroot\XFRACAS\uploads\ or D:\storage\xfracas). For requirements and instructions to prepare this folder, see Prepare to Store and Use Files.

Attachments - Uploaded Files IIS Prefix: If applicable, this is the path that will be used to build links to download files that were saved on the web server.

  • If you are using an actual folder within the website, enter a relative path (e.g., XFRACAS/uploads).
  • If you are using a virtual directory created in IIS, enter an absolute path (e.g., http://servername/uploads).

SMTP Server for E-mail Notifications

  • SMTP Server: The address of the mail server that will be used for sending e-mails.
  • SMTP Port: The port used to connect to the SMTP server.
  • SMTP Connection Timeout: The amount of time, in seconds, before the connection to the SMTP server times out when sending e-mails.
  • SMTP Enable TLS Support: If True, XFRACAS will support the use of Transport Layer Security (TLS) to encrypt traffic to SMTP.
  • SMTP User ID: The account, including domain, for SMTP. Used in conjunction with the SMTP Password preference (which is shown as ******** when populated). Used (but not required) when TLS support is enabled.

The admin/testtls.aspx page on the website allows you to test your e-mail configuration.

String Preferences

Verify that the date formats (XFRACAS - Date Format - Long and XFRACAS - Date Format - Short) match the culture setting within IIS so dates shown in charts can be displayed correctly.

Related Topics and Links

In This Topic