본문으로 건너뛰기
NEW · Blast Radius: 유출된 API 키 대응 플레이북 (AWS·GCP·Azure)
스캔 소스

GitLab 연동

활성화한 GitLab 저장소 대상의 접근 가능한 브랜치 이력을 검사합니다. 작업량과 권한에 따른 제한이 있습니다.

주요 기능

  • GitLab.com과 네트워크에서 접근 가능한 자체 호스팅 GitLab 연결
  • Cremit의 OAuth 또는 액세스 토큰 연결 경로
  • 연결 권한으로 볼 수 있는 프로젝트를 별도 검사 대상으로 발견
  • 작업 한도와 대체 검사 방식에 따라 여러 작업에 나눠 브랜치 변경 내용 검사

사전 요구사항

  1. 1검사할 프로젝트와 저장소를 읽을 수 있는 GitLab 계정 또는 토큰
  2. 2스캔 소스를 추가하고 관리할 수 있는 Cremit 계정
  3. 3자체 호스팅 GitLab을 쓴다면 Cremit에서 해당 인스턴스에 접근할 수 있는 네트워크

단계별 설정 가이드

연동에 필요한 설정 단계를 순서대로 확인하세요.

어디까지 검사하나요?

Cremit은 GitLab 연결이 볼 수 있는 프로젝트를 찾아 저장소 검사 대상으로 만듭니다. 그중 검사할 대상을 활성화해야 합니다. 연결했다는 이유만으로 조직의 모든 프로젝트에 접근할 수 있거나 발견된 대상을 모두 검사했다고 볼 수 없습니다. 새로 발견된 프로젝트도 실제 대상 목록에서 확인하세요.

활성화한 저장소는 일반적으로 브랜치의 커밋 변경 내용에서 지원하는 파일을 검사합니다. 큰 저장소, 클론 실패 또는 API 대체 방식에서는 한 작업이 기본 브랜치로 좁혀지거나 커밋·파일 한도에서 멈출 수 있습니다. 끝나지 않은 내용은 후속 작업에서 이어질 수 있습니다. 저장소 범위를 판단할 때는 브랜치 진행 상황, 완료된 실행, 제외 항목과 연결 오류를 함께 보세요. 이 연결은 GitLab 이슈 본문이나 Merge Request 대화 본문을 검사하지 않습니다.

GitLab 연결하기

Cremit Platform의 Configuration → Scan Sources에서 GitLab 소스를 추가하세요. 연결 화면에 표시되는 GitLab.com OAuth, 자체 호스팅 OAuth 앱 또는 액세스 토큰 경로 중 맞는 방식을 선택합니다. 검사할 프로젝트에 필요한 접근 권한만 부여하세요. 자체 호스팅 URL을 입력해도 사설망에 자동으로 접근할 수 있는 것은 아닙니다.

승인 후 발견된 프로젝트 대상을 살펴보고 필요한 저장소를 활성화합니다. 프로젝트가 없다면 GitLab 계정 또는 토큰 권한과 인스턴스 URL을 확인하고 대상을 다시 발견하세요. 대상은 있지만 완료된 검사가 없다면 결과가 깨끗하다고 판단하기 전에 작업 상태를 확인해야 합니다.

저장소 한 곳에서 확인하기

직접 관리하는 저장소의 활성화된 브랜치에 작동하지 않는 예시 문자열을 커밋하세요. 검사가 완료되면 대상, 브랜치 진행 상황과 발견 위치를 확인합니다. 실제로 작동하는 자격증명은 시험에 쓰지 마세요. 결과가 나오는 시점은 작업 일정, 저장소 크기, 연결 상태와 남은 작업량에 따라 달라집니다. 푸시 뒤 정해진 분 안에 발견된다고 보장할 수 없습니다.

실제 발견 건은 소스 위치와 지원하는 발급처 확인 결과를 보고 현재 서비스 담당자를 찾으세요. GitLab에서 텍스트만 지워도 자격증명은 무효가 되지 않습니다. 노출이 확인된 키는 담당자가 발급처에서 교체하거나 폐기하고, 의존하는 작업을 점검해야 합니다.

원자료

GitLab 프로젝트 API와 접근 범위

GitLab 브랜치 API

GitLab OAuth 앱

Cremit 검사 범위

이 연동과 관련된 읽을거리

지금 시작하기

GitLab 연동에 필요한 설정과 권한을 가이드에서 확인하세요.