GitLab 정보
GitLab 커넥터는 GitLab.com 그룹 또는 자체 관리형 인스턴스에서 프로젝트 메타데이터, 그룹 멤버십, 브랜치 보호, CI/CD 구성 및 (요금제와 토큰이 허용하는 경우) 감사 관련 이벤트를 읽습니다. 데이터는 Iru Compliance에서 작업 및 컨트롤에 매핑할 수 있는 아티팩트로 표시됩니다. Iru는 GitLab의PRIVATE-TOKEN 헤더를 사용하여 자격 증명을 전송하며, 일반적으로 선택한 그룹과 프로젝트 전반을 읽을 수 있도록 개인 액세스 토큰을 사용합니다.
작동 방식
GitLab의 REST API는PRIVATE-TOKEN 헤더로 인증합니다.
문서: Personal access tokens, REST authentication, Token scopes.
사전 요구 사항
- 컴플라이언스 대상 그룹 및 프로젝트에 대한 GitLab 액세스 권한.
- 멤버십 및 감사 유형 읽기가 필요한 그룹의 소유자 또는 Maintainer 권한(정확한 요구 사항은 컨트롤에 따라 다름).
- 자체 관리형 GitLab의 경우 Iru가
gitlab.com뿐만 아니라 인스턴스의 기본 URL을 대상으로 하는지 확인하세요.
보안 팀이 더 깊은 읽기를 요구하는 경우에만 범위를 추가하세요.
GitLab을 Iru에 연결
- GitLab
- Iru Compliance
Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
1
GitLab에 로그인
GitLab 인스턴스(gitlab.com 또는 자체 관리형 URL)를 열고 Iru가 읽을 네임스페이스에 대한 개인 액세스 토큰을 생성할 수 있는 사용자로 로그인합니다.
2
프로필 열기
오른쪽 상단의 아바타를 선택한 다음 Edit profile(일부 버전에서는 Preferences)을 선택합니다.
3
Access Tokens 열기
프로필의 왼쪽 사이드바에서 Access Tokens를 선택합니다(경우에 따라 User settings → Access Tokens 아래에 있음).
4
새 토큰 추가
Add new token(또는 Create personal access token)을 선택합니다.
5
이름, 만료 및 범위 설정
이름(예: Iru Compliance)을 입력합니다. 만료를 설정합니다(GitLab에서는 필수이며, 최대 기간은 관리자가 제한할 수 있습니다). 이 문서의 사전 요구 사항에 나열된 읽기 범위를 선택합니다.
6
토큰 생성 및 복사
토큰을 생성하고 즉시 복사합니다. GitLab은 토큰을 한 번만 표시합니다. 토큰은 일반적으로 **
glpat-**로 시작합니다.Iru Compliance 탭에서 계속 진행하세요.
문제 해결
소스를 켜도 아무것도 열리지 않음
소스를 켜도 아무것도 열리지 않음
Iru 사이트에 대한 팝업 차단 설정을 확인한 후 다시 시도하세요.
403 Forbidden
403 Forbidden
범위를 늘리거나 프로젝트/그룹 역할을 상향하세요. 토큰은 계정이 액세스할 수 없는 엔드포인트를 읽을 수 없습니다.
자체 관리형 URL 문제
자체 관리형 URL 문제
통합이 인스턴스 호스트 이름을 가리키는지, 그리고 네트워크 경로가 Iru의 아웃바운드 호출을 허용하는지 확인하세요.
감사 유형 이벤트 누락
감사 유형 이벤트 누락
일부 감사 API에는 Premium/Ultimate 기능이 필요합니다. GitLab 등급을 프레임워크에서 요구하는 증거와 비교하세요.
고려 사항
토큰은 일정에 따라 만료됩니다: 미리 교체하고 업데이트하세요…
토큰은 일정에 따라 만료되므로 미리 교체하고 커넥터를 업데이트하세요.
GitLab은 속도 제한을 적용합니다. 대규모 그룹은…
GitLab은 속도 제한을 적용하므로 대규모 그룹은 첫 번째 동기화에 시간이 더 걸릴 수 있습니다.
Iru는 API가 노출하는 구성을 읽습니다: …
Iru는 API가 노출하는 구성을 읽으며, 파이프라인이나 리포지토리 설정을 다시 작성하지 않습니다.
관련 문서
Sources 관리
모든 Compliance 소스를 찾아보고 관리합니다.
Compliance 시작하기
프레임워크, 작업 및 아티팩트.
Iru 개요
Endpoint, Compliance 및 Identity가 함께 작동하는 방식.
Artifacts 관리
소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.
