ID.nl logo
Windows-wachtwoord vergeten? Dit kun je doen
© Reshift Digital
Huis

Windows-wachtwoord vergeten? Dit kun je doen

Het zal je maar gebeuren. Je hebt Windows op een tweede pc geïnstalleerd, een tijdlang niet meer gebruikt en nu ben je je Windows 10- of Windows 11-wachtwoord vergeten. Op zich niet onoverkomelijk, maar het wordt spannender als het om je enige administrator-account gaat. Gelukkig zijn er ook dan nog mogelijkheden. We gaan eens kijken hoe we dit probleem kunnen oplossen.

Een degelijke wachtwoordbeheerder, zoals LastPass, DashLane of KeePass X, is al een goed hulpmiddel. Hiermee onthoud je eenvoudig alle wachtwoorden voor onder meer Windows, wifi en allerlei onlinediensten en -applicaties. Veel gebruikers vinden zo’n tool helaas gecompliceerd of houden er niet van dat wachtwoorden online worden bijgehouden. Zij blijven daarom een beroep doen op hun eigen geheugen. Tot dat dat hen plotseling in de steek laat. In dit artikel beschrijven we hoe je in verschillende scenario’s zo’n pijnlijk moment kunt overleven.

Windows-accounts

Er zijn in principe twee types Windows-accounts. De eerste is het lokale account dat aan de pc is gekoppeld en dat normaal gesproken alleen op deze computer wordt bewaard. De tweede is een Microsoft-account. Dat bestaat uit een e-mailadres en een wachtwoord, zoals dat bij veel andere diensten het geval is. Het grootste voordeel is dat je je hiermee op meerdere pc’s kunt aanmelden en dat een en ander via de cloud automatisch wordt gesynchroniseerd.

Om te weten te komen met welk accounttype je bij Windows bent aangemeld, open je in Windows 10 de Instellingen en kies je  Accounts uw info. Hier vind je verder een optie om over te schakelen naar een ander accounttype: via In plaats daarvan aanmelden met een lokaal / Microsoft account. Vanuit dit venster kun je nieuwe accounts creëren of bij een Microsoft-account via Uw instellingen synchroniseren bepalen welke onderdelen je over je verschillende toestellen synchroon wilt houden.

Ook als je Windows 11 gebruikt ga je naar de Instellingen-app, maar klik je daarna op Accounts en daarna op Uw info. Onder Accountinstellingen kun je vervolgens net als in Windows 10 overschakelen naar een ander accounttype. 

©PXimport

Microsoft-account

Ben je je wachtwoord vergeten, dan maakt het accounttype dus uit. Laten we van een Microsoft-account uitgaan. Je gaat hiervoor naar https://account.live.com/password/reset. Vul hier je e-mailadres in en klik op Volgende. Afhankelijk van de gegevens die je eerder aan dit account hebt gekoppeld, verschijnt er een ander venster. Je kunt bijvoorbeeld aangeven hoe je een beveiligingscode ter verificatie wilt ontvangen, bijvoorbeeld via e-mail, sms of telefonisch bericht. Op die manier kun je een nieuw wachtwoord instellen.

De andere optie is dat je kiest voor Ik heb geen van deze gegevens. Nu vul je het e-mailadres in waarop je op dit moment bereikbaar bent. Na het invullen van de captcha druk je op Volgende. Even later ontvang je op dit adres een code die je in het venster intikt.

Druk op Bevestigen en beantwoord enkele vragen. Het kan even duren voordat Microsoft je een geautomatiseerde mail stuurt. Hierin staat of je voldoende informatie hebt ingevuld om je account via een ander wachtwoord weer toegankelijk te maken.

©PXimport

Wachtwoordherstelschijf

Het wachtwoord terughalen van een lokaal account is meestal lastiger. Het handigst is het als je vooraf een zogeheten wachtwoordherstelschijf hebt aangemaakt. Dat doe je als volgt. Meld je met een lokaal account aan, stop een usb-stick in je pc, druk op de Windows-toets, tik Configuratie in en start de app Configuratiescherm op.

Klik vervolgens twee keer na elkaar op Gebruikersaccounts en kies of zoek op Een wachtwoordherstelschijf maken. De wizard Vergeten wachtwoord start op. Druk op Volgende, verwijs naar je usb-stick en druk op Volgende. Vul je huidige wachtwoord in, druk nogmaals op Volgende (2x) en rond af met Voltooien.

