# Permessi della GitHub App

> Ogni permesso che chiedono le app Skipbox CI, Skipbox (personal) e la facoltativa Skipbox Migrate, cosa ne fa Skipbox, e cosa non chiedono le app dei runner.

## Skipbox CI (organizzazioni)

| Permesso | Accesso | Cosa ne fa Skipbox |
|---|---|---|
| Organization: Self-hosted runners | Read and write | Aggiunge un runner per ogni job che ne chiede uno, e lo rimuove quando il job finisce |
| Repository: Actions | Read and write | Vede quando un job aspetta il suo runner, elenca i tuoi job nella dashboard, legge le esecuzioni degli ultimi 30 giorni per consigliare i piani, e riesegue un job la cui macchina Skipbox si è fermata a metà |
| Repository: Metadata | Read | I nomi dei repository, e l'accesso della persona che ha avviato un'esecuzione (sulla macchina del tuo account gira solo il codice del tuo team) |
| Account: Email addresses | Read | Il tuo indirizzo, per le email della prova e della fatturazione |

Questa app non può leggere il tuo codice. Ogni job fa il checkout del tuo codice da solo, dentro la sua VM.

## Skipbox (personal)

| Permesso | Accesso | Cosa ne fa Skipbox |
|---|---|---|
| Repository: Administration | Read and write | Aggiunge un runner al repository del job per un solo job, e lo rimuove quando il job finisce |
| Repository: Actions | Read and write | Lo stesso di sopra, e mostra i tuoi file di workflow nella dashboard |
| Repository: Metadata | Read | I nomi dei repository, e l'accesso della persona che ha avviato un'esecuzione (sulla macchina del tuo account gira solo il codice del tuo team) |

Su un account personale, GitHub registra i runner su un repository solo con il permesso Administration. Questo copre anche le impostazioni, i collaboratori e le deploy key del repository. Skipbox lo usa solo per gli endpoint dei runner.

## Skipbox Migrate (facoltativa)

Una terza app, solo per **Apri una pull request** nella pagina del tuo account. La installi solo sui repository che scegli, e puoi farne a meno: copia invece il prompt per il tuo agente di coding.

| Permesso | Accesso | Cosa ne fa Skipbox |
|---|---|---|
| Repository: Contents | Read and write | Legge i file in `.github/workflows`, e fa il commit di quelli modificati sul branch `skipbox/run-ci-on-skipbox` |
| Repository: Workflows | Read and write | GitHub lo chiede per modificare qualsiasi file in `.github/workflows` |
| Repository: Pull requests | Read and write | Apre una pull request da quel branch, intitolata "Run CI on Skipbox", o aggiorna quella già aperta |
| Repository: Metadata | Read | Il branch di default del repository |

La pull request cambia solo le righe `runs-on:` dei job che consiglia la tua dashboard, e la sua descrizione elenca ogni job con la sua vecchia e nuova etichetta. Skipbox non fa mai push sul tuo branch di default né su nessun altro branch, e non fa mai il merge: niente cambia finché non fai tu il merge. Cambia una riga solo quando contiene un'etichetta Ubuntu ospitata da GitHub. I job il cui `runs-on` è un'altra etichetta o un'espressione (come un valore di matrice), e i job che chiamano un workflow riutilizzabile, sono elencati nella descrizione da cambiare a mano. Quando ogni job gira su Skipbox, puoi disinstallarla.

## Cosa non chiedono Skipbox CI e Skipbox (personal)

Contents, Workflows, Secrets e Pull requests. Queste due app non modificano mai un workflow, non fanno mai push e non aprono mai una pull request; lo fa solo Skipbox Migrate, quando premi **Apri una pull request**. Actions viene scritto solo per rieseguire un job la cui macchina Skipbox si è fermata a metà: nessun'altra esecuzione viene avviata, e nessuna viene annullata.

## Cosa contiene la VM di un job

Come su qualsiasi runner, GitHub manda alla VM del job il tuo codice, i secret che il tuo workflow passa al job e un token per quel job. Il codice che il job esegue può leggerli. Restano in quella VM: una VM nuova viene cancellata con loro, e la macchina del tuo account cancella le credenziali del runner e il token nel checkout del job dopo ogni job. Dal 13 novembre 2026 il checkout stesso resta lì per i job successivi della tua organizzazione; “VM nuova per ogni job” dà a ogni job una macchina nuova. Vedi [Isolamento delle VM](https://docs.skipbox.dev/it/isolation).

## Cambia o rimuovi l'accesso

Su GitHub, apri la pagina **Configure** dell'app per cambiare i repository che può usare, o per disinstallarla. Vedi [Disdire e disinstallare](https://docs.skipbox.dev/it/cancel).

Aggiornata il giorno 2026-11-13 · https://docs.skipbox.dev/it/permissions
