Quick Start Guide for Android
This guide provides you easy step-by-step instructions to help you get started with
.
Secure calls with
Calling with
is a very easy task. You can both use your
contact list or directly dial a number using the
dialpad.
Info |
---|
To make a secure call, you and the called party must have software running on the mobile device, be connected to the Internet and to the same . |
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | Main view |
---|
AnchorName | android home |
---|
|
![android_main_screen.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
Select
Contacts tab from the tab bar, tap on the contact you want to call and select the contact number associated with
.
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | your address book is shared with application |
---|
AnchorName | android_contact_list |
---|
|
![android_contact_list.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
As you can see in
Xref |
---|
AnchorName | android_contact_list |
---|
|
each contact can show a coloured ball at its left, or nothing at all. These are status marker and they represent the
Presence Status for each contact.
Presence
The Presence avoid users to call contacts who are not reachable, eg: because they do not have
activated and/or connected. The main value of this feature is to improve user experience suggesting the possible outcome of a call.
gives you access to three different kind of lists:
- ALL: it lists all the contacts which are in the mobile address book, ordering them in the very same way.
- KNOWN: it shows only known contacts (registered or not) according to 's knowledge. This means it is a list of the contacts that are recognised by the server and thus can have a status.
- FAVOURITES: it reads the contacts marked by you as " favorites". It's a selection of contacts you choose to have apart, in order to make speed calls.
Each list may show a Contact status beside each contact. The contact status legenda is shown below:
Calling by dialpad
You can make a secure call to any arbitrary number (presuming that the call peer has
connected) from
menu by simply entering the number with the on-screen keypad and pressing the dial (green) button.
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | Application dial pad |
---|
AnchorName | android dialpad |
---|
|
![android_dialpad_with_numbers.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
Receiving a secure call with
Once
is installed and all the settings are correctly configured on your device you are able to receive a secure call. When a secure call arrives to your device a notification bar will be shown on the top of the screen. Tap on the notification to bring the application in foreground, then answer or decline the call from the application. After the system have exchanged and verified the security keys the you can start the conversation.
Info |
---|
To receive a secure call, has to be running and be connected to the Internet. |
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | you are receiving a secure call |
---|
AnchorName | android receiving call |
---|
| ![android_incoming_call.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
| Subtitle |
---|
Prefix | figure |
---|
SubtitleText | call in course |
---|
AnchorName | android_call_in_course |
---|
| ![android_call_secured.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
|
Call status
To establish a call
completes three phases shown by two icons:
Call status icons
![call_status_connecting.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
| Red light | Starting the connection | Connection not yet established. This step may take several seconds |
![call_status_secured.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
| Green light | Secure call established | Connection established and secure. You can now speak securely |
Checking your security
A
call is
always encrypted. The call is automatically secured during the call setup. As soon as the call is established you can immediately start to talk securely with your call peer.
Info |
---|
The security of the call is based on a digital certificate verification on the SIP/TLS server. If a certificate error appears check whether the date of your phone is correct. If the date is correct it is possible that the certificate is wrong, misconfigured or expired or that your phone is undergoing a security attack. In these cases always contact your system administrator. |
History
Every event performed or received on your
is listed into the "History" tab, which can be displayed by pressing "
Recent" icon on the tab bar.
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | recent event list |
---|
AnchorName | recent_log |
---|
|
|
| Subtitle |
---|
Prefix | figure |
---|
SubtitleText | event detail icon |
---|
AnchorName | event_detail_icon |
---|
| ![android_open_contact_history.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
|
Each event has a detail icon (the (i) at that ends of each event line shown in
Xref |
---|
AnchorName | event_detail_icon |
---|
|
). Subtitle |
---|
Prefix | figure |
---|
SubtitleText | event detail |
---|
AnchorName | event_log_detail |
---|
|
![android_call_history_details.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
By clicking on this icon you have access to event's details (cfr
Xref |
---|
AnchorName | event_log_detail |
---|
|
).
Secure Messages
You can communicate with your peers by text messages using the Secure Messages System which provides Secure Messages. A Secure Message is a text message that travels into the same encrypted architecture of the Secure Call.
Info |
---|
The maximum length of a single message is 160 character |
- If is configured with PIN disabled 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".
- if is configured with PIN enabled each Secure Message is persistent.
Note |
---|
If you disable PIN or use duress code all messages and calls history will be deleted from . |
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | blanked secure message |
---|
AnchorName | blanked_secure_message |
---|
|
![android_expired_secure_message.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
Warning |
---|
Secure Message System need specific abilitation. If the service is not available on your device please contact your support team to check it's enabled on your account. |
Sending Secure Messages from "Messages" tab
Sending Secure Messages from "Messages" view is very easy and straight forward.
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | Open Message History view |
---|
AnchorName | android_message_history |
---|
| ![android_message_history_icon_highlighted.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
| Subtitle |
---|
Prefix | figure |
---|
SubtitleText | Android Composer |
---|
AnchorName | android_composer |
---|
| ![android_composer.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
|
- If the conversation already exist in "Messages" view, then just tap on its entry to pop-up composer and write your Secure Message (as in
Xref |
---|
AnchorName | android_message_history |
---|
|
). - If you want to start a new chat by Secure Messages, then just tap + icon highlighted on the top right side of . Contact list will pop-up, tap on contact to whom you want to send Secure Message and composer will popup (as in
Xref |
---|
AnchorName | android_composer |
---|
|
) and now you are ready to write your secure message. - It is also possible to insert a phone number, composer will popup
Xref |
---|
AnchorName | android_composer |
---|
|
and now you are ready to write your secure message.
Secure Messages are also available from "Contacts list" tab.
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | contacts list details |
---|
AnchorName | contacts_list_details |
---|
|
![android_contact_icon_highlighted.png](/docs/plugins/servlet/confluence/placeholder/unknown-attachment?locale=en_GB&version=2)
|
You have to select a contact from the list shown in
Xref |
---|
AnchorName | android_contact_list |
---|
|
, tap on the contact and show its details Xref |
---|
AnchorName | contacts_list_details |
---|
|
, click on send secure message icon next to star highlighted, composer will pop up . Secure Messages status icons and known limitations
Each Secure Message is displayed with an icon showing its status. Most important icons are:
There are few known limitations in the current Secure Message System:
Note |
---|
Actually it's not possible to use Secure Messages in order to chat with multiple people (ie it's not possible to create chat rooms). |