AllardSoft Documentation filetransfer

Adding Diskspace

Sat, 28 May 2011 06:58:43 +0000

These instructions require Filetransfer appliance v1.6 or later. Sooner or later, you will most likely run out of disk space and you will want to extend the disk, either by adding a physical disk or by adding more disk space to a VMware installation. Both are fairly easy to deal with.

LDAP Authentication (Advanced)

Mon, 14 Mar 2011 20:21:40 +0000

LDAP Authentication (Advanced) The Advanced LDAP authentication mechanism offers the maximum amount of flexibility when authenticating against an LDAP directory. When authenticating against Active Directory, try the standard LDAP Authentication first. It is designed specifically for default configured Active Directories when the base DN matches the email address domain (i.e. dc=example,dc=com).

API v2

Sat, 09 Jul 2011 09:23:04 +0000

This covers API version 2, which was implemented in Filetransfer appliance version 1.6 Please see api_v1 for API version 1, for Filetransfer appliance version 1.5 and earlier. The major change between API v1 and v2 is that authentication in v1 sent the API key in the XML queries and in v2 the API key is sent as http auth. The API key in v2 is persistent so it's possible to save the API key in clients to keep the user logged in. Finally, the API has been extended to allow downloads of files as …

API

Tue, 24 May 2011 23:05:46 +0000

This documentation refers to the API v1 for Filetransfer v1.5 and below. Please see api for the API v2 for Filetransfer v1.6. The Filetransfer appliance has an XML API to facilitate automated filetransfers. There's currently three API requests that can be made

API v2

Sat, 16 Apr 2011 20:55:21 +0000

This covers API version 2, which was implemented in Filetransfer appliance version 1.6 Please see api for API version 1, for Filetransfer appliance version 1.5 and earlier. The major change between API v1 and v2 is that authentication in v1 sent the API key in the XML queries and in v2 the API key is sent as http auth. The API key in v2 is persistent so it's possible to save the API key in clients to keep the user logged in. Finally, the API has been extended to allow downloads of files as wel…

Listing Messages and downloading files

Sat, 16 Apr 2011 05:35:37 +0000

Listing Messages and downloading files To list available message, send a http GET like below An example using curl: curl -s -X GET --user Y1dftMxdZ0THButt5ZONIY:x -H 'Content-Type: text/xml' https://test.host/message 401 user@example.com recipient@customer.com 2011-03-18 1…

Browser Support

Wed, 25 May 2011 00:18:32 +0000

The Filetransfer appliance pushes some boundaries of what's possible with browsers. Please see the matrix below for different browser versions and their limitations: Browser Supported Max Download Max Send Internet Explorer 9 Yes 32 Gb 4 Gb Internet Explorer 8 Yes 32 Gb 2 Gb Internet Explorer 7 Yes 32 Gb 2 Gb Internet Explorer 6 and earlier No (1.2.x was the last supported release) 4 Gb 2 Gb Firefox Yes 32 Gb 2 Gb Safari Yes 32 Gb …

Installing Certificates

Fri, 19 Feb 2010 20:14:55 +0000

Background All appliances automatically generates self-signed certificates which works for testing and evaluating. For production systems, you'd want to generate a “proper”, CA-signed certificate for your appliance. When creating CA-signed certificates, there are a couple of steps

Custom File Scanning

Sun, 15 Feb 2009 19:46:39 +0000

Beginning with release v1.1.2, it's possible to build custom file scanning when a file is uploaded. This could be used to enhance the Filetransfer appliance with your own Antivirus scanning engine, block word documents based on certain keywords, or build a more granular filetype check that will scan archives and use content-type. To name a few examples. Please post your scripts to the forum.

Download Authentication

Mon, 27 Jun 2011 21:43:48 +0000

The aim of the Filetransfer appliance download authentication is as follows: * Don't break how email normally work * Enable both authenticated and unauthenticated downloads * Enable authentication with local database and LDAP * Allow authentication without creating accounts

