Welcome, Guest Login

Support Centre

App Settings Reference

Last Updated: Jul 09, 2013 12:28PM BST
Applicable mkryptor version: 1.1.2

The table below shows all the available settings (AppSettings section) for mkryptor, together with a description of what they do 

Setting Comments
AdminEmail This is the email address of the administrator, which is set during install. Unexpected errors and unhandled exceptions are reported to this email address. Also for the Business and Enterprise editions this address is used as the sender address for all delivery status reports which are returned to the original sender.
AlwaysUseDBFacts If set to true, and Known Facts for a recipient are stored in the [XML or SQL] database then the Known Facts will ALWAYS be used to encrypt the message, regardless of the state of ForceEncryption or if ##encrypt has been specified.
 
The only exception to this is if ##encrypt:No is specified in the message or if a SendMethod of “ignore” has been saved against the recipient in the database
 
(default when empty is “false”)
AnswerTag Special command string used after TagPrefix to identify known fact answer.
 
(Defaults to “:” if empty)
BadPath If set, This is whereany messages which failed processing or failed to send are copied to this directorystored. Uses relative path to working directory.
 
When empty, failed messages are immediately deleted.
 
Useful for troubleshooting purposes. It is possible to move messages from the BadPath folder back into the DropPath folder for reprocessing once the cause of the initial failure has been rectified.
 
NOTE:Messages are stored unencrypted, therefore you should specify a secure storage location.
 
(Defaults to empty whereupon failed messages are instead deletedis empty – do not store failed messages)
BlacklistAction Determines what happens when a received email contains blacklisted attachments.
 
Possible values:
Value Description
Delete Deletes the offending attachment(s) and processes the rest of the message as normal.
The recipient will not receive the attachment
Include Includes the attachment in the PDF as normal.
Depending on the PDF reader used by the recipient they may not be able to open the attachment.
Reject The message is rejected by mkryptor and returned to sender with an appropriate error message.
Zip Adds the attachment to a separate encrypted zip file
 
Whenever an attachment is deleted from a message, or moved to a separate zip file, the recipient is informed as a footnote in the cover email message.
 
(Default is “Include” if empty)
CheckForUpgrades When set to “true” the fresh skies web service is checked daily for any new versions of the software and the results reported to the administrator. When “False” no checks are done or resulting emails sent.
(Default when empty is “true”)
DateFormat When "UK" forces date ‘known facts’ to use format DDMMYYYY. When "US" forces date ‘known facts’ to use format MMDDYYYY.
(Default is "UK" when empty)
DropPath This is where new inbound emails arrive.  Uses relative path to install directory.
 
(Default to "DropBox" if empty)
Edition This setting specifies the mode of operation of the application and is set upon installation.
 
Values are “Personal”, “Business” and “Enterprise”.
 
While using a trial edition of mKryptor, these values can manually be switched. However, when using a full license this value must match the edition purchased in the full license.
EmailExtensions This is a semicolon delimited list of email file extensions that the Email Processor and SMTP Sender look for in the “DropPath” and “OutPath” Folders.
(Default when empty is  "*.msg;*.eml")
EmailTag Special command string used after TagPrefix to identify recipient email address of message.
 
(Defaults to "To:" if left blank)
EnablePerfMon This setting allows administrators to turn on or off the Windows Performance Counters included in the application. These counters include messages per second and total message counts for all three processes, i.e., “SMTP Listener”, “SMTP Sender” and email processor.
Permitted values are “true” or “false”.
(Default when empty is false)
EnableProcessor This settinga allows administrator to turn on or offdisable the “Email ProcesssorProcessor”. This option is only used for test purposes only which. It turns off the processing/encrypting of emails from the DropPath folder to the OutPath folder.
 
(Default when empty is true)
EnableSMTPReceive This setting allows administrators to turn on or offdisable  the embedded inbound  “SMTP Listener” processor.  For instance if wanting to use a 3rd party SMTP server (such as IIS or mdaemon) to deliver messages directly into the DropPath folder.
 
 (Default when empty is true)
EnableSMTPSend This setting allows administrators to disable the embedded outbound  “SMTP Sender”.  For instance if wanting to use a 3rd party SMTP server to pickup messages directly from the OutPath folder.
 
