diff --git a/AndroidManifest.xml b/AndroidManifest.xml index dd07c40be..f40597688 100644 --- a/AndroidManifest.xml +++ b/AndroidManifest.xml @@ -269,6 +269,10 @@ android:theme="@style/TextSecure.LightTheme" android:configChanges="touchscreen|keyboard|keyboardHidden|orientation|screenLayout|screenSize"/> + + diff --git a/assets/help/en/help.html b/assets/help/en/help.html new file mode 100644 index 000000000..716d6c0b3 --- /dev/null +++ b/assets/help/en/help.html @@ -0,0 +1,782 @@ + + + + + + +FAQ - Delta Chat + + + + + + + + + + + + + +
+ + + + + +

Frequently Asked Questions

+ + + + + +
+ + Table of Contents + + + +
+ + +

+ + + General + + +

+ +

+ + + What is Delta Chat? + + +

+ +

+ +

Delta Chat is a new chat app that sends messages via e-mails, encrypted if possible, with Autocrypt. +You do not have to sign up anywhere, just use your existing e-mail account with Delta Chat.

+ +

+ + + How can I find people to chat with? + + +

+ +

With Delta Chat, you can write to every existing e-mail address - even +if the recipient is not using the Delta Chat app. No need for the +recipient to install the same app as yours, as with other messengers.

+ +

+ + + What are the advantages of Delta Chat compared to other messengers? + + +

+ +
    +
  • Independent of any company or services. You own your data.
  • +
  • Your data is not saved on a central server unless all users are using +the same e-mail servers
  • +
  • You do not distribute your address book to anyone.
  • +
  • Fast by the use of Push-IMAP.
  • +
  • Largest userbase - recipients not using Delta Chat can be reached as well.
  • +
  • Compatible - not only to itself.
  • +
  • Elegant and simple user interface.
  • +
  • Distributed system.
  • +
  • No Spam - only messages of known users are shown by default.
  • +
  • Reliable - safe for professional use.
  • +
  • Trustworthy - can even be used for business messages.
  • +
  • Copyleft and Standards based libre software.
  • +
+ +

+ + + Which messages do appear in Delta Chat? + + +

+ +

Delta Chat automatically shows:

+ +
    +
  • Messages from contacts in your address book
  • +
  • Messages from contacts contacted by you
  • +
  • Replies to messages sent by you
  • +
+ +

Other messages do not appear automatically, and are to be found in the main menu at Contact requests. If desired a chat can be started from there.

+ +

+ + + What about spam? + + +

+ +
    +
  • Messages in common spam folders are ignored and contained addresses are not considered as known contacts.
  • +
  • As messages from unknown contacts do not pop up automatically, normally, there is no spam.
  • +
  • However, if needed, you can block any contact.
  • +
+ +

+ + + Does Delta Chat support images, videos and other attachments? + + +

+ +
    +
  • Yes. Beside the plain text, all e-mail attachments are displayed as separate messages. Outgoing messages get attachments as needed automatically.
  • +
+ +

+ + + Who sees my profile picture? + + +

+ +
    +
  • +

    You can add a profile picture in your settings. If you write to your contacts +or add them via QR code, they automatically see it as your profile picture.

    +
  • +
  • +

    Contacts who don’t use Delta Chat see it as an E-Mail attachment.

    +
  • +
  • +

    For privacy reasons, no one sees your profile picture until you write a +message to them.

    +
  • +
  • +

    Your profile picture isn’t sent with every message, but regularly enough that +your contacts will re-receive your profile picture, even if they add a new +device.

    +
  • +
+ +

+ + + Does Delta Chat support HTML e-mails? + + +

+ +
    +
  • Yes. If incoming e-mail lacks a plain text part, HTML-emails is converted to plain text in the app. Outgoing e-mails always use plain text.
  • +
+ +

+ + + Why do I have to enter my E-Mail password into Delta Chat? Is this secure? + + +

+ +

