Hoe maak ik gebruik van SSH keys?

Bijgewerkt door Jan

Om in te loggen op de SSH van je hostingpakket heb je 2 methodes:

  1. Via gebruikersnaam en wachtwoord.
  2. Via SSH geautoriseerde sleutels (keys).

In dit artikel leggen we uit hoe je de sleutels aanmaakt welk je voor methode 2 gebruikt voor Windows en MacOS. (Zie voor methode 1 dit artikel: verbinding maken met ssh)

Je hebt na dit proces 2 sleutels, de publieke en de privé sleutels. De publieke sleutel autoriseer je op het hostingpakket en de privé sleutel gebruik je om mee in te loggen op een plek waar de publieke sleutel is geautoriseerd. De privé sleutel kan je dus zien als een soort wachtwoord.

Windows

PuTTY downloaden en installeren

Om te beginnen download je PuTTY op je Windows PC, dit kan via deze link: PuTTY Download Link

Zie voor meer informatie ook:

Je komt nu op een pagina terecht met meerdere download opties, scrol naar de Package files sectie. Hier heb je 3 opties onder MSI (‘Windows Installer’):

  1. 64-bit x86
  2. 64-bit Arm
  3. 32-bit x86

In de meeste gevallen is de 1e optie (64-bit x86) de juiste keuze. Mocht de 1e optie toch niet werken bij het installeren probeer dan simpelweg optie 2 en dan optie 3 mocht het alsnog niet werken.

Sleutel aanmaken

Nu dat PuTTY is geïnstalleerd kunnen we de sleutels aanmaken. Open het programma PuTTYgen in Windows.

Open voor nu dus nog niet PuTTY, enkel PuTTYgen.

  1. Je zal nu een klein venster voor je hebben met titel PuTTY Key Generator. Zet als eerst bij de Parameters sectie de optie op Ed25519. Klik daarna in dit venster op de Generate knop.
  2. Je zal nu gevraagd worden om de muis te bewegen om de sleutels te genereren, beweeg je muis onder de laadbalk in het lege vak totdat de balk helemaal vol is en je de sleutel te zien krijgt.
  3. Als dit proces compleet is selecteer je alle tekst in het bovenste veld, dit is de publieke sleutel. Sla dit veilig op door deze tekst te kopiëren en te plakken in een tekstbestand op je PC. Noem dit bestand bijvoorbeeld "pubkey.txt".
  4. Zodra je dit hebt gedaan klik je ook nog eens op de Save private key knop. Sla deze private key op dezelfde locatie op als je publieke sleutel van de vorige stap. (Dit is een apart .ppk-bestand.)
    De Save public key knop is in principe niet nodig omdat je de publieke sleutel al hebt opgeslagen in de vorige stap. Je kan PuTTYgen nu veilig afsluiten.
    Let op: De Save public key knop slaat de publieke key op in een ander formaat dan als je de tekst handmatig kopieert en opslaat in een tekstbestand. Deze versie van de knop zal namelijk niet door DirectAdmin worden geaccepteerd, vandaar dat we dit opslaan door het eerste veld te kopiëren en plakken in een tekstbestand.

De SSH Keys zijn nu succesvol aangemaakt, als volgende stap kan je deze toevoegen aan het hostingpakket om ze te autoriseren.

Zie dit artikel hoe je de publieke sleutel toevoegt aan DirectAdmin: Hoe voeg ik SSH Keys toe aan DirectAdmin

Inloggen op SSH via PuTTY met de Private Key

Zodra de publieke sleutel is toegevoegd en geautoriseerd kan je PuTTY gebruiken om met de privé sleutel op SSH in te loggen.

  1. Open het programma PuTTY in Windows.
    Open dus PuTTY, niet PuTTYgen.
  2. Ga nu in het linker menu in PuTTY naar Connection > SSH > Auth.
  3. Er opent nu een scherm met opties, rechts onderaan klik je op de Browse knop.
  4. Navigeer nu naar de plek waar je de Private Key hebt opgeslagen, dit is het .ppk-bestand welk we bij de vorige stappen bij stap 4 hebben opgeslagen. Kies dit bestand, het zal opgeslagen zijn met naam "privkey.ppk".
  5. Ga nu in het linker menu terug naar de 1e optie, Session.
  6. Type bij het veld Host Name (or IP address) je domeinnaam of de hostnaam van de server in. Om het makkelijk te houden kan je hier gewoon je domeinnaam invullen.
    Eventueel kan je de mijn.host servernaam gebruiken. Als je op DirectAdmin bent ingelogd staat dit in de URL-balk. Dit kan bijvoorbeeld zijn h8.mijn.host, h32.mijn.host etc.
    Ik weet niet wat ik moet invullen
    Ben je niet zeker wat je moet invullen of werkt het niet, vraag het dan aan onze support.

    Je kan ook in het control panel kijken welk ip je hosting pakket heeft.
    Vul dan dit IP in bij het veld: Host Name (or IP address)

    Je vind het IP hier:

    In onderstaand voorbeeld gebruiken we h8.mijn.host.
  7. Typ bij het Port veld het nummer 26 in.
  8. Zodra deze gegevens zijn ingevuld klik je onderaan op de Open knop, een nieuw venster zal openen.
  9. In dit nieuwe venster krijg je te zien Login as:, typ hier je DirectAdmin gebruikersnaam in. In onderstaand voorbeeld is onze gebruikersnaam "auwdomei".
    De DirectAdmin gebruikersnaam en het wachtwoord heb je van ons via mail ontvangen bij de aanschaf van je hosting pakket.

    In de meeste gevallen zal je gebruikersnaam bestaan uit 2 letters en dan je klantnummer. Bijvoorbeeld az123456. Gebruik altijd kleine letters.
  10. Klik daarna op enter, je zal nu het bericht zien dat je bent geauthenticeerd met de publieke sleutel die je eerder hebt aangemaakt en aan DirectAdmin hebt toegevoegd.