Mocht je later je wachtwoord kwijtraken, laat dan het wachtwoord in het Windows-aanmeldvenster dan leeg en druk op de pijlknop achter het wachtwoordveld. Bevestig met OK en kies Wachtwoord opnieuw instellen. Scrol naar In plaats daarvan een wachtwoordherstelschijf gebruiken, zodat de wizard Wachtwoord opnieuw instellen verschijnt.

Stop de usb-stick met het wachtwoord in je pc en klik op Volgende. Verwijs naar de usb-stick, druk op Volgende, vul een nieuw wachtwoord in (2x) en geef een geheugensteuntje op. Dat laatste krijg je te zien wanneer je bij een volgende aanmelding een fout of leeg wachtwoord invult. Rond af met Volgende en met Voltooien.

©PXimport

Beveiligingsvragen

Het kan natuurlijk nog erger: je beschikt niet over een wachtwoordherstelschijf en ook de geheugensteun bezorgt je geen aha-moment. Dan is er nog steeds hoop. Als je werkt met Windows 10 1803 of hoger, dan heb je bij het aanmaken van je account een aantal veiligheidsvragen beantwoord. Denk aan vragen over hoe je huisdier heet en wat je bijnaam als kind was.

Klik bij het aanmelden een verkeerd of leeg wachtwoord in. Klik vervolgens op Wachtwoord opnieuw instellen en na het correct beantwoorden van drie vragen kunt alsnog een nieuw wachtwoord voor je account opgeven.

Je kunt deze beveiligingsvragen overigens op elk moment aanpassen via Instellingen, Accounts, Aanmeldingsopties. Hier klik je op Wachtwoord en op Beveiligingsvragen bijwerken. Nadat je er drie hebt geselecteerd en beantwoord, bevestig je met Voltooien.

©PXimport

Aanmeldingsopties

Naast een klassiek wachtwoord werk je in Windows 10 of Windows 11 het liefst ook nog met andere aanmeldopties. Denk aan een pincode, een afbeeldingswachtwoord, biometrische verificatie, zoals een gezicht of een vingerafdruk, of een fysieke beveiligingssleutel.

Gebruik je inderdaad een of meerdere van deze extra opties, dan kun je in het aanmeldingsvenster op Aanmeldingsopties klikken. Je kunt dan via een van de ingestelde opties alsnog aanmelden. Is je aanmelding gelukt, dan kun je als administrator het vergeten wachtwoord alsnog wijzigen. Je kunt een of meerdere van deze opties, voor zover beschikbaar op je apparaat, op elk moment toevoegen via Instellingen, Accounts, Aanmeldingsopties.

©PXimport

Extra administrator

Helpen geen van de bovenvermelde methodes je vooruit, dan is er nog een laatste handige uitweg. Tenminste wanneer je (of een andere gebruiker) zich nog met een ander administrator-account kunt aanmelden. Wanneer je namelijk als administrator bent ingelogd, dan kun je eenvoudig het wachtwoord wijzigen van een andere gebruiker.

Open het Configuratiescherm, klik op Gebruikersaccounts (2x) en kies Een ander account beheren. Selecteer het betreffende account, kies Het wachtwoord wijzigen en geef een nieuw wachtwoord op (2x), en ook een geheugensteun. Of open het Windows-startmenu, klik met rechts op Opdrachtprompt en kies Als administrator uitvoeren. Geef daarna het volgende commando: net user <accountnaam> <nieuw_wachtwoord> . Dat wordt dus zoiets: net user ComputerTotaal !Geheim123.

©PXimport

Wisseltruc met bootstick

Helaas, het zit je echt niet mee. Je bent je wachtwoord vergeten, je beschikt niet over een wachtwoordherstelschijf en over extra aanmeldingsopties. Je hebt geen (antwoorden op de) beveiligingsvragen en er is geen tweede administratoraccount. Gelukkig is er zelfs in dit extreme geval nog een uitweg.

Wel zit er weinig anders op dan je pc van een live bootmedium op te starten. Dat kan een Linux-distributie zijn, zoals Linux Mint of Ubuntu, maar het kan ook met een Windows-installatiestick. Laten we van deze laatste uitgaan.