As with other E-Mail programs like Thunderbird, K9-Mail, or Outlook, the +program needs the password so you can use it to send mails. Of course, the +password is stored only on your device. The password is only transmitted to +your E-Mail provider (when you login), which has access to your mails anyway.

+ +

If you use an E-Mail provider with OAuth2 support like gmail.com or yandex.ru, +there is no need to store your password on the device. In this case, only an +access token is used.

+ +

As Delta Chat is Open Source, you can check the Source +Code +if you want to verify that your credentials are handled securely. We are happy +about feedback which makes the app more secure for all of our users.

+ +

+ + + Which Android permissions does Delta Chat need? + + +

+ +
    +
  • Camera (can be disallowed) +
      +
    • take pictures and videos: for sending Photos
    • +
    +
  • +
  • Contacts (can be disallowed) +
      +
    • read your contacts: to discover contacts to chat with
    • +
    +
  • +
  • Location (can be disallowed) +
      +
    • access approximate location (network location sources): for the location streaming feature
    • +
    • access precise location (GPS and network location sources): for the location streaming feature
    • +
    +
  • +
  • Microphone (can be disallowed) +
      +
    • record audio: for audio messages
    • +
    +
  • +
  • Storage (can be disallowed) +
      +
    • modify or delete the contents of your SD card: to download message attachments
    • +
    • read the contents of your SD card: to share files with your contacts
    • +
    +
  • +
  • Other app capabilities +
      +
    • change your audio settings: so you can choose ring tones and volume for notifications and audio messages
    • +
    • run at startup: so you don’t have to start Delta Chat manually
    • +
    • control vibration: for notifications
    • +
    • view network connections: to connect to your E-Mail provider
    • +
    • prevent phone from sleeping: so you can easier copy the security code during the Autocrypt Setup Message
    • +
    • have full network access: to connect to your E-Mail provider
    • +
    • view Wi-Fi connections: to connect to your E-Mail provider
    • +
    • ask to ignore battery optimisations: for users who want to receive messages all the time
    • +
    +
  • +
+ +

+ + + Groups + + +

+ +

+ + + Creation of a group + + +

+ +
    +
  • Select Add group from the “Sandwich menu” in the upper right corner of the chat overview.
  • +
  • On the following screen, select the group members and hit the check mark in the upper right corner. After that, you can define a group name.
  • +
  • As soon as you write the first message in the group, all members are informed about the new group and can answer in the group (as long as you do not write a message in the group the group is invisible to the members).
  • +
+ +

+ + + Add members to a group + + +

+ +
    +
  • Every group member has the same rights as any other. For this reason every one can delete every member or add new ones.
  • +
  • To add or delete members, click on the group name in the chat.
  • +
+ +

+ + + What is a verified group? Why is it experimental? + + +

+ +
    +
  • +

    A verified group is a chat that gurantees safety against an active +attacker. All Messages in a verified chat view are e2e-encrypted, and +members can join by scanning a “QR invite code”. All members are thus +connected with each other through a chain of invites, which guarantee +cryptographic consistency against active network or provider attacks. +See https://countermitm.readthedocs.io/en/latest/new.html +for the R&D behind this feature.

    +
  • +
  • +

    As of Dec 2019, a “verified group” remains an experimental feature. +It is continously improved and many bugs have been fixed since the +original introduction in 2018. However, there remain cases, especially +with large groups where inconsistencies can occure, or messages become +unreadable. Early 2020 a security review is upcoming, and several new +developments around qr-join protocols are taking place so chances +are we remove the “experimental” label not too far in the future.

    +
  • +
+ +

+ + + I have deleted myself by accident. + + +

+ +
    +
  • As you’re no longer a group member, you cannot add yourself again. +However, no problem, just ask any other group member in a normal chat to re-add you.
  • +
+ +

+ + + I do not want to receive the messages of a group any longer. + + +

