Elke keer een wachtwoord typen als je verbinding maakt met een server wordt snel vervelend, en wachtwoorden zijn te raden. SSH-sleutels lossen beide problemen op. Aan het eind van deze gids heb je een ed25519-sleutel met een wachtwoordzin, een server die hem accepteert, een korte alias zodat je gewoon ssh myserver typt, en dezelfde setup die ook werkt met je git-host.
Wat je nodig hebt
- Een computer met macOS, Linux of Windows 10/11 met de ingebouwde OpenSSH-client.
- Een server of tweede computer die je al kunt bereiken met een gebruikersnaam en wachtwoord.
- Een terminal (Terminal op macOS, een willekeurige shell op Linux, PowerShell op Windows).
- Ongeveer 15 minuten.
In de voorbeelden is alice de gebruikersnaam, server.example.com de server en 203.0.113.10 het adres. Vervang ze door je eigen gegevens.
Stap 1: Maak een ed25519-sleutel
Voer dit uit op de computer vanaf waar je verbinding maakt. De optie -C voegt een opmerking toe, meestal je e-mailadres, zodat je sleutels later uit elkaar kunt houden.
ssh-keygen -t ed25519 -C "alice@example.com"
Recente OpenSSH-versies gebruiken standaard al ed25519, maar door het type te noemen werkt de opdracht overal. Druk op Enter om de standaardlocatie te accepteren. Je ziet dan zoiets als dit:
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/alice/.ssh/id_ed25519):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/alice/.ssh/id_ed25519
Your public key has been saved in /home/alice/.ssh/id_ed25519.pub
Je hebt nu twee bestanden. id_ed25519 is de privésleutel. Behandel die als een wachtwoord en deel hem nooit. id_ed25519.pub is de publieke sleutel, die je veilig overal naartoe kunt kopiëren.
Stap 2: Voeg een wachtwoordzin toe en laad de sleutel in ssh-agent
Als er om een wachtwoordzin (passphrase) wordt gevraagd, stel er dan een in. Als iemand ooit je privésleutel kopieert, staat de wachtwoordzin nog steeds in de weg. Heb je hem overgeslagen, voeg hem dan later toe met ssh-keygen -p -f ~/.ssh/id_ed25519.
ssh-agent onthoudt de ontgrendelde sleutel, zodat je de wachtwoordzin maar één keer per sessie hoeft te typen.
macOS
Start de agent en voeg je sleutel toe aan de macOS-sleutelhanger:
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
Voeg daarna deze regels toe aan ~/.ssh/config (maak het bestand aan als het nog niet bestaat), zodat de sleutel automatisch wordt geladen:
Host *
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519
UseKeychain is een toevoeging van Apple en werkt dus alleen op macOS.
Linux
Veel desktopsessies draaien al een agent. Doet die van jou dat niet, start er dan een en voeg de sleutel toe:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
Windows
De ssh-agent-service staat standaard uit. Open PowerShell als administrator en voer uit:
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
Daarna, in een gewoon PowerShell-venster:
ssh-add $env:USERPROFILE\.ssh\id_ed25519
Stap 3: Kopieer je publieke sleutel naar de server
De server houdt een lijst met vertrouwde publieke sleutels bij in ~/.ssh/authorized_keys. De makkelijkste manier om die van jou toe te voegen is ssh-copy-id, beschikbaar op macOS en de meeste Linux-systemen:
ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com
Het vraagt nog één laatste keer om je serverwachtwoord, maakt het bestand aan als dat nodig is en slaat sleutels over die er al staan.
Heb je geen ssh-copy-id, bijvoorbeeld in Windows PowerShell, kopieer het sleutelbestand dan met scp en voeg het daarna op de server toe aan de lijst:
scp $env:USERPROFILE\.ssh\id_ed25519.pub alice@server.example.com:key.pub
ssh alice@server.example.com "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat ~/key.pub >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys && rm ~/key.pub"
Deze opdrachten zijn voor een Linux- of macOS-server. Elke opdracht vraagt om je serverwachtwoord. Een Windows-server bewaart sleutels op een andere plek, en administratoraccounts gebruiken C:\ProgramData\ssh\administrators_authorized_keys. Volg in dat geval de gids van Microsoft die hieronder staat.
Stap 4: Log in en controleer de vingerafdruk van de host
Maak nu verbinding:
ssh alice@server.example.com
De eerste keer dat je een nieuwe server bereikt, toont SSH de vingerafdruk en vraagt je om te bevestigen:
The authenticity of host 'server.example.com (203.0.113.10)' can't be established.
ED25519 key fingerprint is SHA256:4fXk2...Q9wE.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
Typ niet op de automatische piloot yes. Controleer de vingerafdruk zo mogelijk op de server zelf, via een console of een bestaande sessie:
ssh-keygen -l -f /etc/ssh/ssh_host_ed25519_key.pub
Komen ze overeen, typ dan yes. SSH bewaart de sleutel in ~/.ssh/known_hosts en waarschuwt je als die ooit verandert. Je komt nu in een shell terecht zonder dat om het serverwachtwoord wordt gevraagd. Mogelijk wordt één keer om de wachtwoordzin van je sleutel gevraagd als de agent hem nog niet vasthoudt.
Stap 5: Maak een Host-alias in ~/.ssh/config
Voeg op je eigen computer een item toe aan ~/.ssh/config:
Host myserver
HostName server.example.com
User alice
Port 22
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
Nu is dit alles wat je nodig hebt:
ssh myserver
IdentitiesOnly yes zorgt ervoor dat SSH alleen de sleutel aanbiedt die je hebt opgegeven.
Stap 6: SSH tussen twee eigen apparaten thuis
Dezelfde stappen werken tussen twee computers in je thuisnetwerk. Op het apparaat waarmee je verbinding maakt, moet alleen een SSH-server draaien.
Open op een Mac Systeeminstellingen, ga naar Algemeen en dan Delen, en zet Remote Login (Extern inloggen) aan. Klik op de infoknop ernaast om de precieze ssh-opdracht voor die Mac te zien.
Installeer op Ubuntu het serverpakket:
sudo apt install openssh-server
Zoek het lokale adres van het doelapparaat op in de netwerkinstellingen. Kopieer daarna vanaf de andere computer je sleutel en maak zoals eerder verbinding met dat adres. In dit voorbeeld is het een plaatshouder:
ssh-copy-id alice@192.168.1.50
ssh alice@192.168.1.50
Stap 7 (optioneel): Zet inloggen met een wachtwoord uit
Werkt inloggen met de sleutel, dan kun je de server helemaal geen wachtwoorden meer laten accepteren. Bots die wachtwoorden raden, hebben dan niets meer te raden.
Houd je huidige SSH-sessie open terwijl je dit doet. Gaat er iets mis, dan kun je het via die open sessie herstellen. Test vanuit een tweede terminal voordat je iets sluit.
Op Ubuntu gaan instellingen in /etc/ssh/sshd_config.d/ voor op het hoofdbestand, en de eerst gelezen waarde wint. Bestanden worden op naamvolgorde geladen, dus een naam die begint met 00- wordt als eerste gelezen:
sudo nano /etc/ssh/sshd_config.d/00-no-passwords.conf
Voeg deze twee regels toe:
PasswordAuthentication no
KbdInteractiveAuthentication no
Controleer de configuratie op fouten en herstart daarna de service:
sudo sshd -t
sudo systemctl restart ssh.service
Voer vanuit een nieuwe terminal ssh myserver uit om te checken dat je er nog in komt. Probeer daarna ssh -o PubkeyAuthentication=no myserver. Dat zou geweigerd moeten worden. De software van de server up-to-date houden is net zo belangrijk.
Stap 8: Koppel een git-host
Git-hosts zoals GitHub accepteren dezelfde sleutel. Toon je publieke sleutel en kopieer hem:
cat ~/.ssh/id_ed25519.pub
Plak hem in het onderdeel voor SSH-sleutels in je accountinstellingen en volg daarbij de gids van je git-host (die van GitHub staat hieronder). Test daarna:
ssh -T git@github.com
Een geslaagde test ziet er zo uit:
Hi alice! You've successfully authenticated, but GitHub does not provide shell access.
Je git-account is een belangrijk onderdeel van je online identiteit, dus het loont om ook je andere accounts na te lopen.
Veelvoorkomende fouten en oplossingen
Permission denied (publickey)
De server accepteerde geen van de sleutels die je aanbood. Controleer of de publieke sleutel op de server in ~/.ssh/authorized_keys staat, of je de juiste gebruikersnaam gebruikt en of de agent je sleutel vasthoudt. Voer ssh -v myserver uit om te zien welke sleutels worden geprobeerd.
Verkeerde rechten op ~/.ssh
Standaard negeert de SSH-server je sleutels als je bestanden te ruime rechten hebben. Herstel dat op de server met:
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
WARNING: UNPROTECTED PRIVATE KEY FILE!
Je privésleutel is leesbaar voor andere gebruikers, dus SSH weigert hem te gebruiken. Voer op je eigen computer uit:
chmod 600 ~/.ssh/id_ed25519
WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!
De sleutel van de server komt niet meer overeen met die in known_hosts. Dat gebeurt nadat een server opnieuw is geïnstalleerd, maar het kan ook op een aanval wijzen. Controleer of de wijziging verwacht is, verwijder dan het oude item en maak opnieuw verbinding:
ssh-keygen -R server.example.com
The agent has no identities
ssh-add -l toont dit als de agent draait maar geen sleutels vasthoudt. Voeg die van jou opnieuw toe met ssh-add ~/.ssh/id_ed25519. Zie je ‘Could not open a connection to your authentication agent’, start dan eerst de agent, zoals in stap 2.
Tot slot
Je logt nu in met een sleutel in plaats van een wachtwoord, je sleutel is beveiligd met een wachtwoordzin en een alias houdt opdrachten kort. Gebruik één sleutel per computer in plaats van een privésleutel rond te kopiëren. Raak je een apparaat kwijt, verwijder dan de regel met de publieke sleutel ervan uit authorized_keys en bij je git-host.
Voelt inloggen met een sleutel eenmaal als routine, dan komen dezelfde terminalgewoontes van pas bij nieuwere ontwikkelsetups. Onze gids over Chrome DevTools MCP laat zien hoe je een coding-agent een echte browser geeft.
Bronnen en officiële documentatie
Links voor het laatst gecontroleerd op 15 november 2026.
- OpenSSH ssh-keygen manual
- OpenSSH ssh manual
- OpenSSH ssh_config manual
- OpenSSH sshd_config manual
- ssh-copy-id manual page
- GitHub Docs: Generating a new SSH key and adding it to the ssh-agent
- GitHub Docs: Testing your SSH connection
- Microsoft Learn: Key-based authentication in OpenSSH for Windows
- Ubuntu Server docs: OpenSSH server
- Apple Support: Allow a remote computer to access your Mac





Schrijf een reactie