Sending and Receiving Direct Messages

Owned by Tran Tang
Last updated: Jul 15, 2019
2 min read

Version History

Version
Date
Author
Description
0.1 09/12/2016Daniel FernandezInitial Version
0.209/14/2016Sovann HuynhAdded expected results and implementation testing

Sending Direct messages

Direct messages can consist of an in-line email where the document is included directly in the body of the email (XDR) or a blank email with the document attached (XDM). Using the email client, send a message to a valid email account on the Direct endpoint you have added an anchor for. If an error occurs, you should see a Direct message failure email as well as a DIRECT_ERROR event in your event table. If the message transmission is successfully you will receive a processed MDN email and see successful Direct events in your event table.

Receiving Direct messages

When a Direct message is sent to your Direct email address, you should see the email appear in your inbox and successful inbound Direct events in your event table. If an error has occurred, you will see DIRECT_ERROR in your event table.

Sample email notifications

Notification
Example
Success notification

Subject: Successfully Delivered: Direct Test

Message successfully delivered to the recipient provider1@direct.sitenv.org

Failure notification

Subject: Email Delivery Failed: Direct Test

Email delivery failed for the recipient provider1@direct.sitenv.org

Processed MDN

Subject: Processed: Direct Test

Your message was successfully processed.

Dispatched MDN

Subject: Dispatched: Testing

Your message was successfully dispatched.

Non-STA notification (from the email server)

Subject: Undelivered Mail Returned to Sender

This is the mail system at host ip-172-31-43-181.direct.connectopensource.org.

Direct events

EventDescription

BEGIN_OUTBOUND_DIRECT

An email was detected by the poller and identified for outbound Direct processing
END_OUTBOUND_DIRECTThe email was processed and has been sent out as a Direct message
BEGIN_INBOUND_MDN_PROCESSEDThe receiving Security Trust Agent (STA) (1) received the outbound Direct message and sent a processed MDN
END_INBOUND_MDN_PROCESSEDThe processed MDN email has been processed
BEGIN_INBOUND_MDN_DISPATCHEDThe receiving STA validated and processed the Direct message and forwarded it to the receiving edge mail server
END_INBOUND_MDN_DISPATCHEDThe dispatched MDN email has been processed
DIRECT_EDGE_NOTIFICATION_FAILED

This can mean either of the following:

  • The receiving STA rejected the Direct message
  • The receiving STA accepted the Direct message but was unable to deliver it to the receiving edge mail serever
DIRECT_ERROR

This can mean either of the following:

  • The email that was picked up for Direct processing is from a sender that is not authorized to send Direct messages
  • The email could not be processed for Direct messaging
  • The email that was picked up for Direct processing is intended for an email address that this Direct HISP is not authorized to exchange Direct messages with
  • A Direct message was received that is not from a trusted Direct sender

(1) Security Trust Agent is a Message Transfer Agent, Message Submission Agent or Message User Agent that supporst security and trust for a transaction.

Testing the Direct implementation

/wiki/spaces/CONNECTWIKI/pages/24576016

/wiki/spaces/CONNECT4/pages/83525714

Additional info