document_provider.md

Becoming a Document Provider

A Document Provider is the strongest e-Box integration that can be made as it allows to offer e-Box features to Users be it Senders or Consumers. As such it is also the most challenging, requiring integration to setup a REST Web Service that will integrate with several other Web Services of the federation.

The Document Provider has some responsibilities toward te overall e-Box enterprise federation:

• Provide a Service which matches the e-Box Enterprise Service Level Agreement (SLA) in terms of availability, security and performance
• Store User document with the adequate confidentiality
• Inform the e-Box Federation of e-Box activities like new messages or messages being read.
• Follow latest guidelines to ensure safeguard the end user experience.

Document Provider onboarding process

Message Registry Service

The Message Registry Service is the most important part of the Document Provider. There are two main levels of service that a Document Provider can offer.

• Consultation: Only implement the Consultation parts of the API. This allows to expose messages to the Document Consumers
• Publication: Also implement the Publication parts of the API. Allowing replies to messages and new publication being done through a standardized method.

The Consultation part is required to be considered a Document Provider while the Publication is optional.

Notifications

In order to notify users of any new, unread or soon to be expire messages, an integration with the Ebox Event Service (EES) Enterprise is required.

The EES is a system which allows Document Providers to send Events to Human Interface provider's (HIP) so that the HIP can notify the user.

The following events must be sent in the following scenarios:

• newDocument: This event MUST be sent when a new Message arrives in the e-Box
• newDocumentReminder: This event MUST be sent when the Message has not been read 15 days after it has been published
• documentExpirationAlert: This event MUST be sent 7 days prior to the Message expiring only if the document has not been read yet
• readDocument: This event MUST be sent when the MAIN Document is read for the first time

readDocument Event:

Notifications are eMail that are sent once per day with a summary of the event's received. The readDocument event is here to prevent us sending Notifications about Messages that have been read by the User between the time the unread message Event was sent and the time the Notification is sent to the User.