+ +
    +
  • +

    Either delete yourself from the member list or delete the whole chat. +If you want to join the group again later on, ask another group member to add you again.

    +
  • +
  • +

    As an alternative, you can also “Mute” a group - doing so means you get all messages and +can still write, but are no longer notified of any new messages.

    +
  • +
+ +

+ + + Encryption + + +

+ +

+ + + Does Delta Chat support end-to-end-encryption? + + +

+ +
    +
  • Yes. Delta Chat implements the Autocrypt Level 1 standard and can +thus E2E-encrypt messages with other Autocrypt-capable apps.
  • +
+ +

+ + + What do I have to do to activate the end-to-end-encryption? + + +

+ +
    +
  • +

    Nothing.

    +
  • +
  • +

    Delta Chat apps (and other Autocrypt-compatible +e-mail apps) share the keys required for end-to-end-encryption automatically +as the first messages are sent. +After this, all subsequent messages are encrypted end-to-end automatically. +If one of the chat partners uses a non-Autocrypt e-mail app, subsequent +messages are not encrypted until an Autocrypt-compliant app is available again.

    +
  • +
  • +

    If you want to turn off the end-to-end-encryption, +use the corresponding setting in “Settings / Advanced settings”.

    +
  • +
+ +

+ + + If end-to-end-encryption is not available, is the connection not encrypted at all? + + +

+ +
    +
  • With most mail servers, Delta Chat establishes transport encryption +(TLS). +This only secures the connection between your device and your e-mail +server. Whereas e2e-encryption provides safety between +your device and a friend’s device.
  • +
+ +

+ + + How can I verify cryptographic status with a sender? + + +

+ +

The user’s profile shows some additional info:

+ +
    +
  • +

    Tap “QR Invite code” on Android and then use the “Scan QR code” +button on another device to scan this code. If both devices are online, +they will introduce a chat channel with each-other (if it doesn’t exist already) +and the encryption keys will also be verified. Both will see a +“sender verified” system message in their 1:1 chat.

    +
  • +
  • +

    For end-to-end-encryption, Delta Chat shows two fingerprints there. +If the same fingerprints appears on your chat partner’s device, +the connection is safe.

    +
  • +
  • +

    For transport encryption, this state is just shown there

    +
  • +
+ +

+ + + How can I check the encryption of messages? + + +

+ +
    +
  • +

    If a little padlock is shown beside a message, this denotes the message is end-to-end-encrypted and is sent from the given sender and that your answer will be end-to-end-encrypted as well.

    +
  • +
  • +

    If there is no padlock, the message is usually transported unencrypted e.g. because you or the sender have turned off end-to-end-encryption, or the sender uses an app without support for end-to-end-encryption.

    +
  • +
+ +

+ + + Which standards are used for end-to-end-encryption? + + +

+ +
    +
  • Autocrypt is used for establishing +e2e-encryption with other Delta Chat and other Autocrypt-capable mail apps. +Autocrypt uses a limited subset of OpenPGP functionality. Moreover, +Delta Chat implements the “countermitm” protocols to achieve +protection against active network attacks, going beyond the opportunistic +base protection of Autocrypt, see questions about “Verified Groups”.
  • +
+ +

+ + + What is the difference between verified groups and 1:1 chats with verified contacts? + + +

+ +
    +
  • +

    1:1 chats with a verified contact and verified groups are not the same, even +if there are only 2 people in the verified group. One difference is that you +could easily add more people to the group, but there are other implications as +well.

    +
  • +
  • +

    Verified groups are invariably secured. Any breakage (cleartext or wrongly +signed messages etc.) will be flagged and such messages will not be shown in +this chat. You can trust all messages in this verified-checkmark chat to have +not been read/altered by middle parties.

    +
  • +
  • +

    1:1 chats are opportunistic, it is meant to allow people to communicate no +matter if they change e-mail clients, devices, setups etc. That’s why there +is no verification checkmark, even if you have verified the contact.

    +
  • +
+ +