Start je pc op van de usb-stick. Vul taal, land en toetsenbord in, druk op Volgende en kies Uw computer herstellen, Problemen oplossenGeavanceerde opties), Opdrachtprompt. Hier geef je de volgende twee opdrachten: cd a:\windows\system32 a:. Vervang a: telkens door de juiste letter van het station met je Windows-installatie (in ons voorbeeld d:). Als dit goed zit, geef je daarna ook de volgende twee commando’s rename utilman.exe utilman.bak en copy cmd.exe utilman.exe.

Herstart nu je pc. We gaan er wel vanuit dat je met Windows 10 1809 of nieuwer werkt. In het aanmeldvenster merk je rechtsonder de knop Toegankelijkheid op. Wanneer je die aanklikt, start niet de verwachte tool (utilman.exe) op, maar duikt een opdrachtvenster (cmd.exe) op met volledige administratorrechten. Inderdaad, daar heeft onze wisseltruc mooi voor gezorgd.

Op de opdrachtprompt geef je vervolgens net user op. Die toont je een lijst met gebruikersaccounts. Je hoeft nu alleen nog maar het wachtwoord van de vergeetachtige gebruiker te wijzigen met het al eerder vermelde commando: net user <accountnaam> <nieuw_wachtwoord>.

©PXimport

Media Creation Tool

Om een Windows installatiestick te creëren surf je naar hiernaartoe. Hier klik je op Hulpprogramma nu downloaden. Start de applicatie en kies Installatiemedia (usb-stick, dvd of iso-bestand) voor een andere pc maken. Klik op Volgende en verwijder eventueel het vinkje bij Gebruik de aanbevolen opties voor deze pc als je zelf Taal, Versie en Architectuur wilt instellen. Plug een (lege) usb-stick in je pc en druk op Volgende. Kies Usb-flashstation, duid de juiste stick aan en bevestig met Volgende. Na afloop is je stick startklaar.

©PXimport

Hiren’s BootCD PE

Wil je de wisseltruc in dit artikel liever niet gebruiken, dan kun je het nog proberen met een reddingsstick, zoals Hiren’s BootCD PE. Download het beeldbestand HBCD_PE_x64.iso en zet dit met je favoriete tool om naar een bootstick. Wij doen dat graag met het gratis, portable Ventoy. Stop de stick in je pc, start Ventoy, verwijs naar de stick en druk op Install. Vervolgens hoef je het gedownloade iso-bestand maar naar de stick te kopiëren, in de partitie met de naam Ventoy. Start je pc vervolgens van deze stick op. Als het goed is, dan start een wat uitgeklede Windows 10-omgeving op. Open het startmenu, ga naar All programs, Security, Passwords en kies NT Password Edit. Bij Path to SAM verwijs je naar de map **Windows\System32\Config** op je Windows-partitie. Open hier het sam-bestand en selecteer het gewenste account. Klik op Change password, laat New Password en Verify leeg en bevestig met OK, Save changes en Exit. Je kunt zich nu met dat account wachtwoordloos aanmelden bij Windows. Je maakt natuurlijk alleen in noodgevallen gebruik van deze procedure.

©PXimport

▼ Volgende artikel
Windows 11 wordt veiliger: dit ga je merken van de nieuwe beveiligingsregels
© ID.nl | Dit is een mock-up
Huis

Windows 11 wordt veiliger: dit ga je merken van de nieuwe beveiligingsregels

Microsoft heeft een flinke aanscherping van de beveiliging in Windows 11 aangekondigd. Onder de noemer Windows Baseline Security Mode en User Transparency and Consent krijgen gebruikers meer grip op wat apps precies uitspoken op hun computer. Voor de gemiddelde thuisgebruiker betekent dit vooral dat Windows meer gaat lijken op de overzichtelijke beveiliging die we al kennen van onze smartphones.

In dit artikel

Je leest wat de nieuwe beveiligingsregels in Windows 11 betekenen voor jou, met extra nadruk op toestemming en inzicht in wat apps doen. Je ziet hoe je per app toegang tot camera, microfoon en bestanden kunt beheren en later weer intrekken. Ook leggen we uit wat Windows Baseline Security Mode doet en wat je daarvan merkt tijdens de gefaseerde uitrol.

Lees ook: De verborgen parels van Windows 11: deze apps moet je hebben

