PXL Digital

Appearance

SSH koppelen aan GitHub ​

INFO

In deze documentatie wordt uitgelegd hoe een SSH-sleutel aangemaakt kan worden en hoe deze gekoppeld kan worden aan een GitHub-account. Op deze manier kan er veilig verbinding gemaakt worden tussen een lokale Git-repository en een repository op GitHub, zonder dat er telkens met een gebruikersnaam en wachtwoord ingevoerd moet worden of dat er een Personal Access Token gebruikt moet worden.

Inhoud

Wat is SSH? ​

SSH staat voor Secure SHell. Het is een netwerkprotocol dat veilige communicatie mogelijk maakt tussen twee computers. SSH wordt vaak gebruikt voor het beheren van servers op afstand, maar ook voor het veilig verbinden van lokale machines met externe diensten zoals GitHub.

Hoe werkt SSH? ​

SSH maakt gebruik van een paar sleutels: een private key (Nederlands: privésleutel) en een public key (Nederlands: publieke sleutel). De private key blijft op jouw computer en mag nooit gedeeld worden, terwijl de public key op de server (in dit geval GitHub) wordt geplaatst. Wanneer er een verbinding wordt gemaakt, gebruikt de server de public key om een puzzel aan te maken die alleen opgelost kan worden door de private key die op jouw computer staat. Op deze manier kan GitHub verifiëren dat het echt jouw computer is die verbinding maakt, zonder dat er een wachtwoord nodig is.

SSH-sleutel aanmaken ​

sh
ssh-keygen -t ed25519 -C "voornaam.achternaam@student.pxl.be"

INFO

Vervang voornaam.achternaam@student.pxl.be door het e-mailadres dat gebruikt is tijdens het aanmaken van de GitHub-account.

  • Druk op Enter om de standaardlocatie te gebruiken.
  • Druk op Enter om geen wachtwoord in te stellen.
  • Druk nogmaals op Enter om geen wachtwoord in te stellen.

SSH-sleutel kopiëren naar GitHub ​

sh
cat ~/.ssh/id_ed25519.pub

INFO

sh
ssh-ed25519 ABBAC3NzaC1lZDI1NTE5AAAAIPR+B7iQbt5ozo+sH13eYa2R8J/WEACgyQT664dSWp91 voornaam.achternaam@student.pxl.be

De tekst met random karakters is de public key, deze zal er bij jou anders uitzien. voornaam.achternaam@student.pxl.be zal het e-mailadres zijn dat ingegeven is tijdens het aanmaken van de SSH-sleutel.

Kopieer alles, vanaf ssh-ed25519 tot en met het e-mailadres.

  • Ga naar GitHub, klik rechtsboven op de profielfoto en klik op Settings.
  • Ga naar SSH and GPG keys en klik op New SSH key.
  • Vul een willekeurige naam in, bv. "Mijn laptop", als Title en plak de sleutel in het veld Key.
  • Voeg de sleutel toe door op Add SSH key te klikken.