Bhyllabus l'énigme

Les pèlerins au-dessus des nuages

Buat SSH Key Ed25519 di Linux untuk GitHub dan GitLab dengan Aman

Ilustrasi laptop Linux dengan alur kunci publik dan privat, agen SSH, serta koneksi aman ke repositori Git

Jika setiap kali menjalankan git push atau git pull Anda masih diminta memasukkan kredensial, ada cara yang lebih nyaman sekaligus aman: autentikasi menggunakan pasangan kunci SSH. Linux sudah menyediakan OpenSSH di banyak distribusi, sehingga Anda tidak perlu memasang aplikasi besar hanya untuk membuat kunci. Panduan ini menyiapkan kunci Ed25519, menghubungkannya dengan ssh-agent, lalu menguji akses ke GitHub atau GitLab.

Catatan penting: SSH key untuk Git tidak menggantikan kata sandi atau passkey saat masuk ke situs GitHub/GitLab melalui peramban. Kunci ini dipakai oleh Git ketika berkomunikasi dengan server melalui protokol SSH.

Ilustrasi laptop Linux dengan alur kunci publik dan privat, agen SSH, serta koneksi aman ke repositori Git

Mengapa memakai SSH key?

SSH (Secure Shell) adalah protokol untuk komunikasi jarak jauh yang terenkripsi. Dalam autentikasi berbasis kunci, komputer Anda menyimpan dua bagian yang saling berpasangan: kunci privat yang harus tetap rahasia dan kunci publik yang boleh diberikan kepada layanan tujuan. Server menyimpan kunci publik, sedangkan proses autentikasi membuktikan bahwa Anda memiliki kunci privat yang cocok tanpa mengirimkan kunci privat itu ke server.

Untuk kebanyakan komputer modern, Ed25519 merupakan pilihan awal yang baik. Dokumentasi GitLab menandainya sebagai algoritma yang disarankan dan OpenSSH saat ini juga menggunakan Ed25519 sebagai tipe bawaan saat ssh-keygen dijalankan tanpa opsi tipe. Pada lingkungan yang menerapkan kebijakan FIPS atau sistem lama, dukungan algoritma perlu diperiksa terlebih dahulu; RSA 4096-bit dapat menjadi alternatif kompatibilitas jika diwajibkan oleh layanan atau kebijakan organisasi.

1. Pastikan OpenSSH client tersedia

Buka terminal dan periksa versi klien SSH. Perintah berikut berlaku untuk Bash atau Zsh di distribusi Linux umum:

ssh -V

Jika perintah tidak ditemukan, pasang paket klien OpenSSH sesuai distribusi. Jalankan perintah pemasangan hanya bila memang diperlukan:

# Debian dan Ubuntu
sudo apt install openssh-client

# Fedora
sudo dnf install openssh-clients

# Arch Linux
sudo pacman -S openssh

Perintah pemasangan membutuhkan hak administrator. Pada banyak instalasi desktop, OpenSSH client sudah tersedia sejak awal.

2. Periksa apakah Anda sudah memiliki kunci

Sebelum membuat kunci baru, lihat isi direktori SSH di folder rumah:

ls -la ~/.ssh

Pasangan Ed25519 standar biasanya bernama id_ed25519 dan id_ed25519.pub. Berkas tanpa akhiran .pub adalah kunci privat. Jangan menampilkan, mengunggah, atau mengirimkan berkas tersebut. Untuk memeriksa sidik jari kunci publik yang sudah ada, gunakan:

ssh-keygen -lf ~/.ssh/id_ed25519.pub

Jalankan perintah terakhir hanya jika berkas itu memang ada. Jika Anda sudah memiliki kunci yang dipakai untuk layanan lain, jangan menimpanya. Anda dapat memakai kunci yang sama jika kebijakan layanan mengizinkan, atau membuat pasangan baru dengan nama berbeda agar akses tiap akun/perangkat lebih mudah dikelola.

