From a1523e3f815a2eecca7cac484a6f82406ad85957 Mon Sep 17 00:00:00 2001 From: rollsicecream Date: Wed, 31 Jan 2024 11:13:40 +0000 Subject: [PATCH] Convert the Messengers page to HTML admonitions (#2383) Signed-off-by: Daniel Gray --- docs/real-time-communication.md | 187 +++++++++++++++++++------------- 1 file changed, 109 insertions(+), 78 deletions(-) diff --git a/docs/real-time-communication.md b/docs/real-time-communication.md index 780456ca..d9efc35f 100644 --- a/docs/real-time-communication.md +++ b/docs/real-time-communication.md @@ -16,28 +16,33 @@ These messengers are great for securing your sensitive communications. ### Signal -!!! recommendation +
- ![Signal logo](assets/img/messengers/signal.svg){ align=right } +![Signal logo](assets/img/messengers/signal.svg){ align=right } - **Signal** is a mobile app developed by Signal Messenger LLC. The app provides instant messaging, as well as voice and video calling. +**Signal** is a mobile app developed by Signal Messenger LLC. The app provides instant messaging, as well as voice and video calling. - All communications are E2EE. Contact lists are encrypted using your Signal PIN and the server does not have access to them. Personal profiles are also encrypted and only shared with contacts you chat with. +All communications are E2EE. Contact lists are encrypted using your Signal PIN and the server does not have access to them. Personal profiles are also encrypted and only shared with contacts you chat with. - [:octicons-home-16: Homepage](https://signal.org/){ .md-button .md-button--primary } - [:octicons-eye-16:](https://signal.org/legal/#privacy-policy){ .card-link title="Privacy Policy" } - [:octicons-info-16:](https://support.signal.org/hc/en-us){ .card-link title=Documentation} - [:octicons-code-16:](https://github.com/signalapp){ .card-link title="Source Code" } - [:octicons-heart-16:](https://signal.org/donate/){ .card-link title=Contribute } +[:octicons-home-16: Homepage](https://signal.org/){ .md-button .md-button--primary } +[:octicons-eye-16:](https://signal.org/legal/#privacy-policy){ .card-link title="Privacy Policy" } +[:octicons-info-16:](https://support.signal.org/hc/en-us){ .card-link title=Documentation} +[:octicons-code-16:](https://github.com/signalapp){ .card-link title="Source Code" } +[:octicons-heart-16:](https://signal.org/donate/){ .card-link title=Contribute } - ??? downloads +
+Downloads - - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=org.thoughtcrime.securesms) - - [:simple-appstore: App Store](https://apps.apple.com/app/id874139669) - - [:simple-android: Android](https://signal.org/android/apk/) - - [:simple-windows11: Windows](https://signal.org/download/windows) - - [:simple-apple: macOS](https://signal.org/download/macos) - - [:simple-linux: Linux](https://signal.org/download/linux) +- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=org.thoughtcrime.securesms) +- [:simple-appstore: App Store](https://apps.apple.com/app/id874139669) +- [:simple-android: Android](https://signal.org/android/apk/) +- [:simple-windows11: Windows](https://signal.org/download/windows) +- [:simple-apple: macOS](https://signal.org/download/macos) +- [:simple-linux: Linux](https://signal.org/download/linux) + +
+ +
Signal supports [private groups](https://signal.org/blog/signal-private-group-system/). The server has no record of your group memberships, group titles, group avatars, or group attributes. Signal has minimal metadata when [Sealed Sender](https://signal.org/blog/sealed-sender/) is enabled. The sender address is encrypted along with the message body, and only the recipient address is visible to the server. Sealed Sender is only enabled for people in your contacts list, but can be enabled for all recipients with the increased risk of receiving spam. Signal requires your phone number as a personal identifier. @@ -49,25 +54,30 @@ We have some additional tips on configuring and hardening your Signal installati ### SimpleX Chat -!!! recommendation +
- ![Simplex logo](assets/img/messengers/simplex.svg){ align=right } +![Simplex logo](assets/img/messengers/simplex.svg){ align=right } - **SimpleX** Chat is an instant messenger that is decentralized and doesn't depend on any unique identifiers such as phone numbers or usernames. Users of SimpleX Chat can scan a QR code or click an invite link to participate in group conversations. +**SimpleX** Chat is an instant messenger that is decentralized and doesn't depend on any unique identifiers such as phone numbers or usernames. Users of SimpleX Chat can scan a QR code or click an invite link to participate in group conversations. - [:octicons-home-16: Homepage](https://simplex.chat){ .md-button .md-button--primary } - [:octicons-eye-16:](https://github.com/simplex-chat/simplex-chat/blob/stable/PRIVACY.md){ .card-link title="Privacy Policy" } - [:octicons-info-16:](https://github.com/simplex-chat/simplex-chat/tree/stable/docs){ .card-link title=Documentation} - [:octicons-code-16:](https://github.com/simplex-chat){ .card-link title="Source Code" } +[:octicons-home-16: Homepage](https://simplex.chat){ .md-button .md-button--primary } +[:octicons-eye-16:](https://github.com/simplex-chat/simplex-chat/blob/stable/PRIVACY.md){ .card-link title="Privacy Policy" } +[:octicons-info-16:](https://github.com/simplex-chat/simplex-chat/tree/stable/docs){ .card-link title=Documentation} +[:octicons-code-16:](https://github.com/simplex-chat){ .card-link title="Source Code" } - ??? downloads +
+Downloads - - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=chat.simplex.app) - - [:simple-appstore: App Store](https://apps.apple.com/us/app/simplex-chat/id1605771084) - - [:simple-github: GitHub](https://github.com/simplex-chat/simplex-chat/releases) - - [:simple-windows11: Windows](https://simplex.chat/downloads/#desktop-app) - - [:simple-apple: macOS](https://simplex.chat/downloads/#desktop-app) - - [:simple-linux: Linux](https://simplex.chat/downloads/#desktop-app) +- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=chat.simplex.app) +- [:simple-appstore: App Store](https://apps.apple.com/us/app/simplex-chat/id1605771084) +- [:simple-github: GitHub](https://github.com/simplex-chat/simplex-chat/releases) +- [:simple-windows11: Windows](https://simplex.chat/downloads/#desktop-app) +- [:simple-apple: macOS](https://simplex.chat/downloads/#desktop-app) +- [:simple-linux: Linux](https://simplex.chat/downloads/#desktop-app) + +
+ +
SimpleX Chat [was audited](https://simplex.chat/blog/20221108-simplex-chat-v4.2-security-audit-new-website.html) by Trail of Bits in October 2022. @@ -75,24 +85,29 @@ SimpleX Chat supports basic group chatting functionality, direct messaging, and ### Briar -!!! recommendation +
- ![Briar logo](assets/img/messengers/briar.svg){ align=right } +![Briar logo](assets/img/messengers/briar.svg){ align=right } - **Briar** is an encrypted instant messenger that [connects](https://briarproject.org/how-it-works/) to other clients using the Tor Network. Briar can also connect via Wi-Fi or Bluetooth when in local proximity. Briar’s local mesh mode can be useful when internet availability is a problem. +**Briar** is an encrypted instant messenger that [connects](https://briarproject.org/how-it-works/) to other clients using the Tor Network. Briar can also connect via Wi-Fi or Bluetooth when in local proximity. Briar’s local mesh mode can be useful when internet availability is a problem. - [:octicons-home-16: Homepage](https://briarproject.org/){ .md-button .md-button--primary } - [:octicons-eye-16:](https://briarproject.org/privacy-policy/){ .card-link title="Privacy Policy" } - [:octicons-info-16:](https://code.briarproject.org/briar/briar/-/wikis/home){ .card-link title=Documentation} - [:octicons-code-16:](https://code.briarproject.org/briar/briar){ .card-link title="Source Code" } - [:octicons-heart-16:](https://briarproject.org/){ .card-link title="Donation options are listed on the bottom of the homepage" } +[:octicons-home-16: Homepage](https://briarproject.org/){ .md-button .md-button--primary } +[:octicons-eye-16:](https://briarproject.org/privacy-policy/){ .card-link title="Privacy Policy" } +[:octicons-info-16:](https://code.briarproject.org/briar/briar/-/wikis/home){ .card-link title=Documentation} +[:octicons-code-16:](https://code.briarproject.org/briar/briar){ .card-link title="Source Code" } +[:octicons-heart-16:](https://briarproject.org/){ .card-link title="Donation options are listed on the bottom of the homepage" } - ??? downloads +
+Downloads - - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=org.briarproject.briar.android) - - [:simple-windows11: Windows](https://briarproject.org/download-briar-desktop/) - - [:simple-linux: Linux](https://briarproject.org/download-briar-desktop/) - - [:simple-flathub: Flathub](https://flathub.org/apps/details/org.briarproject.Briar) +- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=org.briarproject.briar.android) +- [:simple-windows11: Windows](https://briarproject.org/download-briar-desktop/) +- [:simple-linux: Linux](https://briarproject.org/download-briar-desktop/) +- [:simple-flathub: Flathub](https://flathub.org/apps/details/org.briarproject.Briar) + +
+ +
To add a contact on Briar, you must both add each other first. You can either exchange `briar://` links or scan a contact’s QR code if they are nearby. @@ -104,34 +119,42 @@ Briar supports Forward Secrecy by using the Bramble [Handshake](https://code.bri ## Additional Options -!!! warning +
+

Warning

- These messengers do not have [Forward Secrecy](https://en.wikipedia.org/wiki/Forward_secrecy), and while they fulfill certain needs that our previous recommendations may not, we do not recommend them for long-term or sensitive communications. Any key compromise among message recipients would affect the confidentiality of **all** past communications. +These messengers do not have [Forward Secrecy](https://en.wikipedia.org/wiki/Forward_secrecy), and while they fulfill certain needs that our previous recommendations may not, we do not recommend them for long-term or sensitive communications. Any key compromise among message recipients would affect the confidentiality of **all** past communications. + +
### Element -!!! recommendation +
- ![Element logo](assets/img/messengers/element.svg){ align=right } +![Element logo](assets/img/messengers/element.svg){ align=right } - **Element** is the reference client for the [Matrix](https://matrix.org/docs/guides/introduction) protocol, an [open standard](https://matrix.org/docs/spec) for secure decentralized real-time communication. +**Element** is the reference client for the [Matrix](https://matrix.org/docs/guides/introduction) protocol, an [open standard](https://matrix.org/docs/spec) for secure decentralized real-time communication. - Messages and files shared in private rooms (those which require an invite) are by default E2EE as are one to one voice and video calls. +Messages and files shared in private rooms (those which require an invite) are by default E2EE as are one to one voice and video calls. - [:octicons-home-16: Homepage](https://element.io/){ .md-button .md-button--primary } - [:octicons-eye-16:](https://element.io/privacy){ .card-link title="Privacy Policy" } - [:octicons-info-16:](https://element.io/help){ .card-link title=Documentation} - [:octicons-code-16:](https://github.com/vector-im){ .card-link title="Source Code" } +[:octicons-home-16: Homepage](https://element.io/){ .md-button .md-button--primary } +[:octicons-eye-16:](https://element.io/privacy){ .card-link title="Privacy Policy" } +[:octicons-info-16:](https://element.io/help){ .card-link title=Documentation} +[:octicons-code-16:](https://github.com/vector-im){ .card-link title="Source Code" } - ??? downloads +
+Downloads - - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=im.vector.app) - - [:simple-appstore: App Store](https://apps.apple.com/app/vector/id1083446067) - - [:simple-github: GitHub](https://github.com/vector-im/element-android/releases) - - [:simple-windows11: Windows](https://element.io/get-started) - - [:simple-apple: macOS](https://element.io/get-started) - - [:simple-linux: Linux](https://element.io/get-started) - - [:octicons-globe-16: Web](https://app.element.io) +- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=im.vector.app) +- [:simple-appstore: App Store](https://apps.apple.com/app/vector/id1083446067) +- [:simple-github: GitHub](https://github.com/vector-im/element-android/releases) +- [:simple-windows11: Windows](https://element.io/get-started) +- [:simple-apple: macOS](https://element.io/get-started) +- [:simple-linux: Linux](https://element.io/get-started) +- [:octicons-globe-16: Web](https://app.element.io) + +
+ +
Profile pictures, reactions, and nicknames are not encrypted. @@ -143,27 +166,32 @@ The protocol was independently [audited](https://matrix.org/blog/2016/11/21/matr ### Session -!!! recommendation +
- ![Session logo](assets/img/messengers/session.svg){ align=right } +![Session logo](assets/img/messengers/session.svg){ align=right } - **Session** is a decentralized messenger with a focus on private, secure, and anonymous communications. Session offers support for direct messages, group chats, and voice calls. +**Session** is a decentralized messenger with a focus on private, secure, and anonymous communications. Session offers support for direct messages, group chats, and voice calls. - Session uses the decentralized [Oxen Service Node Network](https://oxen.io/) to store and route messages. Every encrypted message is routed through three nodes in the Oxen Service Node Network, making it virtually impossible for the nodes to compile meaningful information on those using the network. +Session uses the decentralized [Oxen Service Node Network](https://oxen.io/) to store and route messages. Every encrypted message is routed through three nodes in the Oxen Service Node Network, making it virtually impossible for the nodes to compile meaningful information on those using the network. - [:octicons-home-16: Homepage](https://getsession.org/){ .md-button .md-button--primary } - [:octicons-eye-16:](https://getsession.org/privacy-policy){ .card-link title="Privacy Policy" } - [:octicons-info-16:](https://getsession.org/faq){ .card-link title=Documentation} - [:octicons-code-16:](https://github.com/oxen-io){ .card-link title="Source Code" } +[:octicons-home-16: Homepage](https://getsession.org/){ .md-button .md-button--primary } +[:octicons-eye-16:](https://getsession.org/privacy-policy){ .card-link title="Privacy Policy" } +[:octicons-info-16:](https://getsession.org/faq){ .card-link title=Documentation} +[:octicons-code-16:](https://github.com/oxen-io){ .card-link title="Source Code" } - ??? downloads +
+Downloads - - [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=network.loki.messenger) - - [:simple-appstore: App Store](https://apps.apple.com/app/id1470168868) - - [:simple-github: GitHub](https://github.com/oxen-io/session-android/releases) - - [:simple-windows11: Windows](https://getsession.org/download) - - [:simple-apple: macOS](https://getsession.org/download) - - [:simple-linux: Linux](https://getsession.org/download) +- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=network.loki.messenger) +- [:simple-appstore: App Store](https://apps.apple.com/app/id1470168868) +- [:simple-github: GitHub](https://github.com/oxen-io/session-android/releases) +- [:simple-windows11: Windows](https://getsession.org/download) +- [:simple-apple: macOS](https://getsession.org/download) +- [:simple-linux: Linux](https://getsession.org/download) + +
+ +
Session allows for E2EE in one-on-one chats or closed groups which allow for up to 100 members. Open groups have no restriction on the number of members, but are open by design. @@ -177,9 +205,12 @@ Session has a [whitepaper](https://arxiv.org/pdf/2002.04609.pdf) describing the **Please note we are not affiliated with any of the projects we recommend.** In addition to [our standard criteria](about/criteria.md), we have developed a clear set of requirements to allow us to provide objective recommendations. We suggest you familiarize yourself with this list before choosing to use a project, and conduct your own research to ensure it's the right choice for you. -!!! example "This section is new" +
+

This section is new

- We are working on establishing defined criteria for every section of our site, and this may be subject to change. If you have any questions about our criteria, please [ask on our forum](https://discuss.privacyguides.net/latest) and don't assume we didn't consider something when making our recommendations if it is not listed here. There are many factors considered and discussed when we recommend a project, and documenting every single one is a work-in-progress. +We are working on establishing defined criteria for every section of our site, and this may be subject to change. If you have any questions about our criteria, please [ask on our forum](https://discuss.privacyguides.net/latest) and don't assume we didn't consider something when making our recommendations if it is not listed here. There are many factors considered and discussed when we recommend a project, and documenting every single one is a work-in-progress. + +
- Must have open-source clients. - Must use E2EE for private messages by default.