Ugrás a fő tartalomhoz

SSH kulcs generálás

A HelloHost szerverekhez jelszó nélküli, kulcs-alapú SSH hitelesítést használunk. Ehhez szükséged van egy SSH kulcspárra: egy privát kulcsra (soha nem hagyja el a gépedet) és egy publikus kulcsra (ezt töltöd fel a HelloHost felületre).

Ez a dokumentum végigvezet a kulcs létrehozásán macOS, Linux és Windows rendszeren, és megmutatja hogyan add hozzá a HelloHost-hoz.

Miért ed25519?​

Három algoritmust támogat az OpenSSH: RSA, ECDSA és ed25519. A HelloHost ed25519-et használ és ezt ajánljuk:

  • Kisebb kulcsméret (68 karakter a publikus), ugyanakkor erősebb mint egy 3072-bites RSA
  • Gyorsabb a kulcs kiállítás és a hitelesítés
  • Modern, biztonságos szabvány – a GitHub és a GitLab is alapértelmezetten ezt javasolja
  • OpenSSH 6.5 óta (2014) támogatott – minden modern rendszer tudja
Régi RSA kulcsok

Ha van már RSA kulcsod, továbbra is működik, de új kulcsnál mindig ed25519-et hozz létre.

Kulcs generálása macOS / Linux alatt​

Nyiss egy terminált és futtasd:

ssh-keygen -t ed25519 -C "nev@hellohost"

A -C opció a kulcshoz tartozó kommentár – az email címed vagy egy azonosító, ami megjelenik az authorized_keys fájlban, hogy később felismerd.

A parancs 3 kérdést tesz fel:

  1. Fájl útvonala – [Enter] megnyomásával fogadd el az alapértelmezett ~/.ssh/id_ed25519-et. Ha több kulcsod is lesz, adj különálló nevet (pl. ~/.ssh/hellohost_ed25519).
  2. Passphrase (jelmondat) – erősen ajánlott megadni. Ha a privát kulcsodhoz valaki hozzáfér, a passphrase egy extra védelmi réteg. Ne spórolj vele.
  3. Passphrase megerősítése – írd be újra.

A parancs végén ezt látod:

Your identification has been saved in /Users/te/.ssh/id_ed25519
Your public key has been saved in /Users/te/.ssh/id_ed25519.pub
Két fájl keletkezett
  • id_ed25519 – a privát kulcs. Soha ne oszd meg, ne commiteld git-be, ne másold át üzeneten.
  • id_ed25519.pub – a publikus kulcs. Ezt töltöd fel a szerverre / HelloHost-ra.

Kulcs generálása Windows alatt​

Windows 10/11-en már beépített OpenSSH kliens van, így nincs szükség külső eszközre.

PowerShell / Windows Terminal​

Nyiss egy PowerShell ablakot és futtasd:

ssh-keygen -t ed25519 -C "nev@hellohost"

A folyamat ugyanaz, mint macOS / Linux alatt. A kulcsok a C:\Users\<felhasznalonev>\.ssh\ mappába kerülnek.

Git for Windows

Ha Git for Windows-t használsz, a Git Bash terminálban is futtathatod ugyanezt a parancsot, ugyanúgy működik.

PuTTY (régi verziók)​

Ha valamiért PuTTY-t használsz (pl. régebbi Windows), a PuTTYgen alkalmazással készítheted el a kulcsot:

  1. Indítsd el a PuTTYgen-t
  2. Válaszd az EdDSA típust, az Ed25519 (255 bits) görbével
  3. Kattints a Generate gombra, mozgasd az egeret a terület felett entrópiához
  4. Add meg a passphrase-t
  5. Save private key – mentse .ppk formátumban (PuTTY saját formátuma)
  6. A felső szövegdobozban megjelenik a publikus kulcs OpenSSH formátumban – ezt másold ki

Bővebben a PuTTY használatáról: SSH használat Windows-on.

Kulcs hozzáadása az ssh-agent-hez​

Az ssh-agent a memóriában tartja a privát kulcsod passphrase-ét, így a session során nem kell újra és újra beírnod.

macOS​

macOS Keychain-be mentve a passphrase perzisztens marad (reboot után is):

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Linux​

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Ha a session lejár, újra be kell írnod. Perzisztens megoldáshoz állítsd be a ~/.ssh/config-ban (lásd alább).

