安全性
GitHub App 權限
Skipbox CI、Skipbox (personal) 和選用的 Skipbox Migrate 這幾個 App 要求的每項權限、Skipbox 用它們做什麼,以及 Runner App 不要求哪些權限。
Skipbox CI(組織)
| 權限 | 存取 | Skipbox 用它做什麼 |
|---|---|---|
| Organization: Self-hosted runners | Read and write | 為每個需要 Runner 的作業新增一個 Runner,作業結束時移除 |
| Repository: Actions | Read and write | 得知作業何時在等候 Runner、在控制台上列出你的作業、讀取最近 30 天的執行來推薦方案,並重新執行 Skipbox 機器在作業途中停止的作業 |
| Repository: Metadata | Read | 儲存庫名稱,以及啟動執行的人的權限(你的專屬機器只執行你團隊的程式碼) |
| Account: Email addresses | Read | 你的電子郵件地址,用於試用和帳單的通知信 |
這個 App 無法讀取你的程式碼。每個作業會在自己的 VM 裡自行 checkout 你的程式碼。
Skipbox (personal)
| 權限 | 存取 | Skipbox 用它做什麼 |
|---|---|---|
| Repository: Administration | Read and write | 為單一作業在作業所屬的儲存庫上新增一個 Runner,作業結束時移除 |
| Repository: Actions | Read and write | 和上面相同,並在控制台上顯示你的工作流程檔案 |
| Repository: Metadata | Read | 儲存庫名稱,以及啟動執行的人的權限(你的專屬機器只執行你團隊的程式碼) |
在個人帳號上,GitHub 只允許擁有 Administration 權限的 App 在儲存庫上註冊 Runner。這項權限也涵蓋儲存庫的設定、協作者和部署金鑰。Skipbox 只用它呼叫 Runner 的端點。
Skipbox Migrate(選用)
第三個 App,只用於帳號頁面上的開啟 Pull Request。你只需要把它安裝在自己選的儲存庫上,也可以不裝:改成複製提示給你的程式設計代理。
| 權限 | 存取 | Skipbox 用它做什麼 |
|---|---|---|
| Repository: Contents | Read and write | 讀取 .github/workflows 裡的檔案,並把修改過的檔案 commit 到 skipbox/run-ci-on-skipbox 分支 |
| Repository: Workflows | Read and write | 修改 .github/workflows 裡的任何檔案時,GitHub 都會要求這項權限 |
| Repository: Pull requests | Read and write | 從那個分支開一個標題為「Run CI on Skipbox」的 Pull Request,或更新已經開著的那一個 |
| Repository: Metadata | Read | 儲存庫的預設分支 |
這個 Pull Request 只會修改控制台推薦的作業的 runs-on: 行,說明中會列出每個作業的舊標籤和新標籤。Skipbox 絕不會推送到你的預設分支或任何其他分支,也絕不會合併:在你合併之前,什麼都不會改變。它只修改原本是 GitHub 託管 Ubuntu 標籤的那一行。runs-on 是其他標籤或運算式(例如矩陣的值)的作業,以及呼叫可重複使用工作流程的作業,會列在說明中,讓你手動修改。所有作業都在 Skipbox 上執行後,你就可以解除安裝它。
Skipbox CI 和 Skipbox (personal) 不要求的權限
Contents、Workflows、Secrets 和 Pull requests。這兩個 App 絕不會修改工作流程、絕不推送,也絕不開 Pull Request;只有在你按開啟 Pull Request 時,Skipbox Migrate 才會這麼做。Actions 的寫入只用來重新執行 Skipbox 機器在作業途中停止的作業:不會啟動其他任何執行,也不會取消任何執行。
作業的 VM 裡有什麼
和任何 Runner 一樣,GitHub 會把你的程式碼、工作流程傳給作業的 secrets,以及這個作業的權杖送到作業的 VM。作業執行的程式碼可以讀取它們。它們只留在那台 VM 裡:全新的 VM 會連同它們一起刪除,你的專屬機器則在每個作業後刪除 Runner 的憑證和作業 checkout 中的權杖。從 2026 年 11 月 13 日起,checkout 本身會留在那裡,供組織之後的作業使用;開啟「每個作業都用新 VM」,每個作業就會用一台全新的機器。請見 VM 隔離。
變更或移除存取權
在 GitHub 上開啟 App 的 Configure 頁面,就能變更它可以使用哪些儲存庫,或解除安裝。請見取消和解除安裝。
更新於 2026年11月13日