+ + + Does Delta Chat support Perfect Forward Secrecy? + + +

+ +
    +
  • +

    No, OpenPGP doesn’t support Perfect Forward Secrecy. Perfect Forward Secrecy +works session-oriented, but E-Mail is asynchronous by nature +and often used from multiple devices independently. This means that if your +Delta Chat private key is leaked, and someone has a record +of all your in-transit messages, they will be able to read them.

    +
  • +
  • +

    Note that if anyone has seized or hacked your running phone, +they will typically be able to read all messages, no matter if Perfect +Forward Secrecy is in place or not. Having access to a single device +from a member of a group, will typically a lot of the social graph. +Using e-mail addresses that are not easily tracked back to persons +helps group members to stay safer from the effects of device seizure.

    +
  • +
  • +

    We are sketching ways to protect communications better against the event +of device seizure.

    +
  • +
+ +

+ + + How does Delta Chat protect my Metadata? + + +

+ +
    +
  • +

    As Delta Chat is a decentralized messenger, the metadata of Delta Chat users +are not stored on a single central server. However, they are stored on the mail +servers of the sender and the recipient of a message.

    +
  • +
  • +

    Each mail server currently know about who sent and who received a message by +inspecting the unencrypted To/Cc headers and thus determine which e-mail addresses +are part of a group. Delta Chat itself could avoid unencrypted To/Cc headers quite +and always put them only into the encrypted section. See +Avoid sending To/CC headers for verified groups. +For opportunistic chats the main concern is how it affects other mail apps who +might participate in chats.

    +
  • +
  • +

    Many other e-mail headers, in particular the “Subject” header, are +end-to-end-encryption protected, see also this upcoming IETF +RFC.

    +
  • +
+ +

+ + + Can I re-use my existing private key? + + +

+ +
    +
  • +

    Yes. The best way is to send an Autocrypt Setup Message from the other e-mail client. Look for something like Start Autocrypt Setup Transfer in the settings of the other client and follow the instructions shown there.

    +
  • +
  • +

    Alternatively, you can import the key manually in “Advanced settings / Manage private keys”. Caution: Make sure the key is not protected by a password, or remove the password beforehand.

    +
  • +
+ +

If you don’t have a key or don’t even know you would need one - don’t worry: Delta Chat generates one as needed, you don’t have to hit a button for it.

+ +

+ + + I can’t import my existing PGP key into Delta Chat. + + +

+ +

With a very good chance, the problem is that your key is encrypted and/or uses +a password. Such keys are not supported by Delta Chat. You may remove the +passphrase encryption and the password and try the import again. If you want +to keep your passphrase you’ll have to create an e-mail alias for use +with Delta Chat such that Delta Chat’s key is tied to this e-mail alias.

+ +

Format wise, Delta Chat supports common OpenPGP private key formats, however, it +is unlikely that we will support 100% of all private keys of any sources. This +is also not the main focus of Delta Chat (in fact, the large majority of the +Delta Chat users will not have any key before they start using Delta). +However, we try to support private keys from other sources as good as possible.

+ +

Removing the password from the private key will be different, depending on the +software you use to manage your PGP keys. With Enigmail, you can set your +password to an empty value in the Key Management window. With GnuPG you can set +it via the command +line. +For other programs, you can find a solution online.

+ +

+ + + Why don’t you use pEp (pretty easy privacy)? + + +

+ +
    +
  • Delta Chat uses the Autocrypt e2e-encryption standard. For +a discussion of Autocrypt and pEp, see the Autocrypt +FAQ.
  • +
+ +

+ + + Multi-client + + +

+ +

+ + + Can I use Delta Chat on multiple devices at the same time? + + +

+ +

If you want to use the same account on different (Autocrypt +capable) devices, you have to sync their encryption capabilities:

+ +
    +
  • +

    On the first device, choose “Advanced settings / Send Autocrypt Setup message” +and click until a “security number” is shown.

    +
  • +
  • +

    On the other device, wait for the “Autocrypt Setup Message” to +arrive and click on it, which should prompt you for the security number.

    +
  • +
  • +

    You are now synchronized, and can use both devices for +sending and receiving E2E-encrypted messages with your communication partners.

    +
  • +
+ +

+ + + Miscellaneous + + +

+ +

+ + + Does Delta Chat work with my e-mail-provider? + + +

+ +
    +
  • With a rather good chance: Yes :)
    +However, some providers need special options to work properly; users have collected some of them in the forum at Provider Overview
  • +
+ +

+ + + I’m interested in the technical details. Can you tell me more? + + +

+ + + + + + + +
+ + + + + + diff --git a/res/layout/local_help_activity.xml b/res/layout/local_help_activity.xml new file mode 100644 index 000000000..9bc912f61 --- /dev/null +++ b/res/layout/local_help_activity.xml @@ -0,0 +1,12 @@ + + + + + + + diff --git a/res/menu/local_help.xml b/res/menu/local_help.xml new file mode 100644 index 000000000..5a6f451e5 --- /dev/null +++ b/res/menu/local_help.xml @@ -0,0 +1,17 @@ + + + + + + + + + + + \ No newline at end of file diff --git a/res/menu/text_secure_normal.xml b/res/menu/text_secure_normal.xml index 9be7293b7..784ce2635 100644 --- a/res/menu/text_secure_normal.xml +++ b/res/menu/text_secure_normal.xml @@ -21,4 +21,7 @@ + + diff --git a/src/org/thoughtcrime/securesms/ApplicationPreferencesActivity.java b/src/org/thoughtcrime/securesms/ApplicationPreferencesActivity.java index c4bc5063c..65dc51720 100644 --- a/src/org/thoughtcrime/securesms/ApplicationPreferencesActivity.java +++ b/src/org/thoughtcrime/securesms/ApplicationPreferencesActivity.java @@ -251,11 +251,7 @@ public class ApplicationPreferencesActivity extends PassphraseRequiredActionBarA startActivity(new Intent(getActivity(), InviteActivity.class)); break; case PREFERENCE_CATEGORY_HELP: - try { - startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(getString(R.string.pref_help_url)))); - } catch (ActivityNotFoundException e) { - Toast.makeText(getActivity(), R.string.no_browser_installed, Toast.LENGTH_LONG).show(); - } + startActivity(new Intent(getActivity(), LocalHelpActivity.class)); break; default: throw new AssertionError(); diff --git a/src/org/thoughtcrime/securesms/ConversationListActivity.java b/src/org/thoughtcrime/securesms/ConversationListActivity.java index e54aa27f7..2fe7076ee 100644 --- a/src/org/thoughtcrime/securesms/ConversationListActivity.java +++ b/src/org/thoughtcrime/securesms/ConversationListActivity.java @@ -194,12 +194,27 @@ public class ConversationListActivity extends PassphraseRequiredActionBarActivit super.onOptionsItemSelected(item); switch (item.getItemId()) { - case R.id.menu_new_chat: createChat(); return true; - case R.id.menu_settings: handleDisplaySettings(); return true; - case R.id.menu_qr: handleQr(); return true; - case R.id.menu_deaddrop: handleDeaddrop(); return true; - case R.id.menu_global_map: handleShowMap(); return true; - case android.R.id.home: onBackPressed(); return true; + case R.id.menu_new_chat: + createChat(); + return true; + case R.id.menu_settings: + startActivity(new Intent(this, ApplicationPreferencesActivity.class)); + return true; + case R.id.menu_help: + startActivity(new Intent(this, LocalHelpActivity.class)); + return true; + case R.id.menu_qr: + new IntentIntegrator(this).setCaptureActivity(QrActivity.class).initiateScan(); + return true; + case R.id.menu_deaddrop: + handleDeaddrop(); + return true; + case R.id.menu_global_map: + handleShowMap(); + return true; + case android.R.id.home: + onBackPressed(); + return true; } return false; @@ -232,10 +247,6 @@ public class ConversationListActivity extends PassphraseRequiredActionBarActivit startActivity(intent); } - private void handleQr() { - new IntentIntegrator(this).setCaptureActivity(QrActivity.class).initiateScan(); - } - @Override public void onCreateConversation(int chatId) { openConversation(chatId, -1); @@ -293,11 +304,6 @@ public class ConversationListActivity extends PassphraseRequiredActionBarActivit startActivity(intent); } - private void handleDisplaySettings() { - Intent preferencesIntent = new Intent(this, ApplicationPreferencesActivity.class); - startActivity(preferencesIntent); - } - @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); diff --git a/src/org/thoughtcrime/securesms/LocalHelpActivity.java b/src/org/thoughtcrime/securesms/LocalHelpActivity.java new file mode 100644 index 000000000..a62fc95c8 --- /dev/null +++ b/src/org/thoughtcrime/securesms/LocalHelpActivity.java @@ -0,0 +1,103 @@ +package org.thoughtcrime.securesms; + +import android.content.ActivityNotFoundException; +import android.content.Intent; +import android.net.Uri; +import android.os.Bundle; +import android.view.Menu; +import android.view.MenuInflater; +import android.view.MenuItem; +import android.webkit.WebView; +import android.webkit.WebViewClient; +import android.widget.Toast; + +import org.thoughtcrime.securesms.connect.ApplicationDcContext; +import org.thoughtcrime.securesms.connect.DcHelper; +import org.thoughtcrime.securesms.util.DynamicLanguage; +import org.thoughtcrime.securesms.util.DynamicTheme; + +public class LocalHelpActivity extends PassphraseRequiredActionBarActivity +{ + private WebView webView; + private final DynamicTheme dynamicTheme = new DynamicTheme(); + private final DynamicLanguage dynamicLanguage = new DynamicLanguage(); + + @Override + protected void onPreCreate() { + dynamicTheme.onCreate(this); + dynamicLanguage.onCreate(this); + } + + @Override + protected void onCreate(Bundle state, boolean ready) { + setContentView(R.layout.local_help_activity); + getSupportActionBar().setDisplayHomeAsUpEnabled(true); + getSupportActionBar().setTitle(getString(R.string.menu_help)); + + webView = findViewById(R.id.webview); + webView.setWebViewClient(new WebViewClient(){ + public boolean shouldOverrideUrlLoading(WebView view, String url) { + view.loadUrl(url); + return true; + } + }); + webView.loadUrl("file:///android_asset/help/en/help.html"); + } + + @Override + public void onResume() { + super.onResume(); + dynamicTheme.onResume(this); + dynamicLanguage.onResume(this); + } + + @Override + protected void onDestroy() { + super.onDestroy(); + } + + @Override + public boolean onPrepareOptionsMenu(Menu menu) { + MenuInflater inflater = this.getMenuInflater(); + menu.clear(); + + inflater.inflate(R.menu.local_help, menu); + super.onPrepareOptionsMenu(menu); + return true; + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) { + super.onOptionsItemSelected(item); + switch (item.getItemId()) { + case android.R.id.home: + finish(); + return true; + case R.id.learn_more: + openOnlineUrl("https://delta.chat"); + return true; + case R.id.contribute: + openOnlineUrl("https://github.com/deltachat/deltachat-android"); + return true; + case R.id.report_issue: + openOnlineUrl("https://github.com/deltachat/deltachat-android/issues"); + return true; + } + + return false; + } + + private void openOnlineUrl(String url) { + try { + startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(url))); + } catch (ActivityNotFoundException e) { + Toast.makeText(this, R.string.no_browser_installed, Toast.LENGTH_LONG).show(); + } + } + + @Override + public void onActivityResult(int reqCode, int resultCode, final Intent data) { + super.onActivityResult(reqCode, resultCode, data); + } + +}