SecureBitChat/securebit-chat
1
0
Fork 0
Code Issues Pull Requests Actions 21 Packages Projects Releases Wiki Activity

docs: describe the minimal invitation and where its security comes from
CodeQL Analysis / Analyze CodeQL (push) Waiting to run
Details
Deploy Application / deploy (push) Waiting to run
Details
Mirror to Codeberg / mirror (push) Waiting to run
Details
Mirror to PrivacyGuides / mirror (push) Waiting to run
Details

Browse Source 
The README, ARCHITECTURE.md and CRYPTOGRAPHY.md still described the old
handshake: keys and a session salt travelling inside the invitation, and a safety
code derived from the two DTLS fingerprints. None of that has been true since
5.9.0.

Adds a "The invitation" section to the README covering what the exchange was
reduced to and why that is a security change and not only a smaller QR code:
less material exposed before anyone is authenticated, the DTLS fingerprint as the
anchor, substituted keys failing closed on the commitment instead of on a human
comparison, a safety code that now covers the whole transcript rather than two
fingerprints, and the plain fact that a single QR is scanned in person where a
four-frame animated one pushes people to paste the invitation through a chat app.

Session lifecycle in ARCHITECTURE.md gains the in-band key exchange as its own
step. CRYPTOGRAPHY.md now states that the salt is derived from the transcript
rather than transmitted, and describes the transcript SAS and the signature that
replaced the challenge/response. DESCRIPTOR-SBQ2.md is listed in the doc index
and in the CONTRIBUTING impact table.
This commit is contained in:
lockbitchat
2026-08-06 18:53:51 -04:00
parent 7754f6ba15
commit e3e10656d7
8 changed files with 157 additions and 62 deletions
Download Patch File Download Diff File Expand all files Collapse all files
index.html
+22 -22
View File
@@ -24,7 +24,7 @@
<!-- PWA Manifest -->
<link rel="manifest" href="./manifest.json">
<link rel="icon" type="image/x-icon" href="./logo/favicon.ico?v=1786054741114">
<link rel="icon" type="image/x-icon" href="./logo/favicon.ico?v=1786056807121">
<!-- PWA Meta Tags -->
<meta name="mobile-web-app-capable" content="yes">
@@ -90,7 +90,7 @@
<link rel="apple-touch-startup-image" media="screen and (device-width: 744px) and (device-height: 1133px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="./logo/splash/splash_screens/8.3__iPad_Mini_portrait.png">
<!-- Apple Touch Icons -->
<link rel="apple-touch-icon" href="./logo/icon-180x180.png?v=1786054741114">
<link rel="apple-touch-icon" href="./logo/icon-180x180.png?v=1786056807121">
<link rel="apple-touch-icon" sizes="57x57" href="./logo/icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="./logo/icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="./logo/icon-72x72.png">
@@ -99,7 +99,7 @@
<link rel="apple-touch-icon" sizes="120x120" href="./logo/icon-120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="./logo/icon-144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="./logo/icon-152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="./logo/icon-180x180.png?v=1786054741114">
<link rel="apple-touch-icon" sizes="180x180" href="./logo/icon-180x180.png?v=1786056807121">
<!-- Microsoft Tiles -->
<meta name="msapplication-TileColor" content="#ff6b35">
@@ -183,7 +183,7 @@
<!-- Render-blocking JS is deferred: classic deferred scripts and module scripts
both execute in document order after parsing, so React still runs before the
app modules below, but the parser / first paint is no longer blocked. -->
<script defer src="config/ice-servers.js?v=1786054741114"></script>
<script defer src="config/ice-servers.js?v=1786056807121"></script>
<script defer src="libs/react/react.production.min.js"></script>
<script defer src="libs/react-dom/react-dom.production.min.js"></script>
<!-- Prism syntax highlighting (vendored, offline). Tokenizes code as TEXT only —
@@ -191,8 +191,8 @@
Its CSS is loaded async via load-async-css.js (not paint-critical). -->
<script defer src="libs/prism/prism.js"></script>
<!-- Critical, paint-defining CSS stays render-blocking (avoids FOUC / layout shift). -->
<link rel="stylesheet" href="assets/tailwind.css?v=1786054741114">
<link rel="icon" type="image/x-icon" href="/logo/favicon.ico?v=1786054741114">
<link rel="stylesheet" href="assets/tailwind.css?v=1786056807121">
<link rel="icon" type="image/x-icon" href="/logo/favicon.ico?v=1786056807121">
<!-- Preload only the fonts needed for first paint. fa-solid covers the bulk of UI
icons; fa-regular/fa-brands are loaded on demand by their CSS (rarely on the
first screen). Inter latin 400/700 cover body text and headings/buttons. -->
@@ -200,31 +200,31 @@
<link rel="preload" href="/assets/fonts/inter/files/inter-latin-400.woff2" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="/assets/fonts/inter/files/inter-latin-700.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" href="/assets/fonts/inter/inter.css">
<link rel="stylesheet" href="src/styles/main.css?v=1786054741114">
<link rel="stylesheet" href="src/styles/animations.css?v=1786054741114">
<link rel="stylesheet" href="src/styles/components.css?v=1786054741114">
<link rel="stylesheet" href="src/styles/main.css?v=1786056807121">
<link rel="stylesheet" href="src/styles/animations.css?v=1786056807121">
<link rel="stylesheet" href="src/styles/components.css?v=1786056807121">
<!-- Non-critical CSS (FontAwesome ~102KB, Prism) loaded async — no longer blocks paint. -->
<script defer src="src/scripts/load-async-css.js?v=1786054741114"></script>
<script defer src="src/scripts/load-async-css.js?v=1786056807121"></script>
<noscript>
<link rel="stylesheet" href="/assets/fontawesome/css/all.min.css">
<link rel="stylesheet" href="libs/prism/prism.css">
</noscript>
<script defer src="src/scripts/fa-check.js?v=1786054741114"></script>
<script defer src="src/scripts/fa-check.js?v=1786056807121"></script>
<!-- Update Manager - система принудительного обновления -->
<script defer src="src/utils/updateManager.js?v=1786054741114"></script>
<script type="module" src="src/components/UpdateChecker.jsx?v=1786054741114"></script>
<script type="module" src="dist/qr-local.js?v=1786054741114"></script>
<script type="module" src="src/components/QRScanner.js?v=1786054741114"></script>
<script defer src="src/utils/updateManager.js?v=1786056807121"></script>
<script type="module" src="src/components/UpdateChecker.jsx?v=1786056807121"></script>
<script type="module" src="dist/qr-local.js?v=1786056807121"></script>
<script type="module" src="src/components/QRScanner.js?v=1786056807121"></script>
</head>
<body>
<div id="root"></div>
<script type="module" src="dist/app-boot.js?v=1786054741114"></script>
<script type="module" src="dist/app.js?v=1786054741114"></script>
<script type="module" src="dist/app-boot.js?v=1786056807121"></script>
<script type="module" src="dist/app.js?v=1786056807121"></script>
<script defer src="src/scripts/pwa-register.js?v=1786054741114"></script>
<script src="./src/pwa/install-prompt.js?v=1786054741114" type="module"></script>
<script src="./src/pwa/pwa-manager.js?v=1786054741114" type="module"></script>
<script defer src="./src/scripts/pwa-offline-test.js?v=1786054741114"></script>
<link rel="stylesheet" href="./src/styles/pwa.css?v=1786054741114">
<script defer src="src/scripts/pwa-register.js?v=1786056807121"></script>
<script src="./src/pwa/install-prompt.js?v=1786056807121" type="module"></script>
<script src="./src/pwa/pwa-manager.js?v=1786056807121" type="module"></script>
<script defer src="./src/scripts/pwa-offline-test.js?v=1786056807121"></script>
<link rel="stylesheet" href="./src/styles/pwa.css?v=1786056807121">
</body>
</html>