3. Buat pasangan kunci Ed25519

Jika belum mempunyai kunci yang ingin digunakan, buat pasangan baru. Ganti alamat contoh dengan alamat surel yang membantu Anda mengenali kunci tersebut:

ssh-keygen -t ed25519 -C "nama@contoh.com"

Program akan menanyakan lokasi penyimpanan. Jika nama bawaan belum digunakan, Anda dapat menerima lokasi ~/.ssh/id_ed25519. Jika berkas itu sudah ada, pilih nama lain, misalnya ~/.ssh/id_ed25519_github, agar kunci lama tidak tertimpa. Selanjutnya, buat passphrase, yaitu frasa sandi yang mengenkripsi kunci privat ketika disimpan. Passphrase yang kuat membuat berkas kunci yang tercuri lebih sulit digunakan.

Jika perangkat atau layanan Anda tidak mendukung Ed25519 karena batasan kompatibilitas atau kebijakan kriptografi, periksa petunjuk administrator terlebih dahulu. Salah satu alternatif yang masih didukung sejumlah layanan adalah RSA 4096-bit:

ssh-keygen -t rsa -b 4096 -C "nama@contoh.com"

4. Lindungi berkas privat dan aktifkan ssh-agent

Direktori ~/.ssh sebaiknya hanya dapat diakses oleh pemilik akun. Jika diperlukan, rapikan izinnya. Sesuaikan nama berkas dengan lokasi kunci yang Anda pilih:

chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519

ssh-agent adalah proses yang menyimpan kunci yang telah dibuka untuk digunakan oleh klien SSH. Dengan begitu, Anda tidak perlu mengetik passphrase setiap kali Git meminta autentikasi. Jika sesi desktop Anda sudah menyediakan agen SSH, gunakan agen yang sedang berjalan. Jika belum, pada terminal Bash atau Zsh Anda dapat memulai agen untuk sesi tersebut:

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

Ganti jalur pada ssh-add jika Anda menggunakan nama khusus. Perintah terakhir menampilkan identitas yang sedang dimuat. Bila muncul pesan bahwa agen tidak dapat dihubungi, periksa apakah SSH_AUTH_SOCK tersedia atau apakah lingkungan desktop sudah mengelola agen secara otomatis. Tidak perlu menjalankan banyak agen sekaligus.

5. Tambahkan hanya kunci publik ke GitHub atau GitLab

Tampilkan isi kunci publik. Akhiran .pub penting: jangan sampai Anda keliru menyalin kunci privat.

cat ~/.ssh/id_ed25519.pub

Salin satu baris yang ditampilkan, lalu tambahkan ke akun layanan:

  • GitHub: buka Settings → SSH and GPG keys → New SSH key. Beri judul yang menjelaskan perangkat, misalnya “Laptop pribadi”, lalu tempel kunci publik.
  • GitLab: buka avatar akun → Edit profile → Access → SSH keys. Tempel kunci publik, beri judul, dan atur masa berlaku bila tersedia.

GitHub dan GitLab menjelaskan proses ini dalam dokumentasi resmi mereka: menambahkan SSH key ke GitHub dan menggunakan SSH key dengan GitLab. Kunci publik memang dirancang untuk dibagikan; kunci privat tidak pernah perlu diunggah ke situs tersebut.

6. Uji koneksi dan periksa identitas server

Uji autentikasi ke layanan yang Anda gunakan:

# GitHub
ssh -T git@github.com

# GitLab
ssh -T git@gitlab.com

Pada koneksi pertama, SSH mungkin menanyakan apakah identitas server boleh dipercaya. Jangan langsung mengetik yes tanpa pemeriksaan. Cocokkan sidik jari host yang ditampilkan dengan dokumentasi resmi: sidik jari SSH GitHub atau halaman konfigurasi instance GitLab Anda. Sidik jari host server berbeda dari sidik jari kunci pribadi milik Anda.