De aanleiding voor deze verandering is de toenemende irritatie over apps die ongevraagd instellingen aanpassen, extra software installeren of zonder duidelijke toestemming toegang krijgen tot persoonlijke gegevens. Microsoft wil met deze update de regie teruggeven aan de gebruiker, waarbij transparantie en toestemming de belangrijkste uitgangspunten zijn.

Meer grip op je privacy

Een van de meest zichtbare veranderingen is de manier waarop apps om toestemming vragen. Waar programma's in Windows voorheen vaak automatisch toegang hadden tot bepaalde mappen of functies, gaat Windows 11 nu actiever om bevestiging vragen. Wil een app je camera, microfoon of specifieke bestanden gebruiken? Dan verschijnt er een duidelijke melding in beeld, vergelijkbaar met de pop-ups op een iPhone of Android-toestel.

Het mooie van dit systeem is dat je deze keuzes altijd weer kunt terugdraaien. In de instellingen van Windows komt een overzicht waar je precies ziet welke app waarvoor toestemming heeft. Vertrouw je een programma niet langer, dan trek je met één handeling de toegang tot je bestanden of hardware weer in.

©Garun Studios - stock.adobe.com

Alleen veilige software door Baseline Security

Verder introduceert Microsoft de Windows Baseline Security Mode. Dit is een technische beveiligingslaag die ervoor zorgt dat het systeem continu controleert of de software die draait wel integer is. In de praktijk betekent dit dat Windows alleen nog apps, stuurprogramma's en diensten toestaat die officieel zijn ondertekend en als veilig bekendstaan.

Dit voorkomt dat schadelijke software op de achtergrond wijzigingen aanbrengt in je systeem zonder dat je het doorhebt. Voor de meeste mensen verandert er weinig in het dagelijks gebruik; bekende software van grote ontwikkelaars blijft gewoon werken. Mocht je toch een specifiek programma willen gebruiken dat niet aan de strengste eisen voldoet, dan behoud je als gebruiker (of systeembeheerder) de mogelijkheid om handmatig een uitzondering te maken.

Wat merk je in de praktijk?

De uitrol van deze functies gebeurt stap voor stap. Microsoft neemt hier de tijd voor, zodat alles goed blijft werken op de miljarden computers waar Windows op draait. Om dit soepel te laten verlopen, zijn ze op dit moment vooral in overleg met bekende softwaremakers zoals Adobe en 1Password. Zo weet je zeker dat hun programma's gewoon blijven werken onder de nieuwe regels, nog voordat jij de update krijgt. Ook voor de opkomst van slimme AI-hulpjes zijn deze aanpassingen belangrijk. Omdat deze assistenten steeds vaker zelfstandig klusjes voor je opknappen, is het fijn dat je precies kunt zien en bepalen wat zo'n hulpje wel en niet mag doen op jouw pc. 

Kortom: Windows 11 wordt een stukje strenger, maar daardoor ook een stuk transparanter. Je zult iets vaker een vraag krijgen of een app ergens bij mag, maar je krijgt daar een veiliger gevoel en meer controle voor terug.

▼ Volgende artikel
Pushnotificaties vanaf je thuisserver: zo werkt ntfy
© ID.nl
Huis

Pushnotificaties vanaf je thuisserver: zo werkt ntfy

Als je services op je eigen thuisserver draait, wil je daar ook eenvoudig meldingen van kunnen ontvangen. Ntfy stelt je in staat om eenvoudig pushnotificaties naar je telefoon of computer te sturen. Bovendien kun je ntfy op je eigen thuisserver draaien, zodat je alles in eigen handen hebt. In dit artikel gaan we ermee aan de slag.

Dit gaan we doen

In dit artikel zetten we een ntfy-server op die je zelf beheert. We regelen eerst de randvoorwaarden: hoe je server van buitenaf bereikbaar wordt (bijvoorbeeld via vpn of portforwarding) en hoe je https netjes afhandelt met een reverse proxy en een certificaat van Let's Encrypt. Daarna bouwen we de basis: configuratiebestand, opslagmappen en een draaiende container met Docker.