Can also be used to temporarily ‘hold’ messages from being delivered during maintenance.
 
 (Default when empty is true) This setting allows administrators to turn on or off the “SMTP Sender” processor. This allows mKryptor to send emails directly. When using IIS or another SMTP receiver to send emails from the OutPath folder this value can be set to false.
(Default value when empty is true)
EncryptionLevel
 
Specifies level of encryption to use. Available options are:
 
RC40, RC128, AES128, AES256.
 
It is not recommended to use RC40 or RC128 encryption, as these methods are old and relatively easy to circumvent, so should be considered insecure.
 
(Defaults to AES256 if empty)
EndTag Special command string used after TagPrefix to identify end of message body.
 
Useful if your mailserver automatically appends a signature to the end of emails, and you do not wish the signature to be part of the secure message body.
 
Any text after the EndTag will be ignored
 
(Defaults to "END" if empty)
ForceEncryption When “true” forces all received emails to be encrypted unless overridden by original emailan inline SendMethodTag.  Ignored when standalone mode=true.
 
If you need to be able to send emails unencrypted in pass-through mode, or wish to use the SMTPUnsecureMailboxes feature then set this setting to “false”
 
(Defaults to false if empty)
ForceReceipt When set to “true” forces a delivery receipt to be returned to the sender along with an attached copy of the final processed message.
 
When “false” mKryptor instead looks for delivery receipt request headers in original message.
 
(Default is “false” when empty)
IPFilter Semicolon delimited list of sender IP (Version 4) addresses allowed to connect to the mkryptor service. The wildcard characters "*" and "?" are also permitted. E.g:
 
192.168.1.*
 
If the machine running mkryptor is accessible from the internet then you should use this setting to limit access to your local subnet only. Otherwise your machine may get treated as an open SMTP relay.
 
For personal edition this setting is ignored and only IP address of the local machine (127.0.0.1) is permitted.
 
(Default is to allow all IP addresses when blank)
KnownFactsMailbox Sets a mailbox name.
 
Used in the same manner as the ‘SecureMailbox’, except messages sent to this mailbox will only be used to update the KnownFacts [XML or SQL] database, without sending a message to the recipient addresses.
 
(Default is “KnownFacts” when empty)
MailBoxDomains Semicolon delimited list of domain names to use when not in Standalone mode. Emails sent to these domains will be considered as destined for the mKryptor server and special processing will be applied based on the username - see "SMTPSecurePdfMailboxes","SMTPSecureZipMailboxes", "SMTPUnsecureMailboxes" below.
 
(Default to "*" in standalone mode which implies any domain name will be accepted)
MaxPasswordLength The maximum allowed number of characters allowed infor a password.
 
The actual password length used for each message will be chosen at random between MinPasswordLength and MaxPasswordLength
 
(Defaults to "32" if empty)
MinPasswordLength The minimum allowed number of characters allowed in for a password.
 
The actual password length used for each message will be chosen at random between MinPasswordLength and MaxPasswordLength
 
(Defaults to "8" if empty)
OutPath This is where processed outbound emails wait for sendingfor delivery by the “SMTP Sender”. Uses relative path to install directory.
 
(Defaults to "Outbox" if empty)
OwnerPassword Sets the owner password of PDF documents. If set to "userpassword" then the owner password is set to the same as the user password.
 
The Owner Password of a PDF can be used as an alternative decryption password. It can also be used to modify PDF security settings.
 
(Defaults to a randomly generated password if empty)
PdfBlacklistedExtensions By default adobe acrobat will not allow users to open or save attachments with the following file extensions, as they have the potential to be harmful to readers’ computers.
 
Emails containing extensions defined here will be processed using the action defined in the “BlackListAction” setting below.

(Defaults when empty is “ade; adp; app; asp; bas; bz; bz2; cer; chm; class; cmd; command; cpl; crt; csh; exe; fxp; gz; hex; hlp; hqx; hta; inf; ini; ins; isp; its; jar; job; js; jse; ksh; lnk; lzh; mad; maf; mag; mam; maq; mar; mas; mat; mau; mav; maw; mda; mde; mdt; mdw; mdz; msc; msi; msp; mst; ocx; opx; pcd; pkg; pif; prf; prg; pst; rar; reg; scf; scr; sct; sea; shb; shs; sit; tar; tgz; tmp; url; vb; vbe; vbs; vsmacros; vss; vst; vsw; webloc; ws; wsc; wsh; zip; zlo; zoo”)
PollInterval This setting tells the “EmailProcessor” how often (in milliseconds) it should check the “DropPath” for new email messages

