De desktop-ontvanger

Voordat je begint

Je hebt een Windows- of Linux-computer nodig die aan blijft staan terwijl je ontvangt. Voor business-aanmelding en de modus ter plaatse heb je het Business-abonnement nodig. De persoonlijke modus koppelt met de koppelingslink van je eigen telefoon en heeft geen account nodig.

Stappen

• Download het Windows-installatieprogramma (NSIS) of de Linux-AppImage of -deb van de downloadpagina en controleer de SHA-256-som die ernaast staat. De builds zijn voorlopig niet ondertekend, dus verwacht dat het besturingssysteem je één keer waarschuwt. In Windows meldt SmartScreen “Windows heeft uw pc beschermd”: klik op “Meer info” en daarna op “Toch uitvoeren”. Het installatieprogramma vraagt één keer om beheerdersrechten, installeert voor alle gebruikers van de computer en opent de firewall voor deze app op privé-, openbare en domeinnetwerken. In Ubuntu 24.04 start een AppImage pas als je hem uitvoert met --no-sandbox (./WhispShare-Ontvanger-…AppImage --no-sandbox), omdat Ubuntu 24.04 de sandbox beperkt die Chromium nodig heeft; het deb-pakket regelt dat voor je en start gewoon.
• Kies hoe deze computer ontvangt: business-aanmelding met een apparaatcode van 8 tekens die de eigenaar in zijn browser goedkeurt; persoonlijke modus („Koppelen met mijn telefoon”), gekoppeld met de koppelingslink van je eigen telefoon; of alleen ter plaatse, voor bezoekers op dit wifi-netwerk zonder internet. In de persoonlijke modus blijft de computer van je telefoon ontvangen terwijl er geen browser open is: open WhispShare op je telefoon en start een koppeling, stuur de koppelingslink naar deze computer (per e-mail of in een notitie aan jezelf), plak hem op het scherm „Mijn telefoon koppelen” (het menu in de taakbalk heeft hetzelfde item totdat iets is gekoppeld) en druk op „Koppelen met mijn telefoon”. Je telefoon en de computer moeten allebei online zijn terwijl een bestand wordt verzonden. Deze computer wacht als het andere uiteinde van een koppeling die je telefoon start; hij toont geen eigen QR-code.
• Kies de opslagmap. Elke sessie komt in een eigen map terecht, <save folder>/<year-month>/<link label, room name or "Direct">/<date and time> <sender name or "Visitor"> <last 4 characters of the session code>/, en elk bestand krijgt ernaast een sidecar-bestand, <file>.whispshare.json. Het sidecar-bestand legt de sessie vast, de naam en het apparaat van de afzender, de link en het label ervan, de bestandsnaam zoals verstuurd en zoals opgeslagen, de grootte, het type en de SHA-256 en, zodra de overdracht eindigt, de gecontroleerde segmenthashes. Teksten en kaarten die de afzender stuurt staan niet in het sidecar-bestand: de ontvanger bewaart ze in zijn dagelijkse log (received-<date>.jsonl in de opslagmap).
• Laat de ontvanger draaien: hij zit in het systeemvak en kan met de computer meestarten. Het systeemvakmenu zegt in woorden wat de ontvanger doet (ontvangt van je telefoon, ontvangt voor je bedrijf, gepauzeerd, offline, wacht op de inboxsleutel van de beheerder, nog niet gekoppeld) en biedt altijd Opslagmap wijzigen en Opslagmap openen aan; dezelfde twee knoppen staan onderaan het venster. De ontvanger volgt de taal van de computer (Engels, Arabisch, Duits, Spaans, Frans, Hebreeuws, Italiaans, Japans, Koreaans, Nederlands, Pools, Braziliaans Portugees, Roemeens, Turks of Chinees), en je kunt in het systeemvakmenu of in Instellingen een andere kiezen.
• Om wat in een kamer wordt gedeeld te verzamelen, gebruik je Meedoen aan een kamer: de ontvanger zit in de kamer om alleen te ontvangen en slaat op wat leden delen.
• Om deze computer niet meer te laten ontvangen, trek je de ontvanger in via de zakelijke instellingen, of kies je Dit apparaat ontkoppelen in Instellingen op de computer zelf. Bij het ontkoppelen wordt de plek van de ontvanger op de server vrijgegeven met het eigen apparaattoken; daarna worden het token, de koppeling, de kamers en de inboxsleutel van de computer verwijderd. Als de server niet bereikbaar is, is de computer toch ontkoppeld en zegt het venster dat de server de vrijgave niet heeft bevestigd: vraag een beheerder de ontvanger in de Business-console te verwijderen, anders blijft de plek meetellen.

Waar de sleutels worden bewaard

