Pin GitHub Actions ke commit SHA, versinya di komentar
- GitHub Actions
- Keamanan
Action di GitHub Actions biasanya dipanggil dengan tag, misalnya actions/checkout@v7.0.1. Tag itu bisa dipindah ke commit lain. Panduan keamanan GitHub Actions (buka di tab baru) menyebut bahwa jika repo action disusupi, orang itu bisa mengalihkan atau menghapus tag. Commit SHA penuh mengikuti isi commit, jadi isinya tidak bisa diganti tanpa mengubah SHA-nya.
Panduan itu punya bagian khusus tentang pin ke SHA penuh. Karena itu, saya menulis SHA lengkap di setiap baris uses: yang memanggil action dari luar, lalu menaruh versinya di komentar.
Apa yang berubah di PR #9
PR #9 (buka di tab baru) mengubah 7 berkas. Ada 19 baris ditambah dan 17 baris dihapus. Commit hasilnya, 809cb07 (buka di tab baru), bertanggal 16 November 2026, pukul 14.05 WIB.
Jumlah pin di setiap workflow
Sekarang ada 16 pemanggilan action dari luar repo, masing-masing memakai SHA penuh:
| Berkas workflow | Baris uses: |
|---|---|
check.yml |
2 |
test.yml |
3 |
playwright.yml |
3 |
unlighthouse.yml |
3 |
size.yml |
2 |
release.yml |
3 |
release.yml juga memanggil lima workflow lokal dengan ./.github/workflows/. Pemanggilan lokal tidak memakai ref, jadi tidak ada SHA yang bisa dipasang.
Cara memasang satu action
- Cari tag rilisbuka halaman Releases repo action itu, lalu catat tag yang dipakai, misalnya v7.0.1.
- Ambil SHAjalankan gh api repos/actions/checkout/commits/v7.0.1 --jq .sha dengan tag persis seperti di workflow.
- Tulis SHA dan versiSHA di depan, versi di komentar, seperti uses: actions/checkout@<SHA> # v7.0.1.
- Matikan persist-credentialsisi with: di langkah checkout dengan persist-credentials: false.
Ini contoh dari .github/workflows/check.yml:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: falseMenurut README actions/checkout (buka di tab baru), secara bawaan checkout menyimpan token supaya langkah berikutnya bisa memakai git yang perlu autentikasi. Dengan persist-credentials: false, token itu tidak disimpan untuk git.
Saya memasang opsi ini di setiap langkah checkout, di keenam workflow. Job deploy di release.yml juga memegang token Cloudflare, jadi saya tidak mau ada kredensial lain tertinggal di ruang kerjanya.
Yang belum terbukti
Saya belum melihat Dependabot memperbarui SHA sekaligus dengan komentar versinya. Repo ini belum pernah punya PR Dependabot untuk GitHub Actions. Empat PR Dependabot pertama, #1 sampai #4, semuanya untuk npm. Konfigurasi .github/dependabot.yml sudah memuat ekosistem github-actions. Panduan Dependabot untuk actions (buka di tab baru) membahas pembaruan actions, tetapi tidak menyebut pin SHA dengan komentar. Sampai ada PR yang membuktikannya, periksa SHA dan komentarnya setiap kali ada pembaruan.
