Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

A Secure Message is a Short Text Message that can be sent and received securely using

Brand
brandclient
. Secure Messages share the same communication infrastructure provided used for secure voice. EVSS do
Brand
brandsuiteshort
 do not relay at all on Apple Push Notification or Google Cloud Messaging, in order to protect users' security:

...

Secure Messages are text only, thus no attachments are provided. Maximum length of a Secure Message is 160 characters.

How does a Secure Message work?

When a user chooses to send a Secure Message, it triggers an HTTPS POST request in his client towards

Brand
brandserver
which plays a "store-and-forward" role. If recipient is online, Secure Message is immediately delivered. Otherwise it is stored temporarily in
Brand
brandserver
up to 3 days before expiring: as soon as the recipient pops up online,
Brand
brandserver
delivers the Secure Message.

...

Subtitle
Prefixfigure
SubtitleTextTyping a new Secure Message in history view (BlackBerry)
AnchorNamebb_typing_new_message

 Image Added

Subtitle
Prefixfigure
SubtitleTextTyping a new Secure Message in history view (iPhone)
AnchorNameiphone_typing_new_message

 Image Added

Subtitle
Prefixfigure
SubtitleTextTyping a new Secure Message in history view (Android)
AnchorNameandroid_typing_new_message

 Image Added

Info

Please note that by convention, your outgoing communications are placed on the right side of the screen, while the incoming ones by the chosen contact are placed on the left of the screen.

...

As stated before, Secure Messages are also available from "Contacts" view which is probably the best way to start a conversation via text messages. Obviously first thing it to reach the contact you want to write to. Please refer to Performing a secure call with <ac:macro ac:name="brand"><ac:parameter ac:name="brand">client</ac:parameter></ac:macro>.Secure calling. 

Subtitle
Prefixfigure
SubtitleTextNew Secure Message from contact's details (BlackBerry)
AnchorNamebb_new_message_contact

Image Added

Subtitle
Prefixfigure
SubtitleTextNew Secure Message from contact's details (iPhone)
AnchorNameiphone_new_message_contact

Image Added

Subtitle
Prefixfigure
SubtitleTextNew Secure Message from contact's details (Android)
AnchorNameandroid_new_message_contact

Image Added

Once you reached the specific number of your peer contact, then you can open his contact's history by pressing the "info" icon in Android and iPhone or just pressing the central button on the keyboard in BlackBerry (please check 

Xref
AnchorNamebb_central_button
Xref
AnchorNameiphone_info_icon
 and 
Xref
AnchorNameandroid_info_icon
).

You'll get exactly the same view shown in History (detailed event view).

...

So you can now type your message, just as in 

Xref
AnchorNamebb_typing_new_message
Xref
AnchorNameiphone_typing_new_message
 and 
Xref
AnchorNameandroid_typing_new_message
.

...

Receiving Secure

...

Messages

Obviously a Secure Message can be received as it can be sent. In this case a specific notification is raised by

Brand
brandclient
using system's notifications.

iPhone lockedbrand in backgroundOnce you open the application

Subtitle
Prefix
brandclient
figure
SubtitleTextnew Secure Message notification is shown
Brand
brandclient
shows an event

AnchorNamenew_msg_notification

Image Added

Subtitle
Prefixfigure
SubtitleTextevent notification on its icon

"Recent" icon shows how many events occurred.

Clicking on "Recent" shows "History" list with event item in bold.

Image RemovedImage RemovedImage Removed
BlackBerry lockedClick on system's notification areaClick on
Brand
brandclient
item

Sound and vibration notify a new event.

Once unlocked "new message" icon is shown in notification area

When you drop down the event list,

Brand
brandclient
item

shows the "new message" icon and you can click on it.

You got redirected directly to "History" view where

 "Message received" event is bolded.

Image RemovedImage RemovedImage Removed

Sound and vibration notify a new event. If you had a model equipped

with coloured led, then it would lit.

Once unlocked,
Android lockedClick on system's notification areaClick on
Brand
brandclient
item
AnchorNameiphone_icon_notification

Image Added

Subtitle
Prefixfigure
SubtitleTextnew Secure Message notification is shown
AnchorNamebb_new_msg_notification
Image Added
Subtitle
Prefixfigure
SubtitleTextdrop down event list shows "new message" icon
AnchorNamebb_icon_notification
Image Added
Image RemovedImage Removed
Subtitle
Prefixfigure
SubtitleText"new message" icon is shown in notification area

When you drop down the event list,

Brand
brandclient
item

shows the "new message" icon and some details about the sender.

Once you clicked on

Brand
brandclient
item in event list, you got

redirected directly to "History" view where the "received message" event is bolded.

AnchorNameandroid_new_msg_notification
Image Added
Subtitle
Prefixfigure
SubtitleTextdrop down event list shows "new message" icon
AnchorNameandroid_icon_notification

Image Modified

Info

If just one message has been received, then clicking on the notification would lead you directly to the event detail where you'll be able to read the message.

 

As shown above each platform shows the event notification differently, according to the underlying operating system behaviour.

Secure Messages compared to

...

regular Text Messages (SMS)

Secure Messages provide a user experience very similar to SMS, adding security and with some minor differences. Some current constraints will be relaxed in next versions.

...

  • You cannot attach anything to a Secure Message: Secure Messages are actually text only. 
  • Secure Message length is fixed to a maximum of 160 characters
  • Each Secure Message has a time validity, after which it expires. Expiration means that the Secure Message content is no longer readable and it's gone for good. Instead of message content you'd rather read "Message received" or "Message sent". 
Subtitle
Prefixfigure
SubtitleTextBlackBerry expired Secure Message
AnchorNamebb_expired_msg

Image Added

Subtitle
Prefixfigure
SubtitleTextiPhone expired Secure Message
AnchorNameiphone_expired_msg

Image Added

Image Removed
Subtitle
Prefixfigure
SubtitleTextAndroid expired Secure Message
Image Removed
AnchorNameandroid_expired_msg

Image Modified

Each time you send a Secure Message you can see a status icon appearing on its side. Here follows an explanation of each icon along with its status name and meaning:

IconDescriptionMeaning Timeouts and general behaviour
Image Modified

Sending Message

Brand
brandclient
is actually trying to send the Secure Message to its recipient via
Brand
brandserver

If there is some network issue, then

Brand
brandclient
starts the retry procedure: it tries to send 5 times the message to
Brand
brandserver
. If it fails at the fifth try (5 * TLSTimeout = 60 secs), then the message remains in the client queue waiting for one of the following triggers:

    • The user can connect to Sip Server
    • The client sends a SIP KeepAlive to the server
    • The user sends another message

If more than 12 hours passed and the message is still in client queue waiting to be sent, then the message expires: a "Send error" notification is fired by

Brand
brandclient
and the message is removed from local queue

 

Image ModifiedMessage Enqueued

Secure Message has been enqueued in

Brand
brandserver
encrypted storage and will be delivered to recipient as soon as possible.

If delivery is not possible because the peer if offline,
Brand
brandserver
retries as soon as recipient registers for up to an expiration period (72h), before removing them definitely from the database.
Image ModifiedMessage Delivered

Secure Message has been delivered to recipient's device, who could have read it or not.

None
Image ModifiedError sending Message

This status is a fall back for any other one and it's triggered both by timeouts and error responses.

None

...