Configure: CS4OutlookDefaultUserConfig

The CS4OutlookDefaultUserConfig.xml file contains both user-specific information and global information.

See Create: CS4OutlookDefaultUserConfig for instruction on how to create the file.

Working with XML Files

It is recommended to get familiar with the basic functionality of XML files before you start editing the CS4OutlookDefaultUserConfig.xml. Furthermore, it is recommended to use an advanced editor for editing the file, which has a suitable display and syntax check (e.g. notepad++, PSPad or others).

User-specific information (one node per email account)

Variable name	Function
ServerUrl	Cryptshare Server URL
LastAcceptedTermsOfUse	The time when the terms of use were agreed to.
FirstName	Sender’s first name.
LastName	Last name of the sender.
SenderPhone	Sender’s phone number
EMailAddress	E-mail address of the sender. For the initial configuration, the wildcard symbol '*' can be used here.
SendOnBehalfDelegationType	Specifies whether an email is sent as "Send as" or "Send on behalf" if a delegated mailbox is used. Values: None, SendAs, and SendOnBehalfOf
IsUserEnabledServerURL	A switch that defines whether the server URL can be edited by the user in the settings dialog.
IsUserEnabledFirstName	A switch that defines whether the first name can be edited by the user in the settings dialog.
IsUserEnabledLastName	A switch that defines whether the last name can be edited by the user in the settings dialog.
IsUserEnabledSenderPhone	A switch that defines whether the phone number can be edited by the user in the settings dialog.

Variable name

Function

ServerUrl

Cryptshare Server URL

LastAcceptedTermsOfUse

The time when the terms of use were agreed to.

FirstName

Sender’s first name.

LastName

Last name of the sender.

SenderPhone

Sender’s phone number

EMailAddress

E-mail address of the sender. For the initial configuration, the wildcard symbol '*' can be used here.

SendOnBehalfDelegationType

Specifies whether an email is sent as "Send as" or "Send on behalf" if a delegated mailbox is used.

Values: None, SendAs, and SendOnBehalfOf

IsUserEnabledServerURL

A switch that defines whether the server URL can be edited by the user in the settings dialog.

IsUserEnabledFirstName

A switch that defines whether the first name can be edited by the user in the settings dialog.

IsUserEnabledLastName

A switch that defines whether the last name can be edited by the user in the settings dialog.

IsUserEnabledSenderPhone

A switch that defines whether the phone number can be edited by the user in the settings dialog.

Recent transfer settings

Variable name	Function
SendPasswordViaSmsGateway	Indicates whether the option to send the password via SMS during the last transfer was enabled.
NotifyAboutDownload	Specifies whether the Notify when files are retrieved option was enabled or disabled during the last transfer.
ShowNameOfAttachments	Specifies whether the Show file names in notification emails option was enabled or disabled during the last transfer.
ShowZipContent	Specifies whether the Show Zip Content option was enabled or disabled during the last transfer.
EncryptMessage	Specifies whether the Encrypt Message option was enabled or disabled during the last transfer.
EncryptSubject	Specifies whether the Encrypt Subject option was enabled or disabled during the last transfer.
PasswordOption	Specifies which password option was last selected.

Variable name

Function

SendPasswordViaSmsGateway

Indicates whether the option to send the password via SMS during the last transfer was enabled.

NotifyAboutDownload

Specifies whether the Notify when files are retrieved option was enabled or disabled during the last transfer.

ShowNameOfAttachments

Specifies whether the Show file names in notification emails option was enabled or disabled during the last transfer.

ShowZipContent

Specifies whether the Show Zip Content option was enabled or disabled during the last transfer.

EncryptMessage

Specifies whether the Encrypt Message option was enabled or disabled during the last transfer.

EncryptSubject

Specifies whether the Encrypt Subject option was enabled or disabled during the last transfer.

PasswordOption

Specifies which password option was last selected.

Download settings