De identiteit van de ontvanger en de inbox-sleutel zijn versleuteld onder een sleutel die in de statusmap van de ontvanger staat. De desktop-app verzegelt die sleutel met de beveiligde opslag van het besturingssysteem (Windows Credential Manager via DPAPI, de macOS-sleutelhanger of de Linux-sleutelhanger via libsecret of KWallet). Die sleutel is via de sleutelopslag van het besturingssysteem gekoppeld aan deze computer en dit gebruikersaccount, dus een kopie van de statusmap, uit een back-up, een synchronisatieclient of een schijfkopie, brengt de sleutel niet mee. Over toont hoe de sleutels zijn opgeslagen. Op een Linux-computer zonder sleutelhanger blijft de sleutel in een beveiligd bestand (modus 0600) en Over zegt dat; installeer gnome-keyring of KWallet om hem te beschermen. Is de sleutelhanger direct na het inloggen nog vergrendeld, dan wacht de ontvanger daar ongeveer een halve minuut op. Kan hij de sleutels later niet openen (omdat de sleutelhanger of het account is gereset), dan biedt hij aan te stoppen of opnieuw te beginnen en opnieuw te koppelen; hij maakt nooit stilletjes nieuwe sleutels. De headless-ontvanger (whispshare-receiver) heeft geen sleutelopslag van het besturingssysteem, dus zijn statusmap (<map>/.whispshare/) is de sleutel: wie hem kopieert, kan lezen wat de ontvanger leest. Houd die map uit back-ups, synchronisatieclients en gedeelde schijven, en laat alleen het serviceaccount hem lezen (modus 0700). Om een ontvanger naar een andere machine te verhuizen, koppel je een nieuwe. whispshare-receiver --help zegt hetzelfde.

Wat de andere kant ziet

Een klant ziet het bedrijf als “ontvangt nu” zolang de ontvanger aan staat, belt aan met één verzoekkaart en stuurt pas live bestanden nadat een persoon of een apparaat in dienst bevestigt. De ontvanger zelf laat nooit iemand in een kamer en stuurt nooit een kamertoegang; hij slaat op, en dat is alles. “Ontvangen pauzeren” sluit de deurbel, de kamers en een persoonlijke koppeling tegelijk; overdrachten die al lopen worden afgemaakt en nieuwe aanbiedingen wachten tot je hervat.

Als er iets misgaat

Een ontvanger die uit staat, ontvangt niet: de linkpagina zegt dat, en alleen de ene verzoekkaart kan wachten. In on-sitemodus toont de browser van de gast een certificaatwaarschuwing voor het lokale adres; die waarschuwing is te verwachten op een netwerk zonder internet — zeg dat openlijk en laat de gast de kaart van de locatie zien, zodat die kan vergelijken. Loopt de opslagmap vol of verhuist die, kies dan een nieuwe map en ontvang opnieuw; een overdracht die groter is dan de vrije ruimte wordt geweigerd voordat hij begint. Als telefoons het on-siteadres niet kunnen bereiken, open dan het on-sitepaneel. Dat toont het netwerk waarop Windows de computer ziet en meldt het wanneer de firewallregel ontbreekt of dat netwerk niet dekt (“Openbare netwerken” aanvinken in de Windows-melding, of opnieuw installeren voor alle gebruikers). Heeft de computer meerdere adressen (wifi, een VPN, WSL of Docker), kies dan daar het wifi-adres voor de QR. Om een probleem te melden, open je Instellingen, dan Over en dan Diagnose kopiëren, en plak je de tekst in je bericht. Die bevat alleen versies, statussen en aantallen: geen bestandsnamen, sleutels of adressen. De ontvanger houdt ook een klein roterend logboek van hetzelfde soort bij, in de logmap van het besturingssysteem.

Limieten

De ontvanger verhoogt de groottelimiet voor live overdrachten: 2 GiB in persoonlijke modus, 20 GiB voor Away en 50 GiB voor Business, terwijl een browser op 2 GiB blijft en een iPhone op 1 GiB. De sjabloonlimieten gelden nog steeds voor een bevestigde sessie: documenten tot 10 bestanden en 50 MB, een bevestiging één bestand en 500 MB, tenzij de link eigen limieten instelt. De ontvanger controleert één keer per dag op een nieuwe versie en toont een banner; download en installeer die zelf vanaf de downloadpagina. De headless-ontvanger (whispshare-receiver) kan elk ontvangen bestand naar een lokale webhook posten. Gebruik dat alleen voor deze computer of je kantoornetwerk: de post noemt het opgeslagen pad, het bestand en de afzender. Stel een geheim in (--webhook-secret), dan draagt de post een HMAC-handtekening, en een mislukte post wordt drie keer opnieuw geprobeerd.

Gerelateerd

• Business: de gedeelde inbox
• Downloaden
• Delen zonder internet