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

- Link: https://legawa.com/teknologi/ssh-key-ed25519-linux-github-gitlab/
- Published: 2026-11-16T09:26:49+07:00
- Author: Cahya

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](https://i0.wp.com/legawa.com/wp-content/uploads/2026/11/
ssh-key-linux-ed25519.webp?resize=480%2C270&ssl=1)

## 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:

    ```wp-block-code
    ssh -V
    ```

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

    ```wp-block-code
    # 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:

    ```wp-block-code
    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:

    ```wp-block-code
    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:

    ```wp-block-code
    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:

    ```wp-block-code
    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:

    ```wp-block-code
    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:

    ```wp-block-code
    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.

    ```wp-block-code
    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](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=linux)
dan [menggunakan SSH key dengan GitLab](https://docs.gitlab.com/user/ssh/). 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:

    ```wp-block-code
    # 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](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/githubs-ssh-key-fingerprints)
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:

    ```wp-block-code
    git remote -v
    ```

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

    ```wp-block-code
    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:

    ```wp-block-code
    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:

    ```wp-block-code
    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](https://docs.gitlab.com/user/ssh_advanced/).

## 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

 * [OpenBSD manual: ssh-keygen](https://man.openbsd.org/ssh-keygen).
 * [OpenBSD manual: ssh-add](https://man.openbsd.org/ssh-add).
 * [GitHub Docs: membuat SSH key dan menambahkannya ke ssh-agent](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent?platform=linux).
 * [GitHub Docs: menambahkan SSH key ke akun](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=linux).
 * [GitLab Docs: menggunakan SSH keys](https://docs.gitlab.com/user/ssh/).
