Java HTML

README.md

Umbrella

Umbrella is an Android mobile app developed by Security First that provides human rights defenders with the information on what to do in any given security situation and the tools to do it. It allows the user to choose what they want to do, such as: protect data; securely make a call/email; securely access the internet; plan secure travel; protect their office/home; conduct counter-surveillance; or deal with kidnapping, arrest or evacuation. Once a situation is chosen, the app outlines what to do and what tools to use given your circumstances. This is followed by a simple checklist of recommended actions that can be customised, saved and shared securely. Umbrella’s dashboard also provides users with an up-to-the-minute account of potential risks in their chosen location.

Installation

Umbrella on Google Play Store Umbrella on Amazon App Store Umbrella on FDroid

F-Droid fingerprint: 39EB57052F8D684514176819D1645F6A0A7BD943DBC31AB101949006AC0BC228

Example Usage

Umbrella is designed for everyone (people looking to increase their security, folks living in high risk areas, regular travellers, business people, techies, journalists, NGO staff, aid workers, human rights defenders, social workers, environmental activists etc).

However, when we built Umbrella we tried to keep in mind the story of Glen Greenwald and Edward Snowden. Greenwald couldn't communicate with Snowden at the start because he found it cumbersome to setup encryption (he nearly missed the one of biggest storys of the decade because of this!). Also, when he (and Laura Poitras) travelled to Hong Kong - they didn't have much knowledge about how to meet securely with Snowden and detect surveillance. This is common problem for journalists and acitivists. Umbrella is designed to solve this problem (and others) by having nearly everything they would have needed to know in the one place - in their pocket.

Main Parts of Umbrella

Introduction: This is the part the user sees first. It explains briefly how the app works and the basic terms and conditions.

Menu: The menu is the main way for a user to navigate. It lists the dashboard, lessons and tool guides.

My Security: This where you access checklists you have favourited in "My Checklists" and real time updates in "The Dashboard"

Lessons: Lessons are where users can learn about topics and things that they can do to improve their security. Some of the lessons have different levels (Beginner, Advanced, Expert) depending on the your needs, ability and risk. Each lesson is broken down into sections. At the end of each lesson is a list for other resources and further reading.

Checklists: Checklists are quick and easy references to help users implement the advice in the lessons. You can tick them off as you complete each item. Items can be added, disabled deleted and edited. If you favourite them by clicking the star, you will then see them in "My Checklists." Checklists can also be shared in through other apps such as your email.

Dashboard: The dashboard contains security feeds from places like the UN Relief Web and the US Centers for Disease Control. You enter your location (and how often you want to be updated). Every a new update is released (e.g a disease outbreak in your location), the information comes up on the dashboard.

Tool Guides: These are detailed guides about how to use software and apps mentioned in the lessons.

Lessons

The general flow of lessons are presented in order to replicate the typical way that a user works. Protecting their own information -> Communicating with other people -> Arranging and travelling to a location -> Doing their operations and work -> Dealing with personal issues that may arise-> Seeking support if something goes wrong.

These are the lessons currently in Umbrella.

Information: These lessons mostly cover the security of information that is stored on your computers.

  • Managing information
  • Malware
  • Passwords
  • Protecting Files
  • Safely Deleting
  • Backing Up

Communications: These lessons mostly cover the security of information when it is sent or recieved.

  • Mobile Phones
  • Making a call
  • Sending a message
  • Email
  • The Internet
  • Social Media
  • Radios and Satelite Phones

Travel: These lessons cover security of travelling in high risk areas.

  • Preparation
  • Borders
  • Vehicles
  • Checkpoints
  • Kidnapping

Operations: These lessons include topics that may affect you in your work.

  • Meetings
  • Counter-Surveillance
  • Protests
  • Arrests
  • Evacuation

Personal: These lessons cover issues which may effect you personally.

  • Stress
  • Digital

Emergency Support: Explains places to get extra help if you have a problem.

  • Physical
  • Digital

Tools

These are the tools currrently covered in the tool guide. (A number of them are due to be changed, removed or updated.)

  • Adium
  • Android
  • Chatsecure
  • Cobian Backup
  • Facebook
  • Jitsi
  • K9 Mail & APG
  • KeePassX
  • ObscuraCam
  • Orbot & Orweb
  • PGP for Linux
  • PGP for Mac OS X
  • PGP for Windows
  • Pidgin
  • Psiphon
  • Rescuva
  • Signal
  • TextSecure
  • Tor for macOS
  • Tor for Windows
  • TrueCrypt

Glossary

Contains explanations of the various terms used in the app.

About

Explains the licences that we use for and by Umbrella. Also says a big THANKYOU to everyone who's work we built on to make it happen.

Dashboard Feed Sources

These are the sources that we currently include for real-time updated security feeds. For privacy reasons, users never connect directly to these services. We are always looking for more useful sources that will help users keep updated on the move.

Settings

The three vertical dots in the top of the app. Here you can:

  • Set a password
  • Change the refresh interval for the security feeds
  • Change your location
  • Change your feed sources

Requirements

You need an Android phone with a minimum version of 4.0.3 (SDK 15 - ICE_CREAM_SANDWICH_MR1)

Contributing Bug reports

Unfortunately stuff breaks sometimes. If you are in a hurry and have found a code or content problem then please email it to support@secfirst.org. If you have a little more time we generally try to manage any bugs using GitHub. Please search the existing issues for your bug and create a new one if the issue is not yet tracked.

https://github.com/securityfirst/Umbrella_android/issues

If the issue you have identified is a security risk to users, please read the documentation about our responsible disclosure policy here:

https://secfirst.org/legal.html

If you wish to contact us via PGP, please drop a mail to rory@secfirst.org (2C1D3B4D)

https://pgp.mit.edu/pks/lookup?op=vindex&search=0xFFB9B5BE2C1D3B4D

Contributing Ideas

Idea’s are powerful things! If you have any about what we could do better or things which you think we should do in future, please email us at info@secfirst.org.

Contributing Code

We have a really big development plan of functionality we want to include in the future and are currently in the process of building a way to manage contributions from the open source community. Until we have that up please drop us a mail to info@secfirst.org if you are interested in a contributing a specific part of future code. If there is something you want to help out with in the interim, then here is some basic advice.

  1. Fork it!

  2. Create your feature branch: git checkout -b my-new-feature

  3. Commit your changes: git commit -am 'Add some feature'

  4. Push to the branch: git push origin my-new-feature

  5. Submit a pull request :D

Build Instructions

Build it yourself


Contributors

Thanks to everyone who has contributed code to Umbrella. It wouldn’t have happened without you.

Cryptography Notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted.

See http://www.wassenaar.org/ for more information.

License

Copyright 2013-2017 Global Security First Ltd. (trading as Security First)

Licensed under the GPLv3: http://www.gnu.org/licenses/gpl-3.0.html