Variable name	Function
SkipImportOptions	Specifies whether to skip selecting download options.
FolderLocation	Specifies where the folder for downloads is (predefine a download location). You can either select an absolute (e.g. C:\Temp) or a relative (e.g. ..\Downloads\Cryptshare Downloads) path. Note that this path is relative to the Documents path of the current user.
ImportDataToEmlAfterDownload	Specifies whether files are attached to the email.
SaveDataAfterDownload	Specifies whether files are stored in a folder.
DeleteNotificationMailAfterDownload	Specifies whether the transfer notification is deleted after download.
SkipFolderSelection	Specifies whether the folder selection is skipped during download. You can skip the folder selection dialog by activating this function. This setting can be adjusted for all types of downloads (encrypted message only, file only, both). The last known download location will be selected. If no location is known, the user is prompted for a new download location.
ImportEmlAfterDownload	Specifies whether the confidential message is imported into the mailbox.
SaveEmlAfterDownload	Specifies whether the confidential message is stored in a folder.

Variable name

Function

SkipImportOptions

Specifies whether to skip selecting download options.

FolderLocation

Specifies where the folder for downloads is (predefine a download location). You can either select an absolute (e.g. C:\Temp) or a relative (e.g. ..\Downloads\Cryptshare Downloads) path. Note that this path is relative to the Documents path of the current user.

ImportDataToEmlAfterDownload

Specifies whether files are attached to the email.

SaveDataAfterDownload

Specifies whether files are stored in a folder.

DeleteNotificationMailAfterDownload

Specifies whether the transfer notification is deleted after download.

SkipFolderSelection

Specifies whether the folder selection is skipped during download. You can skip the folder selection dialog by activating this function. This setting can be adjusted for all types of downloads (encrypted message only, file only, both). The last known download location will be selected. If no location is known, the user is prompted for a new download location.

ImportEmlAfterDownload

Specifies whether the confidential message is imported into the mailbox.

SaveEmlAfterDownload

Specifies whether the confidential message is stored in a folder.

Global settings

Variable name	Function
ProxyPort	Port number for connecting to the proxy server
ProxyType	Proxy Mode Selection system, none, or defined
ProxyUrl	Proxy connection URL.
ProxyUser	Proxy connection username.
ProxyPassword	Proxy connection password.
IsUserenabledProxySelection	Determines whether the user’s selection of the proxy mode can be modified in the Cryptshare for Outlook settings dialog.
IsUserenabledProxyUrl	Determines whether the proxy URL can be modified by the user in the Cryptshare for Outlook settings dialog or not.
IsUserenabledProxyPort	Determines whether the proxy port can be modified by the user in the Cryptshare for Outlook settings dialog or not.
IsUserenabledProxyUser	Determines whether the proxy username can be modified by the user in the Cryptshare for Outlook settings dialog or not.
IsUserenabledProxyPassword	Determines whether the proxy password can be modified by the user in the Cryptshare for Outlook settings dialog or not.

Variable name

Function

ProxyPort

Port number for connecting to the proxy server

ProxyType

Proxy Mode Selection

system, none, or defined

ProxyUrl

Proxy connection URL.

ProxyUser

Proxy connection username.

ProxyPassword

Proxy connection password.

IsUserenabledProxySelection

Determines whether the user’s selection of the proxy mode can be modified in the Cryptshare for Outlook settings dialog.

IsUserenabledProxyUrl

Determines whether the proxy URL can be modified by the user in the Cryptshare for Outlook settings dialog or not.

IsUserenabledProxyPort

Determines whether the proxy port can be modified by the user in the Cryptshare for Outlook settings dialog or not.

IsUserenabledProxyUser

Determines whether the proxy username can be modified by the user in the Cryptshare for Outlook settings dialog or not.

IsUserenabledProxyPassword

Determines whether the proxy password can be modified by the user in the Cryptshare for Outlook settings dialog or not.

SMS gateway settings

Variable name	Function
EncodeSpacesAsPercentTwenty	Specifies whether spaces are encoded as %20.
Encoding	Specifies which encoding is used for texts.
ActivateSmsGatewayFeature	Specifies whether the feature is enabled at startup.
ForceSmsNumberSelection	Determines whether a number must be actively defined by the user, or whether an automatic suggestion is selected from the address book. It is also possible to change the number when the feature is disabled.
GatewayUrl	SMS Gateway Service URL.
RequestType	Specifies whether to communicate with the gateway via POST or GET.
ContentType	Specifies the content type for communication with the gateway.
ResponseType	Specifies the type of response the gateway to expect.
ResponseRegEx	Specifies which keyword is used to acknowledge a successful transfer.
JsonPropertySet.ResponsePropertyName	Specifies which property embedded in the JSON object contains the positive or negative result.
JsonPropertySet.ErrorPropertyName	Specifies which property embedded in the JSON object contains a description of the error that occurred.
AuthenticationCredentials.UserName	If necessary, sets the username for authentication.
AuthenticationCredentials.Password	If necessary, sets the password for authentication.
AuthenticationCredentials.ParameterEncrypted	Specifies whether the parameters need to be decrypted.
HeaderParameters	Can contain a list of freely defined parameters (ParameterSet) that are placed in the request header.
Parameters	Can contain a list of freely defined parameters (ParameterSet) which, depending on the RequestType, are appended to the URL or placed in the request body.
ParameterSet.ParameterName	Specifies the name of the parameter.
ParameterSet.ParameterValue	Sets the value of the parameter.
ParameterSet.ParameterEncrypted	Specifies whether the parameter value needs to be decrypted.