Vervolgens maken we gebruikers en rechten aan, zodat niet iedereen zomaar kan publiceren of meelezen. Je test met de webinterface en met de mobiele app, zodat je zeker weet dat meldingen ook echt binnenkomen. Tot slot koppel je ntfy aan je eigen tools: eerst met een simpele curl-oproep vanuit een shellscript, daarna met extra's zoals titel, prioriteit en tags. Als je wilt, breid je dat uit naar meldingen met bijlagen, acties (doorklikken naar een url) en integratie vanuit Python. 

Lees ook: Je oude Windows-pc als thuisserver: zo zet je Jellyfin en Syncthing op

Netwerkmonitoringsoftware, een programma dat je Docker-containers bijwerkt, een smarthomecontroller, back-upsoftware, ze hebben allemaal één ding gemeen: ze moeten je meldingen kunnen sturen als er iets gebeurt. Dat kan op verschillende manieren: via e-mail, instant messaging of pushnotificaties naar je telefoon. Dat laatste verloopt doorgaans via een gecentraliseerde dienst zoals Firebase Cloud Messaging (voorheen Google Cloud Messaging) of Apple Push Notification service.

Pushnotificaties zijn handig omdat ze bijna onmiddellijk aankomen en omdat zowel Android als iOS toestaan om in te stellen hoe je ervan op de hoogte wordt gebracht. Wil je pushnotificaties kunnen ontvangen zonder een server onder controle van een partij zoals Google of Apple, dan moet je ook hiervoor je eigen service installeren. Een opensource-project dat dit implementeert, is ntfy.

Werking van ntfy

Je ntfy-server ontvangt meldingen van je programma's via http over een REST-API en zet deze om in pushnotificaties voor de bijbehorende Android- of iOS-app of voor een webpagina op je computer. De API is in de documentatie van het project beschreven, zodat je ook je eigen software met ntfy kunt laten praten. Het project heeft ook een command-line-interface, zodat je bijvoorbeeld shellscripts op je Linux-server eenvoudig pushnotificaties kunt laten verzenden.

Ntfy gebruikt het bekende publish/subscribe-patroon. Een zender publiceert notificaties op een specifiek onderwerp door data te sturen naar een url via een http POST- of PUT-aanvraag. Het onderwerp wordt gedefinieerd door een segment van de url dat volgt op de domeinnaam. Een ontvanger kan zich dan abonneren op dit onderwerp. Elke keer dat de zender daarna een notificatie op dit onderwerp publiceert, stuurt ntfy de data naar alle ontvangers die zich op dit onderwerp hebben geabonneerd. Door ntfy op je eigen server te installeren, heb je de volledige controle over deze notificaties.

Met ntfy kun je services pushnotificaties laten verzenden naar je telefoon of computer.

Serververeisten

De mobiele app van ntfy moet met je server kunnen communiceren om te vragen of er notificaties zijn. Als je ntfy op een server in je lokale netwerk installeert, moet die dus van buitenaf bereikbaar zijn. Dat kun je met portforwarding in je modem regelen of door je telefoon buitenshuis automatisch met een VPN-server op je lokale netwerk te laten verbinden. Heeft je internetaansluiting thuis geen vast ip-adres, dan moet je ook een DynDNS-updater te draaien.

Een andere optie is om ntfy op een VPS (Virtual Private Server) te installeren. Hierop draai je dan ook een reverse proxy voor https-toegang, die een TLS-certificaat van Let's Encrypt opvraagt. Je hebt dan een domein nodig, waarvoor je een DNS A-record naar het ip-adres van je server laat verwijzen. In de rest van dit artikel gaan we uit van een installatie van ntfy op een lokale server met Debian 13 ("trixie") met behulp van Docker Compose.

Basisconfiguratie

Creëer eerst enkele directory's voor ntfy:

$ mkdir -p containers/ntfy/{cache,etc,lib}

Creëer dan het bestand containers/ntfy/etc/server.yml met de volgende configuratie voor ntfy:

base-url: "https://ntfy.example.com"

cache-file: "/var/cache/ntfy/cache.db"

attachment-cache-dir: "/var/cache/ntfy/attachments"

auth-file: "/var/lib/ntfy/user.db"

auth-default-access: "deny-all"

Vervang het domein achter base-url door het domein waarop je ntfy-server draait. Als je gebruikmaakt van een reverse proxy, dan moet dit de url zijn die door de proxy naar ntfy wordt doorgestuurd. Bovendien moet je dan ook een regel behind-proxy: true toevoegen. In de documentatie van ntfy staan voorbeeldconfiguraties voor nginx, Apache2 en Caddy.