Je bent nu succesvol ingelogd via SSH op de server! Mocht je toch nog tegen problemen aanlopen laat het dan gerust weten aan onze support, ze helpen je graag om je problemen op te lossen.

MacOS

Sleutel aanmaken

Om een SSH key aan te maken binnen MacOS of een ander UNIX/Linux OS heb je geen extra software nodig. Dit kan gewoon vanuit de ingebouwde Terminal app, waarbij je ook direct met een SSH host kunt verbinden.

  1. Open de Terminal app in MacOS. Je kan de Terminal app openen door te zoeken met Spotlight. Dit doe je met ⌘ (command) + Spatie. Type vervolgens Terminal en druk op Enter.
    Je kan Terminal ook vinden in je Applications folder. Open Finder, ga naar Applications en open het mapje Utilities. Hierin staat de Terminal app, dubbelklik op Terminal.app om de Terminal te openen.
    Andere optie is door Finder te openen, voer dan dit commando uit: ⌘ (command) + ⇧ (Shift) + U. Dubbelklik vervolgens op Terminal.
  2. Wanneer de Terminal app is geopend type je het volgende:
    ssh-keygen -t ed25519
  3. Daarna word er gevraagd op welke locatie je dit bestand wil opslaan bijvoorbeeld (/Users/gebruikersnaam/.ssh/id_ed25519). Je kunt op enter drukken als je de voorgestelde locatie goed vind. Let op dat je de sleutel wel binnen de .ssh map op slaat.
  4. Vervolgens wordt er gevraagd om een wachtwoord op te geven. Dit is optioneel. Als je een wachtwoord opgeeft moet je dit wachtwoord iedere keer opgeven als je met een host of server via SSH probeert te verbinden. Dit is een extra veiligheidslaag, mocht je SSH private key ooit gestolen worden. We raden je aan om wel een wachtwoord op te geven.
    SSH key aanmaken in Terminal op MacOS
  5. Je SSH sleutel is nu aangemaakt. De sleutel die op de server moet worden opgeslagen kan je met het volgende commando inzien (let op, gebruikersnaam is een voorbeeld):
    cat /Users/gebruikersnaam/.ssh/id_ed25519.pub 
    ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKA+WzYqJ7wvsv7lnxCLhY2/upBc6WVJSlvfMVb1HG6w gebruikersnaam@MacBook.local
    Vervang gebruikersnaam met de daadwerkelijke gebruikersnaam van je computer (welke ook in stap 3 werd weergeven). Mocht je in stap 3 een andere locatie hebben gekozen dan pas je bovenstaande commando uit met de juiste locatie, aangevuld met .pub
    Public SSH key bekijken in Terminal op MacOS

De SSH key is nu aangemaakt. Je kunt je publieke sleutel uploaden bij de server waarop je wil inloggen om vervolgens in te kunnen loggen met je SSH key.

Zie dit artikel hoe je je publieke sleutel toevoegt aan DirectAdmin: hoe voeg ik SSH Keys toe aan DirectAdmin

Inloggen op SSH via Terminal met de Private Key

  1. Op de Terminal app (Zie stap 1 onder het kopje Sleutel aanmaken)
  2. Type het volgende command op in te loggen met de SSH sleutel.
    De SSH poort waarop je standaard moet verbinden bij onze hostingpakketten is poort 26 (-p 26).
  3. Type hieronder je gebruikersnaam en domeinnaam om jou persoonlijke SSH commando te krijgen.
Gebruikersnaam: Domeinnaam:

Kopieer en plak dit commando in je Terminal app en druk op enter.

De DirectAdmin gebruikersnaam en het wachtwoord heb je van ons via mail ontvangen bij de aanschaf van je hosting pakket.

In de meeste gevallen zal je gebruikersnaam bestaan uit 2 letters en dan je klantnummer. Bijvoorbeeld az123456. Gebruik altijd kleine letters.
  1. Geef het wachtwoord van je SSH key op indien je dit hebt ingesteld.
  2. Je bent nu verbonden met de server via SSH door middel van je SSH key.


Hoe hebben we het gedaan?