PROSEDUR KONFIGURASI SSH KEY GITHUB PADA SERVER UBUNTU
Dokumen: SOP Infrastruktur dan Deployment
Versi: 1.0
Platform: Ubuntu Server
Repository: GitHub
Metode Autentikasi: SSH Key (Ed25519)
1. Tujuan
Dokumen ini menjelaskan prosedur konfigurasi autentikasi SSH Key antara server Ubuntu dan GitHub untuk memungkinkan server melakukan operasi Git, seperti clone, pull, dan fetch tanpa menggunakan username dan password akun GitHub.
Prosedur ini bertujuan untuk:
Mengamankan autentikasi server ke GitHub.
Menghindari penggunaan password akun GitHub.
Mempermudah proses deployment aplikasi.
Memastikan server dapat mengakses repository private maupun public sesuai hak akses yang diberikan.
2. Ruang Lingkup
Prosedur ini berlaku untuk:
Ubuntu Server.
GitHub repository.
Aplikasi berbasis Laravel atau framework lainnya.
Server development, staging, maupun production.
3. Persyaratan
Sebelum memulai konfigurasi, pastikan:
Server Ubuntu sudah dapat mengakses internet.
Git sudah terinstal.
Memiliki akun GitHub.
Memiliki akses ke repository yang akan di-clone.
Memiliki akses SSH atau terminal ke server.
Periksa instalasi Git:
git --versionJika belum terinstal:
sudo apt update
sudo apt install git openssh-client -y4. Prosedur Konfigurasi SSH Key
4.1. Membuat SSH Key
Login ke server menggunakan user yang akan menjalankan deployment.
Contoh:
ssh dsudana@serverBuat SSH Key menggunakan algoritma Ed25519:
ssh-keygen -t ed25519 -C "dsudana@gmail.com"Ketika muncul pertanyaan lokasi penyimpanan:
Enter file in which to save the key:Tekan Enter untuk menggunakan lokasi default:
/home/dsudana/.ssh/id_ed25519Ketika diminta memasukkan passphrase, isi sesuai kebutuhan keamanan atau tekan Enter jika tidak menggunakan passphrase.
Hasil pembuatan SSH Key terdiri dari:
File | Fungsi |
|---|---|
id_ed25519 | Private Key |
id_ed25519.pub | Public Key |
Penting: Private Key tidak boleh dibagikan atau diunggah ke GitHub. Hanya Public Key yang boleh didaftarkan.
4.2. Mengaktifkan SSH Agent
Jalankan:
eval "$(ssh-agent -s)"Tambahkan private key ke SSH Agent:
ssh-add ~/.ssh/id_ed25519Periksa key yang sudah terdaftar:
ssh-add -l4.3. Mengambil Public Key
Tampilkan Public Key:
cat ~/.ssh/id_ed25519.pubSalin seluruh isi output yang dimulai dengan:
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5...Pastikan seluruh karakter tersalin dengan benar.
4.4. Mendaftarkan SSH Key ke GitHub
Login ke akun GitHub.
Buka halaman:
Isi konfigurasi:
Title:
dsudana-serverKey type:
Authentication KeyKey: Paste Public Key yang sudah disalin.
Klik Add SSH Key.
Setelah berhasil, SSH Key akan terdaftar pada akun GitHub.
5. Pengujian Koneksi GitHub
Jalankan perintah:
ssh -T git@github.comPada koneksi pertama, mungkin muncul konfirmasi fingerprint host GitHub.
Periksa fingerprint menggunakan dokumentasi resmi GitHub sebelum menyetujui koneksi.
Jika fingerprint sesuai, ketik:
yesJika konfigurasi berhasil, akan muncul pesan:
Hi dsudana! You've successfully authenticated,
but GitHub does not provide shell access.Pesan tersebut menunjukkan bahwa autentikasi SSH ke GitHub berhasil.
6. Prosedur Clone Repository
Setelah autentikasi berhasil, repository dapat di-clone menggunakan SSH URL.
Contoh repository:
git@github.com:dsudana/hijrahkreativa.gitMasuk ke direktori aplikasi:
cd /optClone repository:
git clone git@github.com:dsudana/hijrahkreativa.gitJika berhasil, direktori berikut akan terbentuk:
/opt/hijrahkreativaPeriksa isi direktori:
cd /opt/hijrahkreativa
ls -la7. Pengaturan Permission Direktori
Untuk menghindari masalah permission, proses Git sebaiknya dijalankan menggunakan user pemilik SSH Key.
Hindari menjalankan Git menggunakan sudo, karena SSH Key milik user dsudana tidak otomatis tersedia untuk user root.
Jika direktori aplikasi belum tersedia, buat direktori dengan:
sudo mkdir -p /opt/hijrahkreativa
sudo chown dsudana:dsudana /opt/hijrahkreativaKemudian jalankan clone:
git clone git@github.com:dsudana/hijrahkreativa.git /opt/hijrahkreativaJika repository sudah terlanjur dibuat oleh root, perbaiki kepemilikannya secara spesifik:
sudo chown -R dsudana:dsudana /opt/hijrahkreativaJangan mengubah kepemilikan seluruh direktori /opt tanpa memeriksa aplikasi dan service lain yang berjalan di dalamnya.
8. Prosedur Update Repository
Setelah repository berhasil di-clone, update kode aplikasi dapat dilakukan menggunakan Git Pull.
Masuk ke direktori aplikasi:
cd /opt/hijrahkreativaPeriksa status repository:
git statusPeriksa branch aktif:
git branchAmbil pembaruan dari GitHub:
git pull origin mainCatatan: Sesuaikan nama branch jika repository menggunakan branch selain main.
9. Troubleshooting
9.1. Error: Password Authentication Is Not Supported
Contoh pesan:
remote: Invalid username or token.
Password authentication is not supported for Git operations.Penyebab:
GitHub tidak lagi mendukung autentikasi password akun untuk operasi Git melalui HTTPS.
Solusi:
Gunakan SSH URL:
git clone git@github.com:dsudana/hijrahkreativa.git9.2. Error: Permission Denied (Publickey)
Contoh:
git@github.com: Permission denied (publickey).Penyebab:
Public Key belum didaftarkan ke GitHub.
SSH Agent belum memuat private key.
SSH Key dibuat oleh user yang berbeda.
Repository tidak memberikan akses kepada akun pemilik SSH Key.
Solusi:
Periksa key:
ssh-add -lJika belum terdaftar:
ssh-add ~/.ssh/id_ed25519Uji kembali:
ssh -T git@github.com9.3. Error: Repository Not Found
Contoh:
ERROR: Repository not found.Penyebab:
URL repository salah.
Repository private dan akun GitHub tidak memiliki akses.
SSH Key terdaftar pada akun GitHub yang berbeda.
Solusi:
Periksa URL repository dan hak akses akun GitHub.
9.4. Error: Could Not Open Directory
Penyebab: User tidak memiliki izin menulis pada direktori tujuan.
Solusi:
sudo chown -R dsudana:dsudana /opt/hijrahkreativaPastikan direktori yang diubah kepemilikannya memang hanya direktori aplikasi terkait.
10. Standar Keamanan
Untuk menjaga keamanan server dan repository, terapkan ketentuan berikut:
Jangan membagikan private key kepada pihak lain.
Jangan mengunggah private key ke repository GitHub.
Gunakan user Linux khusus untuk deployment jika memungkinkan.
Hindari menjalankan operasi Git dengan sudo.
Batasi akses SSH server hanya kepada administrator yang berwenang.
Gunakan passphrase untuk private key jika sesuai dengan mekanisme operasional server.
Untuk server production, pertimbangkan penggunaan GitHub Deploy Key dengan akses read-only apabila server hanya perlu mengambil kode dari satu repository.
11. Checklist Verifikasi
Sebelum proses deployment dilanjutkan, pastikan seluruh tahapan berikut sudah selesai.
Git terinstal pada Ubuntu Server.
SSH Key Ed25519 berhasil dibuat.
SSH Agent aktif.
Private Key berhasil dimuat ke SSH Agent.
Public Key berhasil didaftarkan ke GitHub.
Koneksi SSH ke GitHub berhasil.
Repository berhasil di-clone.
Permission direktori aplikasi sudah sesuai.
Git Pull berhasil dijalankan.
12. Referensi Resmi
GitHub: Connecting to GitHub with SSH
https://docs.github.com/en/authentication/connecting-to-github-with-sshGitHub: Generating a New SSH Key
https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agentGitHub: Adding a New SSH Key to Your Account
https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account
Dokumen ini menjadi standar prosedur konfigurasi koneksi GitHub pada Ubuntu Server untuk mendukung proses pengelolaan source code dan deployment aplikasi secara aman dan terstruktur.