Met auth-default-access: "deny-all" tot slot heeft standaard niemand toegang tot onderwerpen. Elke toegang moet dus expliciet worden toegestaan.

Account bij ntfy.sh

De ontwikkelaar van ntfy draait een publiek beschikbare ntfy-server op ntfy.sh. De webinterface daarvan is bereikbaar op https://ntfy.sh/app. Die kun je gratis gebruiken, bijvoorbeeld om ntfy uit te proberen, maar dat komt met beperkingen. Zo kun je geen onderwerpen reserveren en is er een maximum van 250 notificaties per dag en 2 MB per bijlage. Verder is er geen enkele vorm van authenticatie. De enige manier van beveiliging ligt dus in het geheimhouden van je onderwerpen. Die beperkingen heb je niet als je ntfy zelf installeert. Maar als je liever niet zelf een installatie onderhoudt, kun je een betaald plan nemen. Daarmee ondersteun je ook de ontwikkeling van het opensource-project. Dat begint met een Supporter-plan van 5 dollar per maand (circa 5 euro), waarmee je drie onderwerpen kunt reserveren en 2.500 notificaties mag sturen met maximum 25 MB per bijlage.

Betaal voor gebruik van de publieke ntfy-server en ondersteuning van het opensource-project.

Docker Compose

Definieer nu de container in het bestand docker-compose.yaml:

services:

  ntfy:

    image: binwiederhier/ntfy

    container_name: ntfy

    command: serve

    restart: always

    environment:

      - TZ=Europe/Amsterdam

    volumes:

      - ./containers/ntfy/cache:/var/cache/ntfy

      - ./containers/ntfy/etc:/etc/ntfy

      - ./containers/ntfy/lib:/var/lib/ntfy

    ports:

      - 80:80

Ga je voor de aanpak met een reverse proxy, dan definieer je in ditzelfde bestand ook een container voor die reverse proxy.

Start daarna de container met:

$ docker-compose up -d

Als alles goed gaat, is de webinterface van ntfy daarna bereikbaar op het ingestelde domein of ip-adres. Bovenaan links zie je een melding Notifications are disabled. Klik op Grant now om notificaties in je webbrowser toe te staan, en bevestig dit daarna in het dialoogvenster dat je webbrowser toont.

Sta notificaties in je webbrowser toe.

Lees ook: Docker op je NAS: zo draai je Plex, Home Assistant en meer

Notificaties testen

Omdat je ntfy zo geconfigureerd hebt dat alle toegang standaard wordt geblokkeerd, kun je nog niets doen in de webinterface. Je dient dus eerst gebruikers aan te maken en die de toelating te geven om op specifieke onderwerpen te publiceren of zich te abonneren. Open daarvoor een shell in de container van ntfy met de opdracht docker exec -ti ntfy /bin/sh. Als je daarna ntfy user list intypt, krijg je te zien dat anonieme, niet geauthenticeerde gebruikers geen enkele permissies hebben. Met de opdracht ntfy user add --role=admin admin voeg je dan een admin-gebruiker met de naam admin toe. Gebruikers met de rol admin kunnen op alle onderwerpen publiceren en zich erop abonneren. Geef de gebruiker een wachtwoord en bevestig.

Klik nu in de webinterface van ntfy links op Settings en dan onder Manage users op Add user. Vul de url van je ntfy-server in, de gebruikersnaam admin en het wachtwoord dat je zojuist hebt ingesteld. Klik dan links op Subscribe to topic. Kies een naam of klik op Generate name om ntfy een willekeurige naam te laten kiezen en abonneer je dan op het onderwerp met Subscribe. Klik dan op Publish notification en vul hetzelfde onderwerp in. Voer ook een titel en een bericht voor je notificatie in en klik op Send. Als alles goed gaat, verschijnt je testbericht nu in een 'conversatie' met de naam van het onderwerp, en wijst je webbrowser je op een notificatie.

Publiceer notificaties in je webbrowser.

Gebruikersrechten

