All registry options (required and optional) for the FileCap Outlook Plugin are described in this chapter.
HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE
All registry values described in this chapter can be deployed in HKEY_CURRENT_USER and/or HKEY_LOCAL_MACHINE.
- The settings deployed in HKEY_LOCAL_MACHINE will be used by every user logged in to the system.
- The settings deployed in HKEY_CURRENT_USER will only be used by that specific user the HKEY_CURRENT_USER overwrites the HKEY_LOCAL_MACHINE values.
For example; The language for the FileCap Outlook plugin is set in HKEY_LOCAL_MACHINE to English, then everybody on that system is getting the English version of the Outlook plugin, but one employee wants to have the plugin in the Dutch language. Then you can set the language value in HKEY_CURRENT_USER for this specific user to Dutch. The result will be that one employee is having the Dutch Outlook Plugin and the other employees see the English Outlook Plugin.
Default registry locations
By default after installation the registry key’s will be written in HKEY_LOCAL_MACHINE\SOFTWARE\FileCap or HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\FileCap depending on the version (32/64bits) installed.
For HKEY_CURRENT_USER the default location for registry key’s will be:
HKEY_CURRENT_USER\Software\FileCap or HKEY_CURRENT_USER\Software\WOW6432Node\FileCap
Required registry values per installation
API Key settings
To communicate with the FileCap server the Outlook Plugin needs to have the API key settings, these are required. By default the installation of the will put the registry keys containing the API settings in HKEY_LOCAL_MACHINE.
Name | Type | Value |
APIKey | REG_SZ | XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
Server | REG_SZ | filecap.company.com |
If you want to use HKEY_CURRENT_USER instead, you can download the .reg file with the following link:
- Current user: https://update.filecap.net/downloads/FileCap-Plugin/examples/registry/FileCap_API_key_Current_User.reg
Note when downloading above .reg file: You still need to edit the downloaded .reg file in a text editor like notepad. And replace the following:
“Enter-FileCap-API-Key-Here” by the API key which can be found at “Plugin settings -> API Key” this is a unique key per FileCap server.
“Enter-FileCap-FQDN-Here” by the FQDN of the FileCap server (For example: filecap.company.com)
Optional registry values
The following registry values are optional settings for the FileCap Outlook Plugin.
Language setting
This is an optional registry setting which defines the language used for the FileCap Outlook Plugin. When this option is not set the System language will be used. If the system language is not supported the FileCap Outlook Plugin will fallback to English.
Currently the FileCap Outlook Plugin is available in the following languages:
Language | Type | Value |
Dutch | REG_SZ | nl |
English | REG_SZ | en |
Finnish | REG_SZ | fi |
French | REG_SZ | fr |
German | REG_SZ | de |
Italian | REG_SZ | it |
Norwegian | REG_SZ | no |
Spanish | REG_SZ | es |
Swedish | REG_SZ | sv |
The values above can be manually set in the registry, or set during installation.
Note: This option is available in FileCap Outlook Plugin version 4.1.0 and newer, please be aware that not all languages are supported if you use plugin version older then the latest.
Allow failed connection
When this registry setting is used it will allow the user to send files also when the FileCap server is unavailable. Please be aware that this can cause data leaks.
Name | Type | Value | Description |
AllowFailedConnection | REG_SZ | false | Sending emails is not possible when the FileCap server is unavailable.
Note: This is the default value which will be used when this registry setting is not set. |
AllowFailedConnection | REG_SZ | true | Sending emails is possible also when the FileCap server is unavailable. |
Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.
Use FileCap for attachments
When this registry setting is used the checkbox “Send with FileCap” is checked by default, but the user can still manually disable it.
Name | Type | Value | Description |
SetDefaultUseFileCapForAttachments | REG_SZ | false | The checkbox is not checked.
Note: This is the default value which will be used when this registry setting is not set. |
SetDefaultUseFileCapForAttachments | REG_SZ | true | The checkbox will be checked. |
Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.
Force use FileCap for attachments
When this registry setting is used the checkbox “Send with FileCap” is checked by default, and cannot be disabled by the user.
Name | Type | Value | Description |
ForceUseFileCapForAttachments | REG_SZ | false | The checkbox is not checked.
Note: This is the default value which will be used when this registry setting is not set. |
ForceUseFileCapForAttachments | REG_SZ | true | The checkbox will be checked and cannot be disabled. |
Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.
Force use FileCap for messages and attachments
When this registry setting is used the email encryption is used by default.
Name | Type | Value | Description |
ForceUseFileCapForMessageAndAttachments | REG_SZ | false | The mail encryption is not forced.
Note: This is the default value which will be used when this registry setting is not set. |
ForceUseFileCapForMessageAndAttachments | REG_SZ | true | The mail encryption will be used. |
Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.
Startup Connection retry
When this registry setting is used the FileCap Outlook Plugin will retry a number of times when there is no connection possible to the FileCap server.
Name | Type | Value | Description |
StartupConnectionRetryCount | REG_SZ | 3 | When there is no connection to the FileCap server the plugin will try again this number of times, before giving an error.
There will be an interval of 2 seconds before the next retry. |
Note: This option is available in FileCap Outlook Plugin version 4.2.0 and newer.
Restore Original Mail
When this registry setting is used the FileCap Outlook Plugin will restore the original email text and attachments to the Outlook “Sent Items” folder.
Name | Type | Value | Description |
RestoreOriginalMail | REG_SZ | false | The email text and attachments will not be restored.
Note: This is the default value which will be used when this registry setting is not set. |
RestoreOriginalMail | REG_SZ | true | The email text and attachments will be restored in the Outlook “Sent Items” folder. |
Note: This option is available in FileCap Outlook Plugin version 4.2.2 and newer.
DLP functionality
When this registry setting is used the FileCap Outlook Plugin will detect IBAN numbers, Dutch mobile numbers and BSN numbers in the email text.
Name | Type | Value | Description |
DlpContentEnabled | REG_SZ | false | When this registry setting is used the FileCap Outlook Plugin will not scan email text.
Note: This is the default value which will be used when this registry setting is not set. |
DlpContentEnabled | REG_SZ | true | When this registry setting is used the FileCap Outlook Plugin will detect IBAN numbers, Dutch mobile numbers and BSN numbers in the email text. The detections can be extend by adding new values as described under “Extend DLP Functionality”. |
Note: This option is available in FileCap Outlook Plugin version 5.0.0 and newer.
Extend DLP functionality
The above DLP functionality can be extended by adding more regex values to the following registry key: “HKEY_CURRENT_USER\Software\FileCap\DLP”
Note: This regex values can only be added to the HKEY_CURRENT_USER directory.
Name | Type | Value | Description |
regex10 | REG_SZ | The detection regex | |
regex11 | REG_SZ | The detection regex |
Force Safe Send
When the DLP function detects something and this function is set the user will get a message with the question if they want to send this message with a password or SMS token.
Name | Type | Value | Description |
ForceSafeSend | REG_SZ | false | When something is detected by the DLP function the user will not be prompted to send encrypted.
Note: This is the default value which will be used when this registry setting is not set. |
ForceSafeSend | REG_SZ | true | When something is detected by the DLP function the user will be prompted with a question if it is needed to send this message with a password or SMS token. |
Note: This option is available in FileCap Outlook Plugin version 5.0.0 and newer.
The above settings can also be downloaded as a registry file, which can be found here:
FileCap_Outlook_Per_User_Settings.reg
Debug logging
This registry setting is used to set the log level of the Windows Event logging for the Outlook Plugin
Name | Type | Value | Description |
DebugMode | REG_SZ | 0 | Error loglevel
Note: This is the default value which will be used when this registry setting is not set or when there is set an unsupported number. |
DebugMode | REG_SZ | 1 | Informational loglevel |
DebugMode | REG_SZ | 2 | Debug loglevel |