Variable name

Function

EncodeSpacesAsPercentTwenty

Specifies whether spaces are encoded as %20.

Encoding

Specifies which encoding is used for texts.

ActivateSmsGatewayFeature

Specifies whether the feature is enabled at startup.

ForceSmsNumberSelection

Determines whether a number must be actively defined by the user, or whether an automatic suggestion is selected from the address book. It is also possible to change the number when the feature is disabled.

GatewayUrl

SMS Gateway Service URL.

RequestType

Specifies whether to communicate with the gateway via POST or GET.

ContentType

Specifies the content type for communication with the gateway.

ResponseType

Specifies the type of response the gateway to expect.

ResponseRegEx

Specifies which keyword is used to acknowledge a successful transfer.

JsonPropertySet.ResponsePropertyName

Specifies which property embedded in the JSON object contains the positive or negative result.

JsonPropertySet.ErrorPropertyName

Specifies which property embedded in the JSON object contains a description of the error that occurred.

AuthenticationCredentials.UserName

If necessary, sets the username for authentication.

AuthenticationCredentials.Password

If necessary, sets the password for authentication.

AuthenticationCredentials.ParameterEncrypted

Specifies whether the parameters need to be decrypted.

HeaderParameters

Can contain a list of freely defined parameters (ParameterSet) that are placed in the request header.

Parameters

Can contain a list of freely defined parameters (ParameterSet) which, depending on the RequestType, are appended to the URL or placed in the request body.

ParameterSet.ParameterName

Specifies the name of the parameter.

ParameterSet.ParameterValue

Sets the value of the parameter.

ParameterSet.ParameterEncrypted

Specifies whether the parameter value needs to be decrypted.

Other nodes

Variable name

Function

LastTransferManagerView

Specifies whether the transfer history is visible when Outlook starts.

-1 invisible, 0 or 1 visible).

DateOfValidity

Specifies the time since when this configuration file has been valid. This parameter comes into focus when a reconfiguration of the add-in is to be carried out.

ClientStoreLocation

Path and file name of the ClientStore file (contains verification data).

DateOfLastOutlookShutdown

Time when Outlook was last closed.

SuppressUserCredentialsDialog

Suppresses the dialog for entering user data.

RemoveQuotesAroundSenderHeaderValue

Removes the quotes for the sender header.

PlaceSendingEmailInDefaultOutbox

Places the sent mails in the sent folder of the default email address.

ContactSupportDefaultMail

Email address that receives emails for support requests. The standard was set to support@pointsharp.com.

EmbedLinkedImages

This option can prevent the disappearance of embedded graphics as soon as Cryptshare for Outlook is activated.

SuppressSentSizeWarning

This option suppresses the warning for the threshold value "Save sent files up to (MB)".

UseDefaultAccountOnly

If this option is activated, only the default Outlook account is used. This can lead to improved compatibility when using alternative email servers (e.g. Kopano or Zarafa).

MaximumSearchDaysSinceShutdown

After starting Outlook, all emails that have been received since you quit are checked for transfer information. This option can be used to limit how far the add-in looks into the past. The default value is 30 days.

MaximumItemsToSearch

After starting Outlook, all emails that have been received since you quit are checked for transfer information. This option can be used to limit how many emails are scanned in total. The default value is 5000 emails.

SearchDelayTimerSecondsDelegateMailbox

Outlook accounts that are equipped with access rights to a certain mailbox must check it for new emails at intervals. The default value is 60 seconds.

SearchDelayTimerSecondsNewNotifications

After starting Outlook, all emails that have been received since you quit are checked for transfer information. This option can be used to describe the delay until Outlook accounts that have access rights to a mailbox are scanned. The default value is 10 seconds.