De webapplicatie is leuk voor een test, maar een mobiele app is vaak handiger. De app van Ntfy voor Android en iOS stelt je in staat om op je telefoon je te abonneren op onderwerpen (publiceren is niet mogelijk) en daarvoor notificaties te ontvangen. Als je de Android-app via F-Droid installeert, is dat zonder ondersteuning voor Firebase; de versie op Google Play gebruikt wél de servers van Google. Je maakt voor je app bij voorkeur een gebruiker aan die alle onderwerpen alleen kan lezen. Dat doe je weer in de shell van de container van ntfy met ntfy user add android om de gebruiker android aan te maken (voer een wachtwoord in) en dan ntfy access android "*" read-only voor de leesrechten.

Open daarna de Android-app en tik op de drie stippen rechtsboven. Kies Settings en stel dan Default server in op het domein van je ntfy-server. Tik daarna op Manage users en Add new user en vul de url van je ntfy-server in, de gebruikersnaam android en het bijbehorende wachtwoord. Tik dan op Add user. Keer dan terug naar het hoofdscherm van de app en klik op het plusicoontje rechtsonder. Voer het onderwerp in dat je tijdens de test in stap 5 hebt gebruikt en tik op Subscribe om je erop te abonneren. Vanaf nu zal de app voor elk ontvangen bericht op dit onderwerp een notificatie tonen. Je krijgt zelfs de al verzonden berichten te zien. Overigens toont de app twee waarschuwingen. Voor betrouwbare notificaties volg je de suggesties om batterijoptimalisaties uit te schakelen en naar WebSockets over te schakelen in plaats van een http-stream.

De Android-app ontvangt een notificatie voor elk bericht dat op een geabonneerd onderwerp wordt verstuurd.

Shellscripts

Nu je hebt getest dat je ntfy-server werkt, is het tijd om je eigen services notificaties te laten uitsturen. Hoe je dat precies configureert, hangt van de service af. Maar je zult altijd eerst een gebruiker met schrijfpermissies voor een specifiek onderwerp moeten aanmaken. Voor een back-upproces dat je op de hoogte moet houden van de status van je back-ups, maak je bijvoorbeeld een gebruiker aan met de opdracht ntfy user add backup in de container van ntfy. Geef die dan schrijfrechten op het onderwerp backup met ntfy access backup backup write-only.

Het publiceren van een bericht op een specifiek onderwerp behelst niet meer dan het sturen van een http POST-aanvraag naar de webserver. Dat kan bijvoorbeeld in een shellscript op je Linux-server met de opdracht curl:

curl -u backup:password -d "Backup successful" ntfy.example.com/backup

Als je in de ntfy-app op je telefoon je op dit onderwerp abonneert, ontvang je deze notificatie nadat het back-upscript is uitgevoerd. Op deze manier is het heel eenvoudig om je eigen shellscripts notificaties te laten verzenden.

Berichten met extra's

Ntfy ondersteunt talloze extra functies om je berichten te laten opvallen of om hun gedrag aan te passen. Je gebruikt deze allemaal door een http-header aan je aanvraag toe te voegen. Zo kun je aan de notificaties van je back-upscript een titel, prioriteit en tags toevoegen. De tags worden als pictogrammen getoond door de mobiele app. Een voorbeeld:

curl -u backup:password -H "Title: Backup failure" -H "Priority: urgent" -H "Tags: warning,skull" -d "Backup unsuccessful" ntfy.example.com/backup

Als de Android-app een bericht met standaardprioriteit ontvangt, doet ze je telefoon kort vibreren en speelt ze een kort geluidje af. Door de prioriteit op urgent te zetten, wordt het standaardnotificatiegeluidje vergezeld van een langer getril van je telefoon, waardoor je onmiddellijk merkt dat dit dringend je aandacht vereist.

Een ntfy-bericht met een titel, prioriteit en pictogrammen.

Plaatjes en lay-out

Ntfy kan ook plaatjes sturen, bijvoorbeeld een foto van een ip-camera die beweging detecteert, maar niet in combinatie met een tekstbericht. Om een bestand naar ntfy te uploaden met curl in een http PUT-aanvraag gebruik je de optie -T en de bestandsnaam. Met de header Filename voeg je de bestandsnaam toe die de ntfy-app je moet tonen. Dat ziet er dan als volgt uit:

curl -u admin:password -T foto.jpg -H "Filename: beweging.jpg" -H "Title: Beweging voordeur" -H "Tags: boom" ntfy.example.com/beweging

