File Extension and Size Filter

Use

The file extension and size filter is a content filter that restricts the upload of files to the KM repositories based on their extension and size. Use this filter to prevent the upload of resources with malicious content such as JavaScript in HTML files or macros. If the user tries to upload a file with a banned extension or a size higher than the maximum specified, the system displays an error message.

Note

The system performs the file extension and size check after the file upload. Therefore, in some cases the use of a file extension and size filter may slightly influence the performance of the system, for example, when uploading a large file with a disallowed extension.

The following table lists the parameters of the file extension and size filter that can be specified during the configuration:

Parameter	Mandatory	Description
Name	Yes	Name of the filter
All repositories	No	If selected, the parameter determines that the filter applies to all repositories. Available in advanced mode.
Priority	No	Specification of filter priority. If multiple filters are applicable to a resource, the priority determines the order in which they are applied. A value of 1 indicates the highest and a value of 99 indicates the lowest priority. The default value is 1.
Repositories	No	Selection of repositories whose content is to be filtered. Note If the All repositories parameter is selected, the Repositories parameter is not taken into account.
Deny upload of files without extension	No	If selected, the parameter determines that the upload of files with no extension is banned.
Maximum file size	No	Value in kilobytes of the maximum size of the resources that can be uploaded to the selected repositories. The value specified must be a number between 1 and 2097152 (2 GB). If you leave this input field empty, the resource size is not checked.
Forbidden characters in resource names	No	List of characters and symbols that you are not allowed to use in the IDs of the resources that are to be uploaded. The Repository Framework does not allow the use of slash (/), backslash (\), and question mark (?) characters in the IDs of the resources. Therefore, these special characters are forbidden by default. Depending on the implementation, each repository manager may add more forbidden characters. For more information, see Names and IDs of Objects in KM Folders . Note The list must contain no space or punctuation marks between the characters and symbols.
List of disallowed file extensions (CSV format)	No	Comma separated list of the banned file extensions.

Activities

To create a file extension and size filter, or to change the configuration of an existing one, choose Start of the navigation path Content Management Next navigation step Repository Filters Show Advanced Options File Extension and Size Filter End of the navigation path .

If you create a filter or modify an existing one, the changes take effect immediately. However, if you delete a filter, you must restart the Application Server Java (AS Java) for the changes to take effect.

Note

To create the filter successfully, you must have selected either the All repositories parameter, or at least one repository from the repository list in the Repositories parameter. Otherwise, the filter is not created.