n8n에서 GitLab Personal Access Token 생성

 

GitLab Personal Access Token 생성할 때 선택할 수 있는 Scope(범위)

 

 

 

역할(Role)

• 프로젝트 / 그룹에 부여되는 사용자 권한 레벨이에요.
• 대표적으로:
  • Guest → 이슈 보기 정도
  • Reporter → 코드 읽기 가능
  • Developer → 브랜치 생성, 코드 푸시, 파이프라인 실행 가능
  • Maintainer → 설정 변경, Protected Branch 관리
  • Owner → 그룹/프로젝트 전체 제어 (최상위 권한, 그룹에만 존재)

 

범위 선택 (토큰에 부여된 권한 수준)

• api
  👉 모든 API 엔드포인트에 대한 읽기/쓰기 권한 (가장 강력, 사실상 슈퍼권한)
• read_api
  👉 API 읽기 전용 (패키지 레지스트리 포함)
• create_runner / manage_runner
  👉 GitLab Runner 관련 (보통 n8n에서 안 씀)
• k8s_proxy
  👉 Kubernetes API 호출용 (GitLab Agent for K8s 쓸 때만 필요)
• self_rotate
  👉 토큰이 스스로 갱신 가능 (특수한 자동화 환경에서만 필요)
• read_repository
  👉 레포지토리 pull 전용
• write_repository
  👉 레포지토리 pull + push
• ai_features
  👉 GitLab Duo AI 기능 관련 (n8n과는 무관)

 

 

🔑 n8n에서 쓸 때 권한 선택 가이드

1. 레포지토리 읽기만 필요
   → ✅ read_repository
2. 레포지토리 읽기/쓰기 필요
   → ✅ write_repository (이 안에 읽기도 포함됨)
3. 이슈, 파이프라인, 프로젝트 설정 등까지 건드려야 함
   → ✅ api (최소권한 원칙에는 어긋나지만, 가장 범용적)

 

 

n8n 연결할 때는 보통 Developer 역할 계정 + read_repository 또는 write_repository 스코프 토큰이면 충분합니다.
(이슈/머지리퀘/파이프라인까지 n8n에서 건드리려면 Developer 이상 + api 스코프)

 

----

 

https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.n8n/?utm_source=n8n_app&utm_medium=node_settings_modal-credential_link&utm_campaign=n8n-nodes-base.n8n#generate-audit

n8n | n8n Docs

 

 

https://docs.n8n.io/api/api-reference/#tag/Workflow/paths/~1workflows~1%7Bid%7D/put

API reference | n8n Docs

 

 

 

https://blog.pages.kr/3195

n8n 워크플로우, GitHub 백업으로 안전하게 관리하기