Jika berhasil, GitHub akan memberi pesan bahwa autentikasi berhasil tetapi layanan tidak menyediakan akses shell. Itu normal. GitLab biasanya menampilkan pesan sambutan. Keduanya menandakan bahwa server mengenali kunci Anda.

7. Pastikan repositori Git memakai alamat SSH

Kunci sudah terpasang, tetapi repositori lokal mungkin masih memakai alamat HTTPS. Periksa alamat remote dari direktori repositori:

git remote -v

Jika alamatnya diawali https://, ubah origin menjadi alamat SSH. Contoh GitHub berikut perlu disesuaikan dengan pemilik dan nama repositori Anda:

git remote set-url origin git@github.com:PEMILIK/NAMA-REPOSITORI.git

Untuk GitLab, pola umumnya adalah git@gitlab.com:GRUP/NAMA-REPOSITORI.git. Periksa kembali dengan git remote -v, lalu coba operasi Git yang diperlukan. Perubahan ini hanya mengubah alamat remote pada repositori lokal tersebut.

Jika autentikasi gagal

Pesan Permission denied (publickey) biasanya berarti server belum menerima kunci yang ditawarkan. Periksa secara berurutan: apakah kunci publik sudah ditambahkan ke akun yang benar, apakah kunci privat dimuat oleh ssh-agent, apakah alamat remote menunjuk ke host dan repositori yang benar, serta apakah SSH memakai berkas kunci yang Anda maksud. Untuk melihat proses pemilihan kunci dengan lebih rinci, gunakan mode verbose:

ssh -vT git@github.com

Jika memiliki beberapa kunci, Anda dapat menetapkan identitas khusus melalui ~/.ssh/config. Contoh berikut memaksa klien memakai kunci tertentu untuk GitHub:

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_github
    IdentitiesOnly yes

Simpan konfigurasi, lalu batasi izinnya dengan chmod 600 ~/.ssh/config. Panduan lanjutan tentang beberapa kunci dan konfigurasi host tersedia di dokumentasi SSH lanjutan GitLab.

Kebiasaan kecil yang menjaga akses tetap aman

  • Jangan pernah mengirim kunci privat melalui surel, chat, repositori, atau penyimpanan awan yang tidak terenkripsi.
  • Gunakan passphrase dan, bila memungkinkan, kunci terpisah untuk tiap perangkat. Jika laptop hilang, akses dari perangkat itu dapat dicabut tanpa harus mengganti semua kunci lain.
  • Periksa daftar SSH key di akun GitHub atau GitLab secara berkala. Hapus atau cabut kunci perangkat yang sudah tidak digunakan.
  • Jika kunci privat diduga bocor, segera cabut kunci publik pasangannya dari layanan, buat pasangan baru, lalu perbarui perangkat yang masih memerlukan akses.

Penutup

Menyiapkan SSH key di Linux bukan pekerjaan rumit: periksa kunci lama, buat pasangan Ed25519, lindungi kunci privat dengan passphrase, muat melalui agen, lalu daftarkan kunci publik ke layanan Git. Setelah remote repositori memakai alamat SSH dan sidik jari server diperiksa, aktivitas clone, pull, dan push menjadi lebih praktis tanpa mengorbankan disiplin keamanan.

Referensi resmi

Commenting 101: “Be kind, and respect each other” // Bersikaplah baik, dan saling menghormati (Indonesian) // Soyez gentils et respectez-vous les uns les autres (French) // Sean amables y respétense mutuamente (Spanish) // 待人友善,互相尊重 (Chinese) // كونوا لطفاء واحترموا بعضكم البعض (Arabic) // Будьте добры и уважайте друг друга (Russian) // Seid freundlich und respektiert einander (German) // 親切にし、お互いを尊重し合いましょう (Japanese) // दयालु बनें, और एक दूसरे का सम्मान करें (Hindi) // Siate gentili e rispettatevi a vicenda (Italian)

Tinggalkan Balasan