The history of Download Authentication

Mon, 27 Jun 2011 23:11:29 +0000

The Filetransfer appliance is constantly evolving, and one place where this is more obvious than ever is the authentication and authorization for downloads. Basically the system by which we identify a user before they download the file. v1.0 - v1.1 The first iteration of the download authentication scheme used random individual URLs. If two receipients was entered, two emails would be sent out with individual links in each email. That way we knew instantly who downloaded the file. The downloa…

Email Configuration

Sun, 26 Oct 2008 01:28:31 +0000

The following section can be found in the Configuration page when logged in as a system administrator. Value Example Description Email Sender Address emailaddress support@example.com This email will be used when sending system generated emails like pickup receipts. It's a good idea if this a reachable address if the user should require support, and to pickup misconfigured users. Email Base URL http/https hostname https transfer.example.com This should be set to the …

Getting Started

Sun, 23 Jan 2011 18:25:41 +0000

To get started with the File Transfer Appliance, please follow these steps. Planning For the File Transfer Appliance to work, it needs to be reachable from the Internet. The following diagram outlines an example deployment [Network Diagram] During setup, you will need to provide the following details (examples in italic)

AllardSoft File Transfer Appliance

Thu, 26 Feb 2009 09:11:25 +0000

This is the documentation for the AllardSoft File Transfer Appliance. Please see the sections to the left for the topics.

Increase Disk Size in VMware

Sat, 28 May 2011 07:06:32 +0000

With VMware, it's possible to increase the disk size, but unfortunately the VMware increase utility does not know about how to increase the actual BSD partition. There has been some problems with this method and instead of trying to expand the disk, it is recommended to add a separate disk instead of expanding the existing disk. Please follow this guide on how to adding disk space.

Increase Disk Size in VMware

Sat, 28 May 2011 06:59:32 +0000

With VMware, it's possible to increase the disk size, but unfortunately the VMware increase utility does not know about how to increase the actual BSD partition. This tutorial explains how to expand the file system to take care of the increased space. The screenshots in the tutorial are from VMware Fusion so it may look different if you're running a different version, but the functionality is there in all versions of VMware.

Installation Without CD/DVD

Wed, 13 Apr 2011 10:32:44 +0000

This is possible, although it's fairly complicated so it should only be used as a last option. Moving the disk or moving a cdrom Unfortunately, the OpenBSD boot loader does not support booting from a usb cdrom so if you still want to use a cdrom to install the Appliance your options are basically

Installing using the ISO

Wed, 13 Apr 2011 10:32:43 +0000

The installation routine follows the basic structure of the underlying OpenBSD setup. Please refer to the Install OpenBSD Install FAQ for advanced installation options. This guide follows a simple and good way to create a great appliance system. System Requirements The minimal requirements for setting up the Appliances are

LDAP Authentication

Sat, 28 May 2011 07:24:08 +0000

LDAP Authentication The LDAP authentication mechanism offers the ability to integrate the Filetransfer appliance into an existing authentication directory such as Microsoft Active Directory. Terminology Keyword Description Server Name The hostname or the IP address of the LDAP server Server Port Optional port to use when connecting to the LDAP host. The default port if no port is specified is 389 for non-ssl connections and 636 for SSL connections.(*) Use SSL …

Controlling where files can be sent

Thu, 23 Oct 2008 11:48:57 +0000

One of the base requirements for any communication tool is to control how the communication is allowed to take place. The File Transfer Appliance aims to replicate the functionality of a mailserver in that respect and it introduced the concept of local and remote or non-local users. A local user can send files to anyone and a remote user can only send files to local users.

Move Server

Fri, 29 Jul 2011 08:17:33 +0000

From time to time, it may be needed to move to a new server. Either because the old hardware is to old, or something really bad happened to the old server. In this example, we're moving from oldserver to newserver. This information is valid for the Secure Filetransfer appliance version 1.2 or later. If you're running an older version, please update to a later version first.