Als je een tekstbericht als Markdown opmaakt, kun je wel plaatjes in een tekst opnemen, maar dan moet je naar het bestand linken. Alleen ntfy's webinterface ondersteunt dit; de mobiele app toont gewoon de Markdown-brontekst. Een Markdown-bericht stuur je door de header Markdown: yes of Content-Type: text/markdown aan je http POST-aanvraag toe te voegen. Ntfy ondersteunt overigens alleen beperkte Markdown-functies, zoals vette en schuine tekst, lijsten, links en afbeeldingen.

Je services kunnen ook plaatjes naar ntfy sturen.

Acties

Je ontvangt de notificaties van ntfy in de app in een 'conversatie' per onderwerp. Wanneer je op een notificatie tikt, kopieert dit standaard gewoon de tekst van het bericht naar het klembord. Als je de header Click: URL toevoegt, opent de app die url wanneer je op de notificatie tikt. Zo kun je in een notificatie van je back-upscript bijvoorbeeld een link naar de webinterface van je back-upserver opnemen om het gemelde probleem snel te onderzoeken.

Je kunt ook tot drie 'actieknoppen' definiëren, die dan onderaan een notificatie verschijnen. Door op een van die knoppen te tikken, open je een website of app, activeer je een Android broadcast intent waarop andere apps dan weer kunnen reageren, of zend je een http POST-, PUT- of GET-aanvraag. De manier om dit alles te definiëren is wat omslachtig, maar wordt volledig in de documentatie van ntfy uitgelegd.

Klik op een van de knoppen van het bericht in ntfy om een actie uit te voeren.

Python-code

Curl is natuurlijk niet de enige tool waarmee je notificaties naar je ntfy-server kunt sturen. Sommige tools bieden rechtstreeks ondersteuning voor notificaties via ntfy. Dan hoef je alleen maar het domein van je server, het onderwerp, de gebruikersnaam en het bijbehorende wachtwoord in te vullen. Maar ook in je eigen Python-scripts kun je eenvoudig ondersteuning voor ntfy inbouwen. Dat gaat via het pakket Requests, waarmee je http POST-aanvragen naar de server stuurt. Een eenvoudig voorbeeld ziet er als volgt uit:

import requests

requests.post("http://ntfy.example.com/backup",

    data="Backup unsuccessful",

    headers={

        "Authorization": "Basic Z2VicnVpa2Vyc25hYW06d2FjaHR3b29yZA==",

        "Title": "Backup failure",

        "Priority": "urgent",

        "Tags": "warning,skull"

    })

Met de header Authorization stel je http Basic-authenticatie in. De tekenreeks die na Basic komt, is een Base64-codering van de gebruikersnaam en het wachtwoord met een dubbele punt ertussen. Je creëert die codering op je Linux-systeem met de opdracht echo "Basic $(echo -n 'gebruikersnaam:wachtwoord' | base64)".

Sssssssssschattig

Speciaal voor de kleinste Python-fans

En verder

Ntfy biedt een betrouwbare manier om notificaties van allerlei services te centraliseren, terwijl je zelf de volledige controle behoudt. Het programma blinkt uit in flexibiliteit om het overal in te integreren. Als een service bijvoorbeeld geen http POST-aanvragen ondersteunt, kun je ook http GET-aanvragen doen. En als een service je niet de mogelijkheid geeft om de headers aan te passen, laat ntfy je toe om de berichten inclusief headers in JSON-formaat door te sturen. En als een service webhooks ondersteunt maar daarvoor zijn eigen JSON-formaat gebruikt, kan ntfy die met berichtsjablonen omzetten naar leesbare berichten.

Ook via e-mail is ntfy te integreren. Je kunt bijvoorbeeld berichten die op je ntfy-server aankomen automatisch laten doorsturen naar een SMTP-server om ze ook als e-mail te ontvangen. Maar ook de andere richting is voorzien: ntfy kan dan zelf een ingebouwde SMTP-server draaien, handig voor services die alleen maar notificaties via e-mail ondersteunen. Elk onderwerp op de ntfy-server heeft dan een bijbehorend e-mailadres op je domein. De service hoeft dan alleen maar een e-mail naar dat adres te sturen om berichten op dat onderwerp te publiceren op je ntfy-server. Deze en andere geavanceerde functies zijn uitgebreid gedocumenteerd op de website van ntfy.

De documentatie van ntfy is uitgebreid en praktisch.