Windows (PowerShell)​

Windows-on először engedélyezni kell az OpenSSH Authentication Service-t:

# Rendszergazda PowerShell
Set-Service ssh-agent -StartupType Automatic
Start-Service ssh-agent

Ezután a szokásos parancs:

ssh-add $env:USERPROFILE\.ssh\id_ed25519

Publikus kulcs feltöltése a HelloHost-ra​

  1. Jelentkezz be a cloud.hellohost.io felületre
  2. Menj egy szerver oldalára → SSH Keys tab
  3. Kattints az Add SSH Key gombra
  4. Name: egy felismerhető név (pl. macbook-pro, home-desktop)
  5. Public Key: illeszd be a publikus kulcs tartalmát

A publikus kulcs tartalmát így másold ki:

macOS:

pbcopy < ~/.ssh/id_ed25519.pub

Linux (Wayland/X11):

xclip -selection clipboard < ~/.ssh/id_ed25519.pub
# vagy
wl-copy < ~/.ssh/id_ed25519.pub

Windows PowerShell:

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard

Majd Ctrl+V / Cmd+V a HelloHost űrlapba.

Helyes formátum

A publikus kulcs egyetlen sor, ezzel kezdődik: ssh-ed25519 AAAAC3... és végződik a kommentáriddal. Ne ékezetes karakterekkel mókolj, és soha ne illeszd be a privát kulcsot (id_ed25519, prefix nélkül).

Mentés után néhány másodpercen belül megjelenik a szerveren, és próbálkozhatsz az SSH bejelentkezéssel:

ssh -p <port> <user>@<szerver-ssh-host>

A portot és a hostnevet a szerver oldalán a Configuration szekcióban találod.

~/.ssh/config – host aliasok​

Ha több szerverhez is csatlakozol, vagy nem default porton mennek, érdemes a ~/.ssh/config-ot használni. Windows alatt a C:\Users\<user>\.ssh\config helyen.

Példa:

Host wphu
    HostName 2a01-4f9-5a-4651--108.ssh.hellohost.io
    Port 10009
    User root
    IdentityFile ~/.ssh/id_ed25519
    AddKeysToAgent yes
    UseKeychain yes

Ezután elég:

ssh wphu

Az AddKeysToAgent yes + UseKeychain yes beállítás miatt az első bejelentkezésnél a passphrase-t beírod, utána a keychain megjegyzi.

Biztonsági checklist​

  • Passphrase használata – ne legyen jelszó nélküli kulcsod (legalább 12 karakter)
  • ed25519 algoritmus – ne RSA-1024, ne DSA
  • Privát kulcs jogosultság – ~/.ssh/id_ed25519 legyen 600 (csak te olvashatod, senki más)
  • Authorized_keys ellenőrzése – a szerveren néha nézd át, hogy csak a várt kulcsok vannak-e
  • Forgó kulcsok – évente új kulcsot, régiek törlése a HelloHost SSH Keys listából
  • Privát kulcs NE legyen git-ben, felhő szinkronban, üzenetben, pendrive-on

Hibák és megoldásaik​

"Permission denied (publickey)"​

  • A publikus kulcs nincs (még) hozzáadva a szerverhez → ellenőrizd a HelloHost SSH Keys tabot
  • A kliens nem a megfelelő privát kulcsot küldi → ssh -v ... indítással láthatod, melyik kulcsokat próbálja; megoldás: ~/.ssh/config-ban IdentityFile explicit megadása
  • A privát kulcs jogosultsága túl nyitott → chmod 600 ~/.ssh/id_ed25519

"Bad owner or permissions on /home/.../.ssh/authorized_keys"​

Az SSH szigorú a jogosultságokkal a szerveren:

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

"Could not open a connection to your authentication agent"​

Az ssh-agent nem fut. Lásd a fenti ssh-agent szekciót.

Kulcs típus hiba ("no matching host key type found")​

Régi SSH kliens nem ismer ed25519-et. Frissítsd a kliensoldali OpenSSH-t, vagy ideiglenes megoldásként a ~/.ssh/config-ba:

Host <név>
    HostKeyAlgorithms +ssh-rsa,ssh-ed25519

Következő lépés​

Windows alatt egy teljes gyakorlati útmutató az SSH használathoz: SSH használat Windows-on.