SuppressAutomaticDownloadManagerActivation

If this option is activated, the transfer manager will no longer be automatically displayed for incoming and outgoing transfers.

HideCompletedDownloadsDelaySeconds

It is possible to automatically hide the download element of a successfully downloaded one after it has been downloaded. The value stored here is the number of seconds that the download item is displayed before it is hidden. The default value is 60 seconds.

UseDefaultEmailAccountOnly

After activating this option, only the standard account is available for use with Cryptshare. This option can help improve Outlook startup time for users with many mailboxes. Please note, however, that this option should only be used if Cryptshare is only used with your own (standard) account.

DefaultTransferManagerListSize

Defines the number of Transfer Manager entries to display before the "Show all…" appears. The default value is 25 items.

DoNotAttachConfidentialMessageToSentItem

This option specifies whether the confidential message should be skipped when using the "Save sent files" feature. The default value is false.

HideConfidentialContentInSentMail

This option specifies whether to include the text of the confidential message in the sent email. The default value is false.

the 'HideConfidentialContentInSentMail' option overrides the 'DoNotAttachConfidentialMessageToSentItem' option. This means that if the HideConfidentialContentInSentMail option is set to true, the confidential message will not be attached to the email as a file attachment.

DoNotActivateCryptshare WhenInteractingWithSensitiveInformation

This option specifies whether Cryptshare should be activated when an email with sensitive content (i.e. either a confidential message or a notification email with attached files) is forwarded or replied to. The default value is false, which means that Cryptshare will be activated.

UseSimplifiedRibbonButtons

Specifies whether to use the simplified ribbon button.

HideSettingsButton

This option hides the add-in’s Settings button.

HideContactSupportButton

This option hides the Contact Support button of the add-in.

HideActivateQuickButton

This option hides the add-in’s Enable QUICK button.

HideMakeAWishButton

This option hides the add-in’s Make a Wish button.

HideSendWithCryptshareButton

This option hides the Send with Cryptshare button of the add-in.

OpenRevokeMailDraft

Specifies whether the checkbox for displaying the draft revocation mail is displayed or not.

MarkSentItemForDeletion

Set this option to true if you’re having trouble sending transfers that remain in the Outbox.

SentItemSubjectPrefix

Sets a prefix for the subject of the sent email.

SentItemSubjectSuffix

Sets a suffix for the subject of the sent email.

MailDecryptionCategorySubjectPrefix

Sets a prefix for the subject of an imported encrypted email.

MailDecryptionCategorySubjectSuffix

Sets a suffix for the subject of an imported encrypted email.

MailDecryptionCategoryName

Specifies the name of the category used to mark the imported encrypted email.

MailDecryptionCategoryColor

Specifies the color of the category used to mark the imported encrypted email.

UseCustomUriScheme

Specifies whether to force the use of the Download Managers.

MaximumZipItemsToList

Defines the maximum number of files of a zip archive shown in the notification mail.

MaximumAttachedFilesToList

Defines the maximum number of files shown in the notification mail.

HideCompletedDownloads

Defines whether a download that has already been downloaded should continue to appear in the Transfer Manager.

SwapAttachmentsDelay

Specifies how long it takes for attachments to be transferred to the Attachment Manager when activating Cryptshare for Outlook. The default value is 2 seconds.

ForcePopOutOnReply

If this option is activated, clicking on the "Reply" button will always open the reply mail in a pop-out window.

UILanguage

Defines the language of the user interface with a language key. (en-US, de-DE, fr-FR …)

ActivateVisibilityWorkaround

If Cryptshare relevant buttons are not displayed, this workaround can fix the problem.

TrustLocalDirectories

Specifies whether directory links in Cryptshare mails should be trusted.

TrustDownloadedFiles

Specifies whether file links should be trusted in Cryptshare mails.

PlaceSentItemIntoDelegateMailboxSentFolder / PlaceSentItemIntoDefaultMailboxSentFolder

Specifies in which 'Sent Items' directory the outgoing message is archived when a delegated mailbox with full control is used.

In the file, hash values for language packs are recorded under the node <AvailableGuiLanguages>. Those values enable Cryptshare for Outlook (Classic) to detect whether there is a more up-to-date language pack for the interface language on the server than the one installed. Cryptshare for Outlook then pulls the required language resources from the server, and updates the hash values. Please do not make any changes to these nodes.