Network & Firewall Configuration

Thu, 08 Apr 2010 22:41:26 +0000

This is an example network diagram for deploying the Filetransfer Appliance. [Network Diagram] To configure the firewall, you need the following rules in the firewall source destination port description http(s) any 10.0.2.10 80 & 443 http and https is allowed from anywhere DNS 10.0.2.10 DNS server 53 (UDP) The appliance needs DNS email 10.0.2.10 any / email server 25 The appliance ne…

Outlook Plugin

Wed, 04 Apr 2012 06:40:30 +0000

The Outlook Plugin is supported on Microsoft Outlook version 2000, 2003, 2007 and 2010 (Outlook 2010 64bit is supported in version 1.6 and latest versions of 1.2.x beta plugin). The plugin is considered beta and there's currently no built-in help available.

Release Notes

Mon, 13 Feb 2012 07:28:32 +0000

Release notes continued here: v1.6.30 (Released 2012-01-17) * Fixed a problem with 1.6.29 affecting Outlook logins. v1.6.29 (Released 2012-01-14) * Fixed a javascript path (sometimes caused the progress bar not to be shown). * Fixed a syslog message for dropbox with wrong sender name. * Fixed a problem that sometimes caused the Outlook plugin to not be able to login. * Add bcc list in the message log (so you can see who …

File Transfer Appliance

Sat, 09 Jul 2011 09:28:41 +0000

File Transfer Appliance General * Getting Started * Release Notes * Download Authentication * Browser Support * User types & Licensing Installation * System Requirements * VMware Setup * Installation using ISO * Installation without cd/dvd * Installing the Outlook Plugin * Network & Firewall Configuration * Email Configuration

SNMP Monitoring

Wed, 19 Oct 2011 09:49:23 +0000

The Filetransfer appliance doesn't support SNMP monitoring in the base install, and it's not possible to monitor any Filetransfer appliance specific details (like number of sent files). You can enable basic SNMP monitoring that covers basic system functions though.

System Requirements

Mon, 14 Feb 2011 18:45:19 +0000

System Requirements The minimal requirements for setting up the Filetransfer Appliance are * i386 type system (All variants of Pentium and compatible processors are fine, including VMware) * SCSI or IDE cdrom when installing on a physical system. The OpenBSD bootloader does not support USB cdroms unfortunately. * 4 Gb of hardrive space. This will not leave a lot of room for data, but is adequate for a simple test installation * 384 Mb of RAM

Translations

Thu, 20 Jan 2011 02:02:21 +0000

If you haven't yet upgraded to version 1.5, please see this section for translation on earlier releases. There's a built-in Locale Editor in the Filetransfer appliance. It's available in Admin -> Locale Editor. From there, you can add, edit and upload new language files. Most of the times, that's all you need to do.

Create custom translation

Wed, 13 Apr 2011 10:32:46 +0000

There are two reasons to update the translation of the Filetransfer appliance. * Change the interface to a new language * Override existing translations with your own. Base info You can you only change the translation files if you have a license and have enabled console access. The files are located in /var/sfta/config/locales.

User Types & Licensing

Wed, 13 Apr 2011 10:32:45 +0000

The Secure Filetransfer Appliance is licensed on number of users. Specifically, on the number of local users. In the Users tab, when logged in as an administrator, you will have the option of specifying user type. User Type License Permissions System Administrator Counted towards license Can administer everything in the system and send files to anyone Administrator Counted towards license Can manage users and send files to anyone Local User Counted towards license Can send files to…

VMware Setup

Wed, 13 Apr 2011 10:32:43 +0000

These screenshots outlines the setup used when creating the VMware installation for the Filetransfer appliance. Use it as a starting point if you're setting up a custom VMware installation using the ISO image. VMware Configuration The following screenshots outline the recommended VMware configuration.