///<summary>Encrypts the message, verifies trust, locates the public encryption key for the To address (if already stored locally), etc. emailMessage.
///Use this polymorphism when the attachments have already been saved to the email attachments folder in file form. patNum can be 0.
///Returns an empty string upon success, or an error string if there were errors. It is possible that the email was sent to some trusted recipients and not sent to untrusted recipients (in which case there would be errors but some recipients would receive successfully).
///Surround with a try catch.</summary>
public static string SendEmailDirect(EmailMessage emailMessage,EmailAddress emailAddressFrom) {
//No need to check RemotingRole; no call to db.
emailMessage.FromAddress=emailAddressFrom.EmailUsername.Trim();//Cannot be emailAddressFrom.SenderAddress, or else will not find the correct encryption certificate. Used in ConvertEmailMessageToMessage().
//Start by converting the emailMessage to an unencrypted message using the Direct libraries. The email must be in this form to carry out encryption.
Health.Direct.Common.Mail.Message msgUnencrypted=ConvertEmailMessageToMessage(emailMessage,true);
Health.Direct.Agent.MessageEnvelope msgEnvelopeUnencrypted=new Health.Direct.Agent.MessageEnvelope(msgUnencrypted);
Health.Direct.Agent.OutgoingMessage outMsgUnencrypted=new Health.Direct.Agent.OutgoingMessage(msgEnvelopeUnencrypted);
string strErrors=SendEmailDirect(outMsgUnencrypted,emailAddressFrom);
return strErrors;
}
///<summary>Gets the oldest Direct Ack (MDN) from the db which has not been sent yet and attempts to send it.
///If the Ack fails to send, then it remains in the database with status AckDirectNotSent, so that another attempt will be made when this function is called again.
///This function throttles the Ack responses to prevent the email host from flagging the emailAddressFrom as a spam account. The throttle speed is one Ack per 60 seconds (to mimic human behavior).
///Throws exceptions.</summary>
public static void SendOldestUnsentAck(EmailAddress emailAddressFrom) {
if(RemotingClient.RemotingRole==RemotingRole.ClientWeb) {
Meth.GetVoid(MethodBase.GetCurrentMethod());
return;
}
string command;
//Get the time that the last Direct Ack was sent for the From address.
command=DbHelper.LimitOrderBy(
"SELECT MsgDateTime FROM emailmessage "
+"WHERE FromAddress='"+POut.String(emailAddressFrom.EmailUsername.Trim())+"' AND SentOrReceived="+POut.Long((int)EmailSentOrReceived.AckDirectProcessed)+" "
+"ORDER BY MsgDateTime DESC",
1);
DateTime dateTimeLastAck=PIn.DateT(Db.GetScalar(command));//dateTimeLastAck will be 0001-01-01 if there is not yet any sent Acks.
if((DateTime.Now-dateTimeLastAck).TotalSeconds<60) {
//Our last Ack sent was less than 15 seconds ago. Abort sending Acks right now.
return;
}
//Get the oldest Ack for the From address which has not been sent yet.
command=DbHelper.LimitOrderBy(
"SELECT * FROM emailmessage "
+"WHERE FromAddress='"+POut.String(emailAddressFrom.EmailUsername.Trim())+"' AND SentOrReceived="+POut.Long((int)EmailSentOrReceived.AckDirectNotSent)+" "
+"ORDER BY EmailMessageNum",//The oldest Ack is the one that was recorded first. EmailMessageNum is better than using MsgDateTime, because MsgDateTime is only accurate down to the second.
1);
List <EmailMessage> listEmailMessageUnsentAcks=Crud.EmailMessageCrud.SelectMany(command);
if(listEmailMessageUnsentAcks.Count<1) {
return;//No Acks to send.
}
EmailMessage emailMessageAck=listEmailMessageUnsentAcks[0];
string strRawEmailAck=emailMessageAck.BodyText;//Not really body text. The entire raw Ack is saved here, and we use it to reconstruct the Ack email completely.
Health.Direct.Agent.MessageEnvelope messageEnvelopeMdn=new Health.Direct.Agent.MessageEnvelope(strRawEmailAck);
Health.Direct.Agent.OutgoingMessage outMsgDirect=new Health.Direct.Agent.OutgoingMessage(messageEnvelopeMdn);
try {
string strErrors=SendEmailDirect(outMsgDirect,emailAddressFrom);//Encryption is performed in this step. Throws an exception if unable to send (i.e. when internet down).
if(strErrors=="") {
emailMessageAck.SentOrReceived=EmailSentOrReceived.AckDirectProcessed;
emailMessageAck.MsgDateTime=DateTime.Now;//Update the time, otherwise the throttle will not work properly.
Update(emailMessageAck);
}
}
catch {
}
}
///<summary>Throws exceptions. Uses the Direct library to sign the message, so that our unencrypted/signed messages are built the same way as our encrypted/signed messages.
///The provided certificate must contain a private key, or else the signing will fail (exception) when computing the signature digest.</summary>
public static void SendEmailUnsecureWithSig(EmailMessage emailMessage,EmailAddress emailAddressFrom,X509Certificate2 certPrivate) {
if(emailAddressFrom.IsImplicitSsl) {
throw new Exception(Lans.g("EmailMessages","Digitally signed messages cannot be sent over implicit SSL."));//See detailed comments in the private version of SendEmailUnsecure().
}
//No need to check RemotingRole; no call to db.
emailMessage.FromAddress=emailAddressFrom.EmailUsername.Trim();//Cannot be emailAddressFrom.SenderAddress, or else will not find the correct signing certificate. Used in ConvertEmailMessageToMessage().
Health.Direct.Common.Mail.Message msg=ConvertEmailMessageToMessage(emailMessage,true);
Health.Direct.Agent.MessageEnvelope msgEnvelope=new Health.Direct.Agent.MessageEnvelope(msg);
Health.Direct.Agent.OutgoingMessage msgOut=new Health.Direct.Agent.OutgoingMessage(msgEnvelope);
Health.Direct.Agent.DirectAgent directAgent=GetDirectAgentForEmailAddress(emailMessage.FromAddress);
Health.Direct.Common.Cryptography.SignedEntity signedEntity=directAgent.Cryptographer.Sign(msgOut.Message,certPrivate);//Compute the signature digest. A hash of the certificate against the raw email content.
msgOut.Message.UpdateBody(signedEntity);//Modify the relevant message headers as well as the entire message body to include the signature digest.
WireEmailUnsecure(msgOut,emailAddressFrom,emailMessage.PatNum);
}