-
Notifications
You must be signed in to change notification settings - Fork 3
Expand file tree
/
Copy path7mobilemartus.html
More file actions
executable file
·271 lines (251 loc) · 27.3 KB
/
7mobilemartus.html
File metadata and controls
executable file
·271 lines (251 loc) · 27.3 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
<!DOCTYPE html>
<!--[if IE 8]> <html lang="en" class="ie8"> <![endif]-->
<!--[if IE 9]> <html lang="en" class="ie9"> <![endif]-->
<!--[if !IE]><!--> <html lang="en"> <!--<![endif]-->
<head>
<title>Mobile Martus</title>
<!-- Meta -->
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="">
<meta name="author" content="">
<link rel="shortcut icon" href="favicon.ico">
<link href='https://fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800' rel='stylesheet' type='text/css'>
<!-- Global CSS -->
<link rel="stylesheet" href="css/bootstrap.min.css">
<link rel="stylesheet" href="assets/plugins/font-awesome/css/font-awesome.css">
<link rel="stylesheet" href="assets/plugins/elegant_font/css/style.css">
<!-- Theme CSS -->
<link id="theme-style" rel="stylesheet" href="assets/css/styles.css">
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]-->
</head>
<body class="body-green">
<div class="page-wrapper">
<!-- ******Header****** -->
<header id="header" class="header">
<div class="container">
<div class="branding">
<h1 class="logo">
<a href="index.html">
<span aria-hidden="true" class="icon_documents_alt icon"></span>
<span class="text-highlight">Martus</span><span class="text-bold">Docs</span>
</a>
</h1>
</div><!--//branding-->
<ol class="breadcrumb">
<li><a href="index.html">Home</a></li>
<li class="active">Mobile Martus</li>
</ol>
</div><!--//container-->
</header><!--//header-->
<div class="doc-wrapper">
<div class="container">
<div id="doc-header" class="doc-header text-center">
<h1 class="doc-title"><i class="icon fa fa-paper-plane"></i> Mobile Martus</h1>
<div class="meta"><i class="fa fa-clock-o"></i> Last updated: Feb 12th, 2017</div>
</div><!--//doc-header-->
<div class="doc-body">
<div class="doc-content">
<div class="content-inner">
<section id="mm-intro" class="doc-section">
<h2 class="section-title">Mobile Martus Introduction</h2>
<div class="section-block">
<p>Mobile Martus is a secure, Android-based mobile documentation application built on Benetech’s Martus technology, which allows users anywhere in the world to securely gather and organize information about human rights violations.</p>
<p> Mobile Martus application allows users to send crucial data from the field—text, photographs, audio and video—to the Martus network of secure servers. The data is automatically encrypted on the mobile device, and when being sent to the server, so it is protected in case the device is lost, stolen or confiscated. A user—or someone they designate—can later retrieve their data, and can search, analyze and report on the information, using the Martus client software on their computer.</p>
</div>
</section><!--//doc-section-->
<section id="mm-functionality-section" class="doc-section">
<h2 class="section-title">Mobile Martus Main Functionality</h2>
<div class="section-block">
<h3>Create Records</h3>
<p>Mobile users can create records with Title and Summary fields and attachments of any type (e.g. photos, video, audio or text notes).The records are encrypted and sent to a Martus server (with an option to use <a href="4managingrecords.html#Tor">Tor</a>, to be retrieved by a Martus Desktop account for further editing, customization, reporting, or sharing with others.</p>
<h3>Send Files from Other Apps</h3>
<p>Users can choose the “Martus” icon to send a file to Martus (as a record attachment) via the “Send To” (or “Share”) option in many third party apps. For example, users can take a photo or video or record audio and send </p>
<div>
<section id="mm-installation-section" class="doc-section">
<h2 class="section-title">Mobile Martus Installation</h2>
<div class="section-block">
<h3>Mobile Martus System Requirements</h3>
<ul class="list">
<li>Android device (e.g. phone or tablet) running 2.3.4 (Gingerbread) or later (Jellybean version 4.2 or later recommended)</li>
<li>If you want to retrieve your own records sent from Mobile Martus, you must also have the Martus Desktop Client installed (<a href="https://www.martus.org/download">download here</a>). See Martus Desktop Account Setup” for more information.</li>
<li>If someone else is going to be receiving the records you send from Mobile Martus, they must have provided you with their Martus Desktop account Access Token and server information.</li>
</ul>
<h3>Martus Desktop Account Setup</h3>
<p>Anyone who is going to retrieve Mobile Martus records into a Martus Desktop account (whether it is you or someone else) must do the following steps.</p>
Please refer to <a href="2gettingstarted.html">Getting Started with Martus</a>.
<ol class=list>
<li>Create a Martus Desktop account that will retrieve records from Mobile Martus. </li>
<li>Configure a server in the Desktop Martus account. </li>
<li>Document the Martus Desktop account’s <a href="3keepingdatasecure.html#sharing-contacts-section">Access Token</a> in order to add the account as a Contact from the server. If you cannot connect to a server, you can also export the Martus Desktop account’s Public Information File (*.mpi) and copy to the mobile device (or give to you to copy to your mobile device).</li>
</ol>
<p>Note: If your Android device accepts SD cards, ideally transfer the Public Account File to an SD card and insert that SD card into your device. Alternately you can email the file to an address that you can access on your Android device and download the attachment from there.</p>
<h3>Mobile Martus Setup</h3>
<ol class="list">
<li>Download the Mobile Martus app to your Android device from the Google Play Store. If you can’t access the Google Play Store, please email <a href="mailto:martus@benetech.org">martus@benetech.org</a> for other ways to access the Mobile Martus app.</li>
<li>Install the app, which requires accepting the standard Android privacy statement. The Mobile Martus app will have permission to access the network (for sending records to the server) and storage (for saving account and encrypted record files) on your device.</li>
<li>The Martus app can be put on your home screen or found with your mobile device’s other applications.</li>
<p><img src="images/mobile1.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<li>Open the Martus app</li>
<li>Create a new password for Mobile Martus app use only. For security, make sure that this is different from any of your Martus Desktop account passwords. Passwords must be at least 8 characters.</li>
<p><img src="images/mobile2.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<li>You have the option to turn on Tor before configuring your connection to a Martus server. For more information on Tor, see <a href="#extra-security-mm-section">Extra Security</a> below.
<p><img src="images/mobile3.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<li>Select a server.</li>
<ul class="list">
<li>Use default server connects you to a default Martus backup server without having to manually input any information. </li>
<li>Advanced server settings allow you to connect to a server by manually inputting that server’s IP address, public code and magic word.</li>
</ul>
<p><img src="images/mobile4.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<li>Add a Contact account to which you will send Mobile Martus record data. This Contact can be your own Martus Desktop account.</li>
<ul class="list">
<li>To add a Contact to your account using an Access Token, select <b>Add Contact from Server</b>. Input the Contact’s Access Token and again select <b>Add Contact from Server</b>.Verify the Contact by reviewing the Public Code associated with the Contact’s Access Token and select <b>Yes</b>.</li>
<li>To add a Contact from a Martus Desktop Public Information File (.mpi), select <b>Import Contact from File</b>. Select <b>Choose Martus Desktop account (.mpi) file</b> and pick the exported Martus Desktop Public Information File (*.mpi) using an Android file explorer of your choice. The included file explorer can only look at the contents of the SD card. Enter the Martus Desktop account Public Code and select <b>OK</b>.</li>
</ul>
<p><img src="images/mobile5.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<p>Please make sure you have input the correct Contact information, because if the incorrect account information is used, someone other than your intended recipient might receive the data this device uploads.</p>
</div>
On the Settings screen of the menu, you have some additional options:
1.
</div>
</section><!--//doc-section-->
<section id="mm-settings-section" class="doc-section">
<h2 class="section-title">Optional Setup</h2>
<div class="section-block">
<p>On the Settings screen of the menu, you have some additional options:</p>
<ul class="list">
<li> Timeout: Choose how long after any activity the app will require you to re-login/enter your password. For more security, choose a smaller value.</li>
<li> Author: Set a name you want to appear as the author in records.</li>
<li> Record language: Set the language of the text you will be entering in your records (used for searching/reports/charts in the Martus Desktop Client).</li>
<li> Use Wi-Fi Only: With this option on, no Martus records will be sent to the server unless you are in a location where Wi-Fi is available, so you will not be using your mobile data plan to send records. If this is off, Martus records will be sent using either Wi-Fi or your mobile data plan.</li>
<li> Update Contact: Change the Martus Desktop Contact account to which you send your records.</li>
<li> Select Server: Allows you to send your records to a different Martus server.</li>
</ul>
<p><img src="images/mobile6.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
</div>
</section><!--//doc-section-->
<section id="using-mm-section" class="doc-section">
<h2 class="section-title">Using Mobile Martus</h2>
<div class="section-block">
<h3>Sending Records from inside the Mobile Martus app</h3>
<ol class="list">
<li>Open the Mobile Martus app. A new blank record will immediately open.</li>
<li>Enter text as desired in the Title and Summary fields. If your device has a voice recorder in its keyboard, you can speak the text you want to enter. </li>
<p>Additional fields can be added once the record is retrieved in a Martus Desktop account.</p>
<li>Choose the paperclip icon ( ) to select one or multiple attachments. If you attach a file by mistake you can press and hold on the attachment to bring up a “Remove” option.</li>
<p><img src="images/mobile7.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<li>Click the Send button to send the record to the server. Text and attachments in the Martus record are encrypted and zipped before sending to the Martus server, and the zipped record files are removed from the mobile device once they are successfully sent to the server.</li>
<p>Note: The original attachments (e.g. photos in your Gallery) are not removed from the mobile device by Martus, so if you are worried about them being accessed by someone (e.g. if your device was stolen/lost), please remove them from your mobile device after you are notified that the record was sent successfully. You may need to take extra precautions to ensure that the deleted original attachment files cannot still be accessed by an expert attacker.</p>
<p><img src="images/mobile8.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<p>The progress of the secure transmission will display on the screen and in the notification bar at the top of the screen.</p>
<p><img src="images/mobile9.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<p>When the record has been successfully sent to the Martus server, you will see a “Record sent!” message on the screen and an upward arrow in the notification bar at the top of the screen.</p>
<p><img src="images/mobile10.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<li>You can send additional records (even while an earlier record is still sending), or logout of the Martus app.</li>
<li>If you are unable to send records due to internet or server connectivity issues, you can retry sending them later under your device’s menu button or menu icon (which looks like this on many devices: ) by selecting <b>Manage Records</b> > <b>Resend Unsent Records</b>. Martus will save the encrypted and zipped record files for you to re-send when you are in a location where you have connectivity. If you receive messages saying that Martus could not send the records, you might want to check if you have <b>Use Wi-Fi Only</b> selected under your Martus <b>Settings</b>, and you can turn that setting off to use your mobile data plan if you want to send the Martus records right away.</li>
</ol>
<h3>Sending files to Martus from other apps</h3>
<p>Alternately, you can “Send to Martus” directly from most other applications on your mobile device, using the standard “Share” option (which looks like this on many devices ). </p>
<p>Below is an example of sending a photo to Martus from your Gallery.</p>
<p><img src="images/mobile11.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
</div>
</section><!--//doc-section-->
<section id="extra-security-mm-section" class="doc-section">
<h2 class="section-title">Extra Security in Mobile Martus</h2>
<div class="section-block">
<p>For extra security, turn on the <a href="4managingrecords.html#Tor">Tor</a> option located on the new record screen. This will make it harder to track the route your record takes to the Martus server, and may allow you to reach the Martus server if it is blocked from your current location, but will also make sending records slower. Clicking on this will prompt you to first install, and then start up the Tor Orbot app if you haven’t done so already.</p>
<p><img src="images/mobile12.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<p><img src="images/mobile13.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<p><img src="images/mobile14.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<p><img src="images/mobile15.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<p><img src="images/mobile16.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<p>Wait until the Orbot circle turns green before pressing the back button to return to Mobile Martus.</p>
<p><img src="images/mobile17.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
</div>
</section><!--//doc-section-->
<section id="additional-options-mm-section" class="doc-section">
<h2 class="section-title">Additional Options in Mobile Martus</h2>
<div class="section-block">
<p>To see these additional options, press your device’s menu button or tap the menu icon (which looks like this on many devices: ).</p>
<p><img src="images/mobile18.png" alt="mobile martus" style="width:35%; padding:5px;"></p>
<ol class="list">
<li>Manage My Account</li>
<ol class="list" type="a">
<li>View Access Token: Allows you to view your account’s Access Token which can be used by a Martus Desktop account to add and “verify” you as a trusted Contact from a server. </li>
<li>Delete My Account: to remove any unsent record information and your account files from the mobile device. After doing this, you will have to create a new account on your device to run Mobile Martus.</li>
<li>View Public Code: Allows you to identify your Mobile Martus account for verification or troubleshooting purposes.</li>
<li>Email Public Account ID: Send your account information file (named “Mobile_Public_Account_ID.mpi” by default) as an attachment in an email. </li>
<li>Send Public Account ID in Record: Send your account information file (named “Mobile_Public_Account_ID.mpi” by default) as an attachment to a Martus record.</li>
<li>Export Public Account ID: Your account information file (named “Mobile_Public_Account_ID.mpi” by default) will be saved to a specific location on your device. </li>
<p>Note: If a Martus Desktop account cannot connect to a server, options c-f above will allow that account to add and “verify” you as a trusted Contact without an Access Token. See “Downloading Mobile Records” below for more information on how to do this.</p>
</ol>
<li>Settings</li>
<p>See <a href="#mm-settings-section">Optional Setup</a> for an overview of Mobile Martus settings.</p>
<li>Manage Records</li>
<ol class="list" type="a">
<li>Resend Unsent Records: If you tried to send records when your device had no connectivity, Martus will save the encrypted and zipped record files for you to re-send when you are in a location where you have connectivity. If you receive messages saying that Martus could not send the records, you might want to check if you have Use Wi-Fi Only selected under your Martus Settings, and you can turn that setting off to use your mobile data plan if you want to send the Martus records right away.</li>
</ol>
<li>Help</li>
<ol class="list" type="a">
<li>Link to Help Docs: Provides a link to a page on the Martus website that contains this Reference Guide as well as other documents about Mobile Martus for Android.</li>
<li>Contact Us: Provides a link to email martus@benetech.org directly from your mobile device.</li>
<li>Understanding Tor: Provides an overview of Tor as well as a link to the Tor Project website.</li>
</ol>
<li>Show Version: Shows the version of the Mobile Martus for Android software that is currently running on your mobile device.</li>
<li>Check Server: Allows you to check if the Martus server you previously set up is available and online.</li>
<li>Logout: Discards any record data in the current record and logs you out of the Martus app.</li>
<li>Cancel: Discards any record data in the current record and opens a new blank record.</li>
</ol>
</div>
</section><!--//doc-section-->
<section id="downloading-mobile-records-section" class="doc-section">
<h2 class="section-title">Downloading Mobile Records</h2>
<div class="section-block">
<p>Anyone who is going to retrieve Mobile Martus records into the Martus Desktop account (whether it is you or someone else) should do the following steps.</p>
<ol class="list">
<li>Login to the Martus Desktop account. Mobile Martus Records will have been sent to the server as all private “Contacts Draft records” for the Desktop account (i.e. the Desktop account is itself acting as a “Contact” account for the Mobile Martus records as well)</li>
<li>If desired, you can “verify” the Mobile Martus account before retrieving its records.</li>
<li>Retrieve the Contact records in the Martus Desktop account.</li>
<li>If desired, the retrieved Mobile Martus records can be modified (e.g. adding additional fields, text or attachments) and then saved either as draft or sealed records in the Desktop account.</li>
<li>Mobile Martus records will be included in any searches, reports, or charts on all the records in your Desktop account.</li>
</ol>
</div>
</section><!--//doc-section-->
</div><!--//content-inner-->
</div><!--//doc-content-->
<div class="doc-sidebar hidden-xs">
<nav id="doc-nav">
<ul id="doc-menu" style="top:180px!important;" class="nav doc-menu">
<li><a class="scrollto" href="#mm-intro">Mobile Martus Introduction</a></li>
<li><a class="scrollto" href="#mm-functionality-section">Mobile Martus <br>Main Functionality</a></li>
<li><a class="scrollto" href="#mm-installation-section">Mobile Martus Installation</a></li>
<li><a class="scrollto" href="#using-mm-section">Using Mobile Martus</a></li>
<li><a class="scrollto" href="#extra-security-mm-section">Extra Security<br>in Mobile Martus</a></li>
<li><a class="scrollto" href="#additional-options-mm-section">Additional Options<br>in Mobile Martus</a></li>
<li><a class="scrollto" href="#downloading-mobile-records-section">Downloading Mobile Records</a></li>
</ul><!--//doc-menu-->
</nav>
</div><!--//doc-sidebar-->
</div><!--//doc-body-->
</div><!--//container-->
</div><!--//doc-wrapper-->
</div><!--//page-wrapper-->
<footer id="footer" class="footer text-center">
<div class="container">
<!--/* This template is released under the Creative Commons Attribution 3.0 License. Please keep the attribution link below when using for your own project. Thank you for your support. :) If you'd like to use the template without the attribution, you can check out other license options via our website: themes.3rdwavemedia.com */-->
<small class="copyright">Designed with <i class="fa fa-heart"></i> by <a href="http://themes.3rdwavemedia.com/" targe="_blank">Xiaoying Riley</a> for developers</small>
</div><!--//container-->
</footer><!--//footer-->
<!-- Main Javascript -->
<script type="text/javascript" src="js/jquery-3.1.1.min.js"></script>
<script type="text/javascript" src="js/bootstrap.min.js"></script>
<script type="text/javascript" src="js/main.js"></script>
<script type="text/javascript" src="assets/plugins/jquery-match-height/jquery.matchHeight-min.js"></script>
<script type="text/javascript" src="assets/plugins/jquery-scrollTo/jquery.scrollTo.min.js"></script>
</body>
</html>