Configuring FileAgo

3. Admin Guide

FileAgo v1.0 Created on: July 20, 2019


Administrator can configure FileAgo by accessing Admin Panel -> Settings.

General


Hostname

Enter the hostname (FQDN) of your installation. Among other things, this value is used to make URLs that are sent via emails. If hostname is not available, you can use IP address instead.

Email Server

This section is used to configure the SMTP server which will be used by FileAgo to send email notifications to users.

SMTP Server

Enter the hostname (FQDN) or IP address of the SMTP server to use.

SMTP Username

Enter the username to authenticate with the SMTP server.

SMTP Port

Enter the port at which SMTP server is listening. Usually, it is 25 or 587 but can vary.

Send email notifications as (FROM:)

Email notifications will have this email address as its source (FROM: address).

Outgoing webhook

This setting is only required if you have an external service which needs to receive information when events happen in FileAgo. If not (like in most situations), simply leave the ‘Endpoint URL’ field blank.

Endpoint URL

FileAgo will POST all events related to files and folders as json data to the URL that you enter here. It is highly recommended to use https protocol (with a valid certificate), and to refer the endpoint by its hostname.

Document revisions

Keep old revisions of documents?

Using this option, an administrator can configure how many days should old versions of files be available, after which the original data file will be safely removed. It is possible to preserve all revisions (i.e., FileAgo will never remove any old revisions) by selecting the option ‘Keep forever’ from the dropdown.

Admin settings

Admin Email

Email address of the administrator

Admin Password

Password of the admin user account.

Database


The database settings are configured at the time of install. There is usually no need to change its values afterwards. Modifying the values here without understanding its purpose can easily break FileAgo server.
Database Host

Enter the hostname (FQDN) / IP address of your database server.

Database Host Port

Enter the port on which your database server is listening to (usually 7474).

Database Username

Enter the username of the database server.

Database Password

Enter the password of the database user.

Security


Encrypt files (AES-256)

Encrypts all files uploaded to FileAgo using AES-256 encryption. It is highly recommended to keep this option always enabled.

CORS ‘Access-Control-Allow-Origin’ header

Enter * or hostname if you have 3rd party applications or mobile applications that will connect to FileAgo using API. Else, leave the field empty.

Only group permissions matter when group members try to access files owned by a group

This option is enabled by default. Disabling this will result in stricter permission checks for a user when trying to access resources owned by a group. The option has been discussed in detail in the Waterfall Permission Model section.

Temporary ban for failed login attempts

Enable temporary IP ban for preventing someone from guessing passwords. Additional settings can be configured below.

Temporary ban settings

Max failed logins

Enter the number of failed logins that will trigger a ban (default: 5).

Interval (in minutes)

Enter the interval of time (in minutes) during which maximum failed logins should occur from an IP to trigger a ban (default: 1).

Ban duration (in minutes)

Enter the period for which a temporary ban must last (max: 120 minutes, default: 15).

The default values here says that if temporary ban is enabled, then an IP address will be banned from accessing the API endpoints for the next 15 minutes if 5 failed login attempts happen from that IP address within a period of 1 minute. The ban will be revoked automatically after the interval is over.

Notifications


This section describes the global email and realtime notification settings.

The configuration that is set here will apply for all users by default, although individual users can override these settings if they want via their User Settings page.

Email notification settings

Enable email notifications

This option needs to enabled (along with a working SMTP server configuration) in order for FileAgo to send outgoing email notifications.

Configure the following options for whichever events should email notifications be sent to the users.

For example, the first row can be interpreted as:

Alert a user by email if some oneone uploads a file which satisfies any of the below conditions:

  • The file is uploaded in a folder owned by the user
  • The file is uploaded in a folder owned by one of the groups in which this user is a member
  • The file is uploaded in a folder which is a folder that was shared with this user

Realtime notification settings

Enable realtime notifications

This option needs to enabled in order for FileAgo to display realtime notifications (a small popup that notifies the user of any event on the web UI).

Configure the following options for whichever events should realtime notifications be sent to the users.

For example, the first row can be interpreted as:

Notify a user using realtime notification if some oneone uploads a file which satisfies any of the below conditions:

  • The file is uploaded in a folder owned by the user
  • The file is uploaded in a folder owned by one of the groups in which this user is a member
  • The file is uploaded in a folder which is a folder that was shared with this user