Kaladaran/briar
0
0
Fork 0
mirror of https://code.briarproject.org/briar/briar.git synced 2026-02-11 18:29:05 +01:00
Code Issues Projects Releases Wiki Activity
Page: Mailbox Architecture
Pages
A Quick Overview of the Protocol Stack Adding support for new architectures in Tor Android Accessibility Android Power Management BDF BSP BTP Blog Client Blog Sharing Client Client API Notes Connect at a distance Create Account Design options for multi block messages Development schedule for private message deletion FAQ Field Guide Forum Client Forum Sharing Client Forums Fundamental Problems How Briar Connects to Contacts Introduction Client Mailbox Architecture Mailbox Properties Client Mailbox Scenarios Mailbox cannot reach Briar Messaging Client Navigate away from sharing screen Private Group Client Private Group Sharing Client Profile pictures Quick Start Guide RPC Notes Release Test Plan Roadmap Self destructing messages tests Software bill of materials for private message deletion Sponsor 1 Testing Translation Workflow Transport Key Agreement Client Transport Properties Client add already added contact at distance add contact after time out add contact at distance one contact offline add contact on biar received via hotspot add contact whilst pending contacts add nearby contact bluetooth off add nearby contact that was already added at distance add nearby contact then reconnect via BT add nearby contact twice app in background while do not kill me fragment displayed application lifecycle autostart mailbox on reboot when mailbox set up not completed yet autostart mailbox on reboot when mailbox set up blogs bluetooth setup screen briar connections opens from device view app settings briar in background during sharing briar mailbox test coverage briar mailbox tests executed cancel setup changelog code style comparative test several devices location and wifi settings connect multiple devices to hotspot connect with nearby contact create account on shared briar app delete and recreate contact at distance delete recreate nearby contact deny briar access to location many times deny briar access to location development 101 development workflow device offline warning devices tested disappearing messages sent to direct contacts download app scan QR code download type address manually error handling mailbox uploads feature workflow first install do not kill me fragment fresh install add contact distance reconnect via BT fresh install add nearby contact BT reconnect BT home import somebody elses messages install first time interrupt scanning qr code interrupt unlinking from briar side introductions multiple contacts disapp msgs on off invite multiple contacts to private group location off during contact creation mailbox in briar settings mailbox is running mailbox no internet mailbox not reachable mailbox notifications mailbox onboarding screens scan QR Code mailbox onboarding screens share link mailbox strings translations mailbox success screen mailbox system clock in the future mailbox system clock in the past mailbox test coverage mailbox wiping complete screen main activity reset everything to initial state make intro dis msgs on autodecline make introductions disappearing messages on intro accepted make introductions disappearing messages on intro declined by both make introductions disappearing messages on intro declined by one make introductions disappearing messages on make introductions disappearing messages onoff intro accepted make introductions disappearing messages onoff intro decl autodecl by both manually change battery optimisation setting to ON manually change battery optimisation setting to off message upload both x and y have mailboxes messages as expected no mailbox messages removable media mailbox messages uploaded Y knows x has mb messages uploaded to mailbox correctly mialbox not reachable nearby contact no mailbox autostart on reboot when QRcode scan canceled no mailbox autostart on reboot when mailbox stopped by user notes on testing notification mailbox unreachable disappears after tapping notification mailbox unreachable disappears when mailbox reachable notification mailbox unreachable disappears when mailbox unlinked notification mailbox unreachable onboarding UI open battery settings open hotspot manually open hotspot scan qr code permissions pre review checklist private group invitations messages product backlog re add deleted contact reconnect via BT reboot briar device after QR code scan receive messages during contact creation reconnect via BT when BT = OFF reconnect via BT when Briar BT OFF and device BT OFF device location OFF Briar no access to location reconnect via BT when Briar BT OFF and device BT OFF device location OFF reconnect via BT when Briar BT OFF and device BT OFF reconnect via BT reimport imported messages remove nearby devices permissions and start app reopen mailbox after device goes to sleep restart mailbox after wiping do not keep activities rotate screen whilst adding contact at distance scan incorrect qr code scan qr code scan valid QR code more than once self destructing messages share app briar access to location OFF share app device location OFF share app device wifi OFF share app offline share app wifi in briar OFF signed commits stop mailbox stop sharing after download stop sharing before download finished threat model time last connected tor build process tor port transfer blog posts transfer direct messages transfer forum posts transfer introductions transfer messages with images unlink from briar side mailbox already unlinked unlink from briar side mailbox offline unlink from briar side unlink mailbox side when briar offline unlink mailbox side when briar online unlink mailbox upload new contacts to mailbox user allows connections and rotates screen user allows connections user leaves setup
Clone
3
Mailbox Architecture
akwizgran edited this page 2021-06-04 13:24:58 +00:00
Table of Contents

Goals

  • Mailbox has a single owner
  • Owner manages mailbox's contact list
  • Owner and contacts connect to mailbox via Tor hidden service
  • Mailbox receives encrypted messages from contacts, stores them for collection by owner
  • Mailbox receives encrypted messages from owner, stores them for collection by contacts
  • Messages that have not been collected are eventually deleted
  • Mailbox runs on Android

Future goals (outside scope of Sponsor 6)

  • Owner connects to mailbox via internet, without Tor
  • Owner and contacts connect to mailbox via LAN (or hotspot provided by mailbox)
  • Mailbox runs on Linux, Windows and Mac
  • Mailbox sends push notifications to wake owner's main device when messages arrive
  • Mailbox-to-mailbox forwarding:
    • Alice uploads message to Alice's mailbox
    • Alice's mailbox forwards message to Bob's mailbox
    • Bob downloads message from Bob's mailbox

Non-goals

  • Owner's contacts can send messages to each other via the mailbox
  • Strangers can send or receive messages or files via the mailbox

Architecture

  • Mailbox doesn't implement any Bramble-specific protocols
  • Owner and contacts communicate with mailbox via HTTP
  • Owner and contacts authenticate themselves to mailbox using bearer tokens
  • Mailbox relies on Tor hidden service to authenticate itself to owner and contacts
  • Mailbox stores encrypted messages in filesystem
  • Mailbox stores contact list and message metadata in database
  • Database is not encrypted, allowing mailbox to start automatically after booting

Future architecture (outside scope of Sponsor 6)

  • HTTPS with self-signed cert for communicating over internet/LAN
  • Owner and contacts need to know mailbox's cert fingerprint
  • Owner and contacts need to be able to check fingerprint of received cert

RSS

  • On Android, mailbox can receive RSS feeds shared by other apps in the form of XML files
  • Mailbox stores these files for collection by owner