Versions Compared

Key

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

Brand
brandclient

Quick Start Guide for Android

This guide provides you easy step-by-step instructions to help you get started with

Brand
brandclient
.

Secure calls with 
Brand
brandclient

Calling with

Brand
brandclient
 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

Brand
brandclient
software running on the mobile device, be connected to the Internet and to the same
Brand
brandserver
.

 

 

Subtitle
Prefixfigure
SubtitleTextMain view
AnchorNameandroid home

Calling by Contacts list

Select Contacts tab from the tab bar, tap on the contact you want to call and select the contact number associated with
Brand
brandserver
.
Subtitle
Prefixfigure
SubtitleTextyour address book is shared with application
AnchorNameandroid_contact_list

As you can see in 

Xref
AnchorNameandroid_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

Brand
brandclient
 activated and/or connected. The main value of this feature is to improve user experience suggesting the possible outcome of a call.

Contacts lists

Brand
brandclient
 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
    Brand
    brandserver
    '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 "
    Brand
    brandclient
    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:

Contact status

OnlineThe contact is reachable. You can make a secure call to the user.
OfflineThe contact is not reachable, because is not under network coverage or is offline. You can try to make a secure call but the call will likely fail
Warning

The contact is not reachable using a full secure call, but you can call him using one Sip Trunk configured on your server. 

ErrorThere is a comunication error between your phone and the server. The contact status is unknown, anyway you can try to make a secure call

 

Calling by dialpad

You can make a secure call to any arbitrary number (presuming that the call peer has

Brand
brandclient
 connected) from
Brand
brandclient
 menu by simply entering the number with the on-screen keypad and pressing the dial (green) button. 

Subtitle
Prefixfigure
SubtitleTextApplication dial pad
AnchorNameandroid dialpad

Receiving a secure call with 
Brand
brandclient

Once

Brand
brandclient
 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,

Brand
brandclient
has to be running and be connected to the Internet.

Subtitle
Prefixfigure
SubtitleTextyou are receiving a secure call
AnchorNameandroid receiving call

Subtitle
Prefixfigure
SubtitleText
AnchorNameandroid call in course

Call status

To establish a call

Brand
brandclient
 completes three phases shown by two icons:

Call status icons

Red light

Starting the connection

Connection not yet established. This step may take several seconds

Green light

Secure call established

Connection established and secure. You can now speak securely

Checking your security

A

Brand
brandclient
 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

Brand
brandclient
 is listed into the "History" tab, which can be displayed by pressing "Recent" icon on the tab bar.

  
Subtitle
Prefixfigure
SubtitleTextrecent event list
AnchorNamerecent_log

 

Subtitle
Prefixfigure
SubtitleTextevent detail icon
AnchorNameevent_detail_icon

 

Each event has a detail icon (the clock that ends each event line shown in 

Xref
AnchorNameevent_detail_icon
).

Subtitle
Prefixfigure
SubtitleTextevent detail
AnchorNameevent_log_detail

By clicking on this icon you have access to event's details (cfr 

Xref
AnchorNameevent_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

Secure Messages rely on the very same security infrastructure the voice calls do. Plus for security each Secure Message is blanked 15 minutes after it's been read or sent.

Subtitle
Prefixfigure
SubtitleTextblanked secure message
AnchorNameblanked_secure_message

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 "History" tab

Secure Messages are available via "History" tab, going into the detailed view: 

Xref
AnchorNameevent_log_detail

Subtitle
Prefixfigure
SubtitleTexttype a new Secure Message
AnchorNametyping_ptm

Using interface shown in  you can type text messages and send them to your party by pressing the "Send" button (the one on the right side of the text box in 

Xref
AnchorNametyping_ptm
).

Sending Secure Messages from "Contacts list" tab

Secure Messages are also available from "Contacts list" tab. 

Subtitle
Prefixfigure
SubtitleTextcontact's details icon
AnchorNamedetail_icon

 

 

Subtitle
Prefixfigure
SubtitleTextcontacts list tab
AnchorNamecontacts_list_tab

 

 

 

You have to select an account from the list shown in 

Xref
AnchorNameandroid_contact_list
 and show its details by clicking on "detail icon" displayed on its right side (see 
Xref
AnchorNamedetail_icon
).

Then you get general contact (shown in 

Xref
AnchorNamecontacts_list_tab

Subtitle
Prefixfigure
SubtitleTextcontact's communication view
AnchorNamecontact_further_detail

Once you choose which phone number of the account you want to send Secure Messages to, then you have to press on "clock icon" (

Xref
AnchorNameevent_detail_icon
) to get the view shown in 
Xref
AnchorNamecontact_further_detail
. In this view you can type your message.

Secure Messages status icons and known limitations

Each Secure Message is displayed with an icon showing its status. Most important icons are:

IconMeaning

Sending Message

Message Delivered
Error sending Message

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).

Warning

Please note that the body of each Secure Message you send or receive will be deleted after 15 minutes you read or wrote it.