# Permissões do GitHub App

> Cada permissão que os apps Skipbox CI, Skipbox (personal) e o opcional Skipbox Migrate pedem, o que o Skipbox faz com cada uma e o que os apps de executor não pedem.

## Skipbox CI (organizações)

| Permissão | Acesso | O que o Skipbox faz com ela |
|---|---|---|
| Organization: Self-hosted runners | Read and write | Adiciona um executor para cada trabalho que pede um, e o remove quando o trabalho termina |
| Repository: Actions | Read and write | Vê quando um trabalho espera o executor, lista os seus trabalhos no painel, lê as suas execuções dos últimos 30 dias para recomendar planos e roda de novo um trabalho cuja máquina do Skipbox parou no meio |
| Repository: Metadata | Read | Os nomes dos repositórios e o acesso da pessoa que iniciou uma execução (só o código da sua equipe roda em uma máquina que o Skipbox hospeda só para a sua conta) |
| Account: Email addresses | Read | O seu endereço, para os e-mails do teste e da cobrança |

Este app não consegue ler o seu código. Cada trabalho faz o checkout do seu código ele mesmo, dentro da própria VM.

## Skipbox (personal)

| Permissão | Acesso | O que o Skipbox faz com ela |
|---|---|---|
| Repository: Administration | Read and write | Adiciona um executor ao repositório do trabalho para um trabalho, e o remove quando o trabalho termina |
| Repository: Actions | Read and write | O mesmo de cima, e mostra os seus arquivos de workflow no painel |
| Repository: Metadata | Read | Os nomes dos repositórios e o acesso da pessoa que iniciou uma execução (só o código da sua equipe roda na sua máquina dedicada) |

Em uma conta pessoal, o GitHub só registra executores em um repositório com a permissão Administration. Ela também cobre as configurações do repositório, os colaboradores e as deploy keys. O Skipbox só chama os endpoints de executores com ela.

## Skipbox Migrate (opcional)

Um terceiro app, só para **Abrir um pull request** na página da sua conta. Você o instala só nos repositórios que escolher, e pode dispensá-lo: copie o prompt para o seu agente de programação.

| Permissão | Acesso | O que o Skipbox faz com ela |
|---|---|---|
| Repository: Contents | Read and write | Lê os arquivos em `.github/workflows` e faz commit dos que mudaram no branch `skipbox/run-ci-on-skipbox` |
| Repository: Workflows | Read and write | O GitHub a exige para alterar qualquer arquivo em `.github/workflows` |
| Repository: Pull requests | Read and write | Abre um pull request a partir desse branch, com o título "Run CI on Skipbox", ou atualiza o que já estiver aberto |
| Repository: Metadata | Read | O branch padrão do repositório |

O pull request muda só as linhas `runs-on:` dos trabalhos que o seu painel recomenda, e a descrição dele lista cada trabalho com o rótulo antigo e o novo. O Skipbox nunca faz push no seu branch padrão nem em nenhum outro branch, e nunca faz merge: nada muda até você fazer o merge. Ele só muda uma linha quando ela tem um rótulo Ubuntu hospedado pelo GitHub. Os trabalhos cujo `runs-on` é outro rótulo ou uma expressão (como um valor de matriz), e os trabalhos que chamam um workflow reutilizável, aparecem na descrição para você mudar à mão. Quando todos os trabalhos rodarem no Skipbox, você pode desinstalá-lo.

## O que o Skipbox CI e o Skipbox (personal) não pedem

Contents, Workflows, Secrets e Pull requests. Esses dois apps nunca alteram um workflow, nunca fazem push e nunca abrem um pull request; só o Skipbox Migrate faz isso, quando você clica em **Abrir um pull request**. A permissão Actions só é usada para escrita ao rodar de novo um trabalho cuja máquina do Skipbox parou no meio: nenhuma outra execução é iniciada, e nenhuma é cancelada.

## O que a VM de um trabalho tem

Como em qualquer executor, o GitHub envia à VM do trabalho o seu código, os secrets que o seu workflow passa ao trabalho e um token para aquele trabalho. O código que o trabalho roda pode lê-los. Eles ficam naquela VM: uma VM nova é excluída com eles, e a sua máquina dedicada apaga as credenciais do executor e o token no checkout do trabalho depois de cada trabalho. A partir de 13 de novembro de 2026, o próprio checkout fica lá para os próximos trabalhos da sua organização; Limpar a cada trabalho dá a cada trabalho uma máquina nova. Veja [Isolamento das VMs](https://docs.skipbox.dev/pt-br/isolation).

## Mude ou remova o acesso

No GitHub, abra a página **Configure** do app para mudar quais repositórios ele pode usar, ou para desinstalá-lo. Veja [Cancelar e desinstalar](https://docs.skipbox.dev/pt-br/cancel).

Atualizado em 2026-11-19 · https://docs.skipbox.dev/pt-br/permissions