(Defaults to 5000 if empty)
PreferZip When “true” specifies an encrypted Zip file is toshould be created instead of a PdfPDF. When “False” an encrypted PDF will be created is to be created unless otherwise specified.
 
(Default when empty is false)
ProcessThreads The maximum number of threads to use for processing/encrypting inbound emails to outbound encrypted messages messages from the dropbox and moving them to the outbox ready for delivery.
 
If set to 0 or empty uses the threadpool.
 
(Default when empty is 0)
QuestionTag Special command string used after TagPrefix to identify known fact question.
 
(Defaults is empty)
RelayReplies If set to true, it will allow mkryptor to relay secure reply messages received from a satellite web service instance to external domains.
 
It is rare that you would ever want to set this. It exists mainly for the fresh skies default mkryptor relay service.
 
(Default when empty is “false”)
ReplyPasswordTag Special command string used after TagPrefix to allow sender to add/update their reply password (for secure replies).
 
(Defaults to "ReplyPassword” if empty)
SatelliteMailbox Many of the functions of the satellite web service require it to be able to communicate with your local copy of mkryptor via email. In this setting you specify the email address of a mailbox than mkryptor can receive mail on.
 
NOTE: If your mail system runs on a non-standard port (i.e., not on port 25), then you can specify a port number after the email address. In the format <email>@<domain>:<port>. E.g.:
 
satellite@company.com:465
 
If left blank then certain functions of the satellite service will be disabled (e.g., Password management), but others (e.g., SecureReplies) will still operate via the fresh skies mkryptor relay service.
 
Note: This setting has no effect if a ‘SatelliteUrl’ has not been set.
SatelliteUrl Used to specify a link to the mkryptor satellite web service. The satellite web service provides auxillary functions such as secure replies, password management, etc.
 
You can either host your own copy of the satellite web service, or can use the external service provided by fresh skies at the below url:
https://www.mkryptor.com/satellite
 
If this setting is left empty then Secure Replies, etc. functions will be turned off.
 
Default is empty
SaveInterval This is the  interval (in seconds) between successive database saves.

(Defaults to 30 if empty)
SaveKnownFacts Determines whether used ‘known facts’ are automatically saved to database.
 
These known facts will then be automatically used for subsequent messages to the same recipient, without having to specify any facts inline.
 
This option is only available in Business Plus and Enterprise Editions.
 
(Default value when empty is “false”)
SendMethodTag Special command string used after TagPrefix to allow sender to override how message will be sent.
 
(Defaults to "SendMethod” if empty)
SentPath If set,  copies of any This is where messages which were have been successfully processed and sent delivered are stored, ready for archiving. Uses relative path to working directory.
 
If empty, sent messages are immediately deleted.
 
Useful for Auditing or testing purposes.
 
NOTE: Messages are stored unencrypted, therefore you should specify a secure storage location.
 
(Defaults to empty: do not store a copy of sent messages)
SMTPAuthType Sets the level of authentication to use for the SMTP listener. Also determines if relaying is allowed. Options are:

Option Description
None No authentication – allows anonymous access, no relaying
Database Basic SMTP authentication.
Username and password must match an email address and password from the Known Facts database.
Relaying is allowed over the authenticated connection
Windows Basic SMTP authentication.
Username and password must match an active directory username and password, in the format WindowsUser@WindowsDomain.
Relaying is allowed over the authenticated connection
SMTPHeloHostame Name to use in SMTP EHLO command for outgoing emailsSMTP communication.
 
This domain name should be a fully qualified name e.g. smtp.domain.com.
 
It is recommended that this setting match an A or CNAME DNS record for the external IP address of the machine. Failing to do this may cause some mail servers to treat your messages as SPAM.
 
(Defaults to fully qualified local host name if empty)
SMTPIPAddress The IP address for the inbound “SMTP Listener” to listen on for incoming mail.
(Default when empty is to listen on all local IP addresses)
SMTPPort The port number for the inbound “SMTP Listener” to listen on for incoming mail.

(Default when empty is 25)
SMTPReceiveThreads The maximum number of threads to use for receiving messages viathe SMTP receiver. If set to 0 uses the threadpool.
 
This affects how many messages can be received (inbound) simultaneously.
 
(Default when empty is 100)
SMTPSecurePdfMailboxes A semicolon delimited list of mailbox usernames. Emails received at these mailboxes will be encrypted in the PDF format.
(Default is " Secure" when empty)
SMTPSecureZipMailboxes A semicolon delimited list of mailbox usernames. Emails received at these mailboxes will be encrypted in theusing Zip format.
 
(Default is "zip" when empty)
SMTPSendThreads The maximum number of threads to use for sending messages viathe  SMTP sender. If set to 0 or empty uses the threadpool.
 
This affects how many messages can be delivered (outbound) simultaneously.
 
(Default when empty is 0)
SMTPTimeout The time (in seconds) to wait for response from SMTP servers before an error is thrown.

(Defaults to 90 if empty)
SMTPUnsecureMailboxes A semicolon delimited list of mailbox usernames. Emails received at these mailboxes will be encapsulated into a PDF format but will not be encrypted.
 
(Default is "unsecure" when empty).
StandaloneMode When “true” mKryptor will only process incoming emails addressed to special mailboxes. For example, “secure@mKryptor.com”. When set to “False” mkryptor will operate in or pass-through mode will alsowhich allows emails to other addresses to be processed.
 
(Default to “false” if empty)
TagPrefix Special character sequence used at the beginning of lines, used to determine mkryptor commands tags.
 
(Defaults to "##" if empty)
TemplatePath Used to specify a folder where mkryptor should load all email templates from.
 
By default (empty) mkryptor will use its built-in templates.
 
If a folder path is specified, mkryptor will look for the following file names within the folder:
 
AdminTemplate.htm
AdminTemplate.txt
ErrorTemplate.htm
ErrorTemplate.txt
HeaderTemplate.htm
HeaderTemplate.txt
HelpTemplate.htm
HelpTemplate.txt
PasswordTemplate.htm
PasswordTemplate.txt
SecureReplyTemplate.htm
SecureReplyTemplate.txt
SecureTemplate.htm
SecureTemplate.txt
UnsecureTemplate.htm
UnsecureTemplate.txt
 
Any that it finds will be used in place of the default version of the named template.
 
TempPath This is where any required temporary files are created.  Uses relative path to install directory.
 
(Defaults to windows temporary directory if empty)
TestEmail This setting is for test purposes only.  and routes all outgoing emails to the email address specified herein.
 
If set, ALL emails will be delivered to the email address specified in the setting (i.e., overrides recipient). When blank, emails will be delivered to their real recipient.
 
If the value “sender” is used then all outgoing emails are returned to sender.
 
If the value “null” is used then all outgoing emails are not actually sent to any recipient but regarded as delivered successfully.
 
(Default when empty is to send to actual recipients specified within the email itself)
Watermark Use this setting to specify text to be shown as a watermark on the first page of each PDF.
 
 or Leave blank to have no watermark.
 
Examples include, “Confidential”, “Draft”, “Top Secret” etc.
 
(Default is empty or- no watermark)
WatermarkAngle The angle of the watermark text (in degrees) (Default is "45")
WatermarkColour The colour of the watermark text to use. Uses standard System.Drawing.KnownColor names
 
(Default is "Red" if empty)
WatermarkFont Use this setting to specify the colour font of the watermark text. Permitted values include:
0 = Courier (Default)
1 = CourierBold
2 = CourierBoldOblique
3 = CourierOblique
4 = Helvetica
5 = HelveticaBold
6 = HelveticaBoldOblique
7 = HelveticaOblique
8 = TimesRoman
9 = TimesBold
10 = TimesItalic
11 = TimesBoldItalic
12 = Symbol
13 = ZapfDingbats
WatermarkLink Use this setting to specify a hyperlink for the watermark text. These hyperlinks can be “http” or “mailto” hyperlinks which when clicked open the specified web address or mail client addressed to the specified recipient.
 
For example,
http://www.mKryptor.com or “mailto:admin@mkryptor.com”.
 
When blank no hyperlink is included.
 
(Default is empty)
WatermarkSize The text size of the watermark (in points). (Default is "72")
WatermarkTransparency The transparency of the watermark text (as a percentage). (Default is "10")
http://assets3.desk.com/
false
@mkryptor
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete