# Kebenaran GitHub App

> Setiap kebenaran yang diminta oleh app Skipbox CI, Skipbox (personal) dan Skipbox Migrate yang pilihan, apa yang dilakukan Skipbox dengan setiap satu, dan apa yang tidak diminta oleh app runner.

## Skipbox CI (organisasi)

| Kebenaran | Akses | Apa yang dilakukan Skipbox dengannya |
|---|---|---|
| Organization: Self-hosted runners | Read and write | Menambah runner bagi setiap job yang memintanya, dan membuangnya apabila job tamat |
| Repository: Actions | Read and write | Melihat bila job menunggu runner-nya, menyenaraikan job anda pada papan pemuka, membaca larian anda bagi 30 hari lepas untuk mengesyorkan pelan, dan menjalankan semula job yang mesin Skipbox-nya berhenti di tengah job |
| Repository: Metadata | Read | Nama repositori, dan akses orang yang memulakan larian (hanya kod pasukan anda berjalan pada mesin yang dihoskan Skipbox khusus untuk akaun anda) |
| Account: Email addresses | Read | Alamat anda, untuk e-mel percubaan dan pengebilan |

App ini tidak boleh membaca kod anda. Setiap job membuat checkout kod anda sendiri, di dalam VM-nya sendiri.

## Skipbox (personal)

| Kebenaran | Akses | Apa yang dilakukan Skipbox dengannya |
|---|---|---|
| Repository: Administration | Read and write | Menambah runner pada repositori job untuk satu job, dan membuangnya apabila job tamat |
| Repository: Actions | Read and write | Sama seperti di atas, dan menunjukkan fail workflow anda pada papan pemuka |
| Repository: Metadata | Read | Nama repositori, dan akses orang yang memulakan larian (hanya kod pasukan anda berjalan pada mesin khusus untuk anda) |

Pada akaun peribadi, GitHub mendaftarkan runner pada repositori hanya dengan kebenaran Administration. Kebenaran itu juga meliputi tetapan, kolaborator dan deploy key repositori. Skipbox hanya memanggil endpoint runner dengannya.

## Skipbox Migrate (pilihan)

App ketiga, hanya untuk **Buka pull request** pada halaman akaun anda. Anda memasangnya hanya pada repositori yang anda pilih, dan anda boleh melangkaunya: salin prompt untuk ejen pengekodan anda.

| Kebenaran | Akses | Apa yang dilakukan Skipbox dengannya |
|---|---|---|
| Repository: Contents | Read and write | Membaca fail dalam `.github/workflows`, dan commit fail yang diubah ke branch `skipbox/run-ci-on-skipbox` |
| Repository: Workflows | Read and write | GitHub memintanya untuk mengubah mana-mana fail dalam `.github/workflows` |
| Repository: Pull requests | Read and write | Membuka satu pull request dari branch itu, bertajuk "Run CI on Skipbox", atau mengemas kini pull request yang sudah dibuka |
| Repository: Metadata | Read | Branch lalai repositori |

Pull request itu hanya mengubah baris `runs-on:` job yang disyorkan oleh papan pemuka anda, dan penerangannya menyenaraikan setiap job dengan label lama dan baharunya. Skipbox tidak pernah push ke branch lalai anda atau mana-mana branch lain, dan tidak pernah merge: tiada apa-apa berubah sehingga anda merge. Ia mengubah sesuatu baris hanya apabila baris itu memegang label Ubuntu yang dihoskan GitHub. Job yang `runs-on`-nya label lain atau ungkapan (seperti nilai matrix), dan job yang memanggil reusable workflow, disenaraikan dalam penerangan untuk diubah secara manual. Apabila setiap job berjalan di Skipbox, anda boleh menyahpasangnya.

## Apa yang tidak diminta oleh Skipbox CI dan Skipbox (personal)

Contents, Workflows, Secrets dan Pull requests. Kedua-dua app ini tidak pernah mengubah workflow, tidak pernah push, dan tidak pernah membuka pull request; hanya Skipbox Migrate yang berbuat demikian, apabila anda menekan **Buka pull request**. Actions hanya ditulis untuk menjalankan semula job yang mesin Skipbox-nya berhenti di tengah job: tiada larian lain dimulakan, dan tiada yang dibatalkan.

## Apa yang dipegang oleh VM job

Seperti pada mana-mana runner, GitHub menghantar kod anda, rahsia yang dihantar workflow anda kepada job, dan token untuk job itu ke VM job. Kod yang dijalankan job boleh membacanya. Semuanya kekal dalam VM itu: VM baharu dipadam bersamanya, dan mesin khusus untuk anda memadam bukti kelayakan runner dan token dalam checkout job selepas setiap job. Mulai 13 November 2026, checkout itu sendiri kekal di sana untuk job organisasi anda yang seterusnya; “VM baharu bagi setiap job” memberi setiap job mesin baharu. Lihat [Pengasingan VM](https://docs.skipbox.dev/ms/isolation).

## Tukar atau buang akses

Di GitHub, buka halaman **Configure** app untuk menukar repositori yang boleh digunakannya, atau untuk menyahpasangnya. Lihat [Batal dan nyahpasang](https://docs.skipbox.dev/ms/cancel).

Dikemas kini 2026-11-19 · https://docs.skipbox.dev/ms/permissions
