# GitHub App 권한

> Skipbox CI, Skipbox (personal), 선택 사항인 Skipbox Migrate 앱이 요청하는 모든 권한, Skipbox가 권한마다 하는 일, 실행기 앱이 요청하지 않는 것.

## Skipbox CI(조직)

| 권한 | 접근 | Skipbox가 하는 일 |
|---|---|---|
| Organization: Self-hosted runners | Read and write | 실행기를 요청하는 작업마다 실행기를 더하고, 작업이 끝나면 제거해요 |
| Repository: Actions | Read and write | 작업이 실행기를 기다리는 때를 보고, 대시보드에 작업을 나열하고, 요금제 추천을 위해 최근 30일의 실행을 읽고, Skipbox 머신이 작업 중에 멈춘 작업을 다시 실행해요 |
| Repository: Metadata | Read | 리포지토리 이름과, 실행을 시작한 사람의 권한(전용 머신에서는 팀의 코드만 돌아요) |
| Account: Email addresses | Read | 무료 체험과 청구 이메일을 위한 주소 |

이 앱은 코드를 읽을 수 없어요. 작업마다 자기 VM 안에서 코드를 직접 체크아웃해요.

## Skipbox (personal)

| 권한 | 접근 | Skipbox가 하는 일 |
|---|---|---|
| Repository: Administration | Read and write | 작업 하나를 위해 작업의 리포지토리에 실행기를 더하고, 작업이 끝나면 제거해요 |
| Repository: Actions | Read and write | 위와 같고, 대시보드에 워크플로 파일을 보여 줘요 |
| Repository: Metadata | Read | 리포지토리 이름과, 실행을 시작한 사람의 권한(전용 머신에서는 팀의 코드만 돌아요) |

개인 계정에서 GitHub는 Administration 권한이 있어야만 리포지토리에 실행기를 등록해요. 이 권한은 리포지토리의 설정, 협업자, 배포 키도 포함해요. Skipbox는 이 권한으로 실행기 엔드포인트만 호출해요.

## Skipbox Migrate(선택 사항)

계정 페이지의 **풀 리퀘스트 열기**만을 위한 세 번째 앱이에요. 고른 리포지토리에만 설치하고, 건너뛸 수도 있어요. 그때는 코딩 에이전트용 프롬프트를 복사하세요.

| 권한 | 접근 | Skipbox가 하는 일 |
|---|---|---|
| Repository: Contents | Read and write | `.github/workflows`의 파일을 읽고, 바뀐 파일을 `skipbox/run-ci-on-skipbox` 브랜치에 커밋해요 |
| Repository: Workflows | Read and write | `.github/workflows`의 파일을 바꾸려면 GitHub가 이 권한을 요구해요 |
| Repository: Pull requests | Read and write | 그 브랜치에서 "Run CI on Skipbox"라는 제목의 풀 리퀘스트를 하나 열거나, 이미 열린 것을 업데이트해요 |
| Repository: Metadata | Read | 리포지토리의 기본 브랜치 |

풀 리퀘스트는 대시보드가 추천하는 작업의 `runs-on:` 줄만 바꾸고, 설명에 작업마다 옛 레이블과 새 레이블을 적어요. Skipbox는 기본 브랜치나 다른 어떤 브랜치에도 푸시하지 않고, 머지하지도 않아요. 머지하기 전까지는 아무것도 바뀌지 않아요. 줄은 GitHub 호스팅 Ubuntu 레이블일 때만 바꿔요. `runs-on`이 다른 레이블이나 표현식(matrix 값 등)인 작업과, 재사용 워크플로를 호출하는 작업은 직접 바꾸도록 설명에 나열해요. 모든 작업이 Skipbox에서 돌면 이 앱은 제거해도 돼요.

## Skipbox CI와 Skipbox (personal)이 요청하지 않는 것

Contents, Workflows, Secrets, Pull requests예요. 이 두 앱은 워크플로를 바꾸지도, 푸시하지도, 풀 리퀘스트를 열지도 않아요. 그건 **풀 리퀘스트 열기**를 눌렀을 때 Skipbox Migrate만 해요. Actions에 쓰는 건 Skipbox 머신이 작업 중에 멈춘 작업을 다시 실행할 때뿐이에요. 다른 실행을 시작하거나 취소하는 일은 없어요.

## 작업의 VM이 가진 것

어느 실행기에서나 그렇듯, GitHub는 작업의 VM에 코드, 워크플로가 작업에 넘기는 시크릿, 그 작업을 위한 토큰을 보내요. 작업이 돌리는 코드는 그것을 읽을 수 있어요. 그것들은 그 VM에 머물러요. 새 VM은 그것들과 함께 삭제되고, 전용 머신은 작업마다 실행기의 자격 증명과 작업 체크아웃의 토큰을 지워요. 2026년 11월 13일부터 체크아웃 자체는 조직의 다음 작업을 위해 거기에 남아요. ‘작업마다 새 VM’을 켜면 작업마다 새 머신에서 돌아요. [VM 분리](https://docs.skipbox.dev/ko/isolation)를 보세요.

## 접근 바꾸기와 제거하기

GitHub에서 앱의 **Configure** 페이지를 열어, 쓸 수 있는 리포지토리를 바꾸거나 앱을 제거하세요. [해지와 앱 제거](https://docs.skipbox.dev/ko/cancel)를 보세요.

2026-11-13 업데이트 · https://docs.skipbox.dev/ko/permissions
