DomainKeysVerifyResult Enumeration

Defines the return values of Verify(MailMessage, Smtp) method.

Namespace: MailBee.Security
Assembly: MailBee.NET (in MailBee.NET.dll) Version: 12.5.0 build 687 for .NET 4.5

Syntax

public enum DomainKeysVerifyResult

Public Enumeration DomainKeysVerifyResult

Members

Member name	Value	Description
OK	0	The DomainKeys signature of the message is valid and up to date.
MessageNotSigned	1	The message is not signed with DomainKeys signature.
SignatureInvalidTag	2	The DomainKeys signature tag in the message headers is invalid.
SignatureExpired	3	The DomainKeys signature is expired.
DomainInvalid	4	The DomainKeys signature refers to a non-existent sender domain.
DnsQueryFailed	5	DNS query could not be performed. Perhaps, all DnsServers (supplied in dnsRequestor parameter of Verify(MailMessage, Smtp) method) are dead. By default, MailBee throws MailBeeDomainKeysException in case of this error.
DnsEntryInvalidTag	6	The DomainKeys DNS record of the sender domain is incorrect.
SignatureInvalid	7	The DomainKeys signature of the message is invalid.
PublicKeyBadFormat	8	The public key contained in DomainKeys DNS record of the sender domain has wrong format.
Sha256NotSupported	9	It's not possible to verify the given DKIM signature because it uses SHA256 while the current system does not support SHA256 algorithm (usually, in case of .NET Framework prior to 4.0 on a FIPS-enabled system). By default, MailBee throws MailBeeDomainKeysException in case of this error. With MailBee.NET.dll for .NET 4.0+ this error will never occur, regardless whether Windows operates in FIPS mode or not.

Remarks

Some errors are considered a problem with the system running MailBee and thus by default MailBee will throw MailBeeDomainKeysException in case of such errors. To suppress exceptions and get all errors as the method's return values, disable DomainKeys.ThrowExceptions (or MailMessage.ThrowExceptions if you using MailMessage.DomainKeysVerify method).

Note
In case of a FIPS-compliant system, enable FipsMode to make MailBee always use FIPS-compliant methods. If you don't do that, MailBee will fall back to a FIPS-compliant method only after the default method fails, and this degrades performance a bit. However, in .NET 2.0/3.5 the SHA256 method (which is used in DKIM) is available only as FIPS-noncompliant implementation. On a FIPS system, it's recommended to always use MailBee.NET.dll for .NET 4.0+ along with the corresponding .NET Framework.

Note

In case of a FIPS-compliant system, enable FipsMode to make MailBee always use FIPS-compliant methods. If you don't do that, MailBee will fall back to a FIPS-compliant method only after the default method fails, and this degrades performance a bit. However, in .NET 2.0/3.5 the SHA256 method (which is used in DKIM) is available only as FIPS-noncompliant implementation. On a FIPS system, it's recommended to always use MailBee.NET.dll for .NET 4.0+ along with the corresponding .NET Framework.

Reference

MailBee.Security Namespace