InfoGrab DocsInfoGrab Docs

의존성 방화벽

요약

의존성 방화벽은 베타 상태입니다. 의존성 방화벽은 베타 기간에 무료입니다. 의존성 방화벽을 사용해 개발자와 CI/CD job이 설치하는 패키지를 제어합니다. 방화벽은 프로젝트가 이미 사용하는 npmjs.com, PyPI, Maven Central, RubyGems.org 같은 레지스트리와 함께 동작합니다.

히스토리
Note

의존성 방화벽은 베타 상태입니다. 정책 스키마와 지원 에코시스템은 릴리스 사이에 변경될 수 있습니다.

의존성 방화벽은 베타 기간에 무료입니다. 이후 GitLab Credits를 통해 과금하는 유료 기능으로 전환할 계획입니다. 요금이 청구되기 전에 직접 옵트인해야 하며, GitLab이 사전에 공지합니다.

의존성 방화벽을 사용해 개발자와 CI/CD job이 설치하는 패키지를 제어합니다. GitLab CLI에서 glab dependency-firewall 또는 더 짧은 별칭인 glab df로 패키지 관리자를 실행합니다. GitLab은 패키지가 사용자 머신에 도달하기 전에 각 패키지를 의존성 방화벽 정책과 대조해 검사합니다. 정책은 라이선스, 취약점 위험, 악성 코드를 기준으로 패키지를 일치시킵니다.

방화벽은 프로젝트가 이미 사용하는 npmjs.com, PyPI, Maven Central, RubyGems.org 같은 레지스트리와 함께 동작합니다. GitLab은 평가하는 패키지를 호스팅하거나 미러링하지 않으므로, 의존성을 GitLab 패키지 레지스트리로 옮기거나 레지스트리 설정을 변경할 필요가 없습니다.

방화벽은 패키지마다 다음 결과 중 하나를 반환합니다.

  • 허용: 패키지 관리자가 평소처럼 패키지를 가져옵니다.
  • 경고: 패키지 관리자가 패키지를 가져오고, CLI가 이를 보고합니다.
  • 차단: 방화벽이 패키지를 거부하고, 패키지 관리자는 403 Forbidden 응답을 받습니다.

GitLab은 모든 결정을 감사 이벤트로 기록합니다.

지원 에코시스템#

에코시스템 패키지 관리자
Java Maven, Gradle
Node.js npm, pnpm, Yarn
Python pip, uv, Poetry, pipenv, Twine
Ruby RubyGems, Bundler
Rust Cargo
Go GitHub

그 밖의 에코시스템의 패키지는 평가 없이 가져옵니다.

각 패키지 관리자에 사용할 명령은 glab dependency-firewall을 참고합니다.

CLI는 레지스트리에 직접 연결하며 HTTPS 만 사용하고, 일반 http:// 요청은 거부합니다. 외부로 나가는 기업 프록시를 사용하지 않으므로, 프록시가 필수인 네트워크에서는 glab df가 레지스트리에 접근할 수 없습니다.

의존성 방화벽 켜기#

정책을 만들기 전에 의존성 방화벽을 켭니다. 방화벽이 꺼져 있는 동안 GitLab은 패키지를 평가하지 않으며, glab df는 모든 패키지를 허용합니다.

GitLab.com 에서는 최상위 그룹별로 방화벽을 켭니다. 하위 그룹과 프로젝트는 최상위 그룹의 설정을 상속합니다.

사전 요구 사항:

  • 최상위 그룹의 Owner 권한.

의존성 방화벽을 켜려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > Secure를 선택합니다.
  3. Enable dependency firewall 토글을 켭니다.

GitLab Self-Managed 에서는 인스턴스 전체에 대해 방화벽을 한 번 켭니다. 이 설정은 인스턴스의 모든 프로젝트에 적용되며, 그룹별 토글은 없습니다.

사전 요구 사항:

  • 관리자 액세스.

의존성 방화벽을 켜려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Settings > Security and compliance를 선택합니다.
  3. Dependency firewall을 확장합니다.
  4. Enable dependency firewall 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

방화벽을 끄려면 사용 중인 제공 형태에 맞는 단계를 반복해 설정을 끕니다. 기존 정책은 유지되지만, 방화벽은 패키지 평가를 중단합니다.

의존성 방화벽 사용#

GitLab CLI로 패키지 관리자를 실행해 각 패키지를 정책과 대조해 검사합니다. 사용자 머신이나 CI/CD job 에서 실행할 수 있습니다. 인증이 필요합니다.

사전 요구 사항:

  • 그룹 또는 인스턴스에서 의존성 방화벽이 켜져 있어야 합니다.
  • GitLab CLI가 설치되고 인증되어 있어야 합니다.
  • 프로젝트에 대한 Reporter, Security Manager, Developer, Maintainer 또는 Owner 권한.

시작하려면 의존성 방화벽 튜토리얼을 따릅니다.

방화벽 우회 방지#

방화벽은 glab df가 볼 수 있는 트래픽만 평가합니다. 단독으로 실행한 패키지 관리자는 해석된 모든 것을 설치하며, 사용자를 대신해 패키지 관리자를 호출하는 AI 코딩 에이전트도 마찬가지입니다. 둘 다 방화벽을 거치지 않으므로 차단을 보지 못합니다.

패키지 관리자 캐시에 이미 있는 패키지도 다시 평가되지 않습니다. Maven은 ~/.m2/repository/, npm은 node_modules/, Bundler는 vendor/bundle/에서 읽습니다. 방화벽은 패키지 관리자가 네트워크로 패키지를 가져올 때만 패키지를 평가합니다.

이 간극을 메우려면 모든 호출자가 접두사를 기억하도록 맡기지 말고, 네트워크 송신 지점에서 방화벽을 강제합니다.

CLI는 메타데이터 및 인덱스 요청과 허용·경고된 패키지에 대한 요청을 포함해, 레지스트리로 전달하는 모든 요청에 다음 헤더를 추가합니다.

X-Gitlab-Dependency-Firewall: allowed

이 헤더가 있을 때만 패키지 레지스트리로의 HTTPS 트래픽을 허용하도록 송신 프록시나 게이트웨이를 구성합니다. glab df 밖에서 실행되는 패키지 관리자는 이 헤더를 보내지 않으므로, 요청이 조용히 성공하지 않고 네트워크 경계에서 거부됩니다.

이 제어에는 다음이 필요합니다.

  • HTTPS 트래픽을 검사하는 송신 제어 지점. 헤더는 CLI가 레지스트리와 여는 TLS 세션 안에서 전달되므로, 목적지 호스트만 보는 게이트웨이는 헤더를 읽을 수 없습니다.
  • 팀에서 사용하는 각 레지스트리 호스트 이름에 대한 규칙. 예를 들어 registry.npmjs.org, pypi.org, files.pythonhosted.org, repo.maven.apache.org, rubygems.org가 있습니다.

헤더는 CLI가 설정하므로 이는 경계가 아니라 가드레일입니다. 헤더를 모르는 패키지 관리자나 에이전트를 막지만, 헤더를 직접 설정하는 호출자는 여전히 레지스트리에 도달합니다.

또한 헤더는 정책이 요청을 평가했음을 증명하지 않습니다. CLI는 방화벽이 꺼져 있거나 프로젝트를 찾을 수 없는 경우처럼 방화벽이 프로젝트를 평가하지 않을 때도 헤더를 추가합니다. 헤더는 요청이 glab df를 거쳤다는 사실만 보여 줍니다. CLI는 차단된 패키지를 전달하지 않습니다.

일부 구성은 CLI를 우회해 트래픽을 보내기도 합니다. 예를 들어 gemrc 파일의 http_proxy: 설정은 CLI가 gem과 bundle 에 적용하는 프록시 설정보다 우선하므로, 해당 트래픽은 검사되지 않습니다. RubyGems는 시스템 gemrc 파일, ~/.gemrc, GEMRC 변수가 가리키는 파일을 읽습니다. 리포지터리에 있는 이 파일들은 읽지 않으므로 커밋된 프로젝트 파일이 원인이 될 수는 없지만, CI 이미지나 개발자 머신은 원인이 될 수 있습니다.

의존성 방화벽 정책 만들기#

의존성 방화벽 정책은 보안 정책 프로젝트의 .gitlab/security-policies/policy.yml 파일에 저장됩니다. 정책 편집기에서 정책을 작성하거나, 머지 리퀘스트에서 해당 파일을 편집합니다. GitLab은 머지 리퀘스트가 머지될 때만 정책 변경을 적용합니다. 자세한 내용은 정책 편집기를 참고합니다.

보안 정책 프로젝트에는 의존성 방화벽 정책을 최대 5개까지 둘 수 있습니다. 이 제한은 dependency_firewall_policies_per_configuration_limit 애플리케이션 설정으로 제어됩니다.

그룹에서 정책을 만들면 그룹과 하위 그룹의 모든 프로젝트에 정책이 적용됩니다. 프로젝트에서 정책을 만들면 해당 프로젝트에만 정책이 적용됩니다.

사전 요구 사항:

  • 기본적으로 그룹, 하위 그룹 또는 프로젝트 Owner 만 보안 정책 프로젝트를 만들거나 할당하는 데 필요한 권한을 가집니다. 또는 보안 정책 링크를 관리할 수 있는 권한이 있는 사용자 지정 역할을 만들 수 있습니다.

의존성 방화벽 정책을 만들려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Policies를 선택합니다.
  3. New policy를 선택합니다.
  4. Dependency firewall policy에서 Select policy를 선택합니다.
  5. 필드를 입력합니다. 각 필드의 의미는 정책 스키마를 참고합니다.
  6. Configure with a merge request를 선택합니다.
  7. 머지 리퀘스트를 검토하고 머지합니다.

머지 리퀘스트가 머지되면 정책은 다음 평가부터 적용됩니다.

편집기 모드#

정책 편집기는 정책을 대신 만들어 주는 양식인 규칙 모드로 열립니다. 규칙 모드는 이름, 설명, 범위, 적용 모드, 규칙을 다룹니다. 우회 설정은 Advanced 아래에 있습니다.

정책을 YAML로 작성하려면 를 선택합니다. 프로젝트 간에 정책을 복사하거나 규칙 모드에 표시되지 않는 필드를 사용할 때 YAML 모드를 사용합니다.

두 모드는 언제든지 전환할 수 있습니다. YAML 에 오류가 있으면 오류를 고칠 때까지 규칙 모드가 꺼집니다. 자세한 내용은 정책 편집기를 참고합니다.

정책 스키마#

의존성 방화벽 정책에는 다음 최상위 필드가 있습니다.

필드 유형 필수 설명
name string yes 정책 이름. 최대 255자.
description string no 정책에 대한 자세한 설명.
enabled boolean yes 정책을 평가할지 여부. 정책을 제거하지 않고 끄려면 false로 설정합니다.
enforcement_type string yes enforced 또는 warn 중 하나. 적용 모드를 참고합니다.
rules array yes 하나 이상의 규칙. 규칙 유형을 참고합니다.
bypass_settings object no 정책을 우회하는 사용자와 액세스 토큰. 우회 설정을 참고합니다.
policy_scope object no 정책이 적용되는 그룹과 프로젝트. 정책 범위를 참고합니다.

적용 모드#

enforcement_type 필드는 규칙이 일치할 때 일어나는 일을 제어합니다.

  • enforced: 방화벽이 패키지를 거부합니다. 패키지 관리자는 403 Forbidden 응답을 받고 패키지는 설치되지 않습니다.
  • warn: 방화벽이 패키지를 가져오고 실행 요약에 보고합니다. 정책을 적용하기 전에 테스트할 때 이 모드를 사용합니다.

활성 정책의 어떤 규칙도 패키지와 일치하지 않으면 방화벽은 패키지를 허용합니다.

패키지 메타데이터 데이터베이스에 없는 패키지도 허용됩니다. 허용 결과는 GitLab이 해당 패키지의 라이선스나 취약점 데이터를 보유하고 있다는 보증이 아닙니다.

규칙 유형#

정책에는 규칙이 하나 이상 있어야 합니다. 각 규칙에는 license, risk_severity, malicious 중 하나인 type 필드가 있습니다. 규칙 모드에서는 Choose a rule type에서 유형을 선택합니다.

규칙은 패키지 이름, 버전, 에코시스템을 기준으로 일치 여부를 판단합니다. 방화벽은 패키지 메타데이터 데이터베이스와 GitLab 권고 데이터베이스에서 라이선스, 취약점, 악성 패키지 데이터를 확인합니다.

라이선스 규칙#

라이선스 규칙은 SPDX 라이선스 이름으로 패키지를 일치시킵니다. 나열한 라이선스 중 하나라도 선언한 패키지를 차단하려면 denied를 사용합니다. 목록에 없는 라이선스를 선언한 패키지를 차단하려면 allowed를 사용합니다. 두 키는 함께 사용할 수 없습니다.

rules:
  - type: license
    denied:
      - name: GNU General Public License v3.0 only
      - name: GNU Affero General Public License v3.0 only
rules:
  - type: license
    allowed:
      - name: MIT License
      - name: Apache License 2.0

위험 심각도 규칙#

위험 심각도 규칙은 각 심각도에서 패키지가 가진 알려진 취약점의 수로 패키지를 일치시킵니다. 각 항목은 severity와 threshold를 짝지으며, threshold는 해당 심각도에서 허용하는 취약점의 최대 개수입니다. 패키지가 그 개수보다 많이 가지고 있으면 거부됩니다.

threshold가 0이면 하나도 허용하지 않으므로, 해당 심각도의 취약점이 하나만 있어도 패키지를 거부합니다. threshold가 2이면 두 개까지 허용하고 세 번째부터 거부합니다.

심각도는 critical, high, medium, low입니다. 각 심각도는 최대 한 번만 나열합니다. denied만 지원됩니다.

다음 규칙은 critical 취약점이 있거나, high 취약점이 2개를 넘거나, medium 취약점이 10개를 넘는 패키지를 차단합니다.

rules:
  - type: risk_severity
    denied:
      - severity: critical
        threshold: 0
      - severity: high
        threshold: 2
      - severity: medium
        threshold: 10

심각도를 알 수 없는 취약점은 집계되지 않습니다.

악성 패키지 규칙#

악성 패키지 규칙은 GitLab 악성 패키지 데이터 피드가 표시한 패키지를 차단합니다. denied만 지원되며, 단일 항목은 is_malicious: true여야 합니다.

rules:
  - type: malicious
    denied:
      - is_malicious: true

규칙 예외#

각 규칙은 선택 사항인 exceptions 배열을 지원합니다. 예외 항목은 패키지 URL(PURL) 또는 CVE 같은 취약점 식별자입니다. 일치하는 예외는 해당 규칙의 평가에서 패키지 또는 취약점을 제외합니다.

내부 패키지를 라이선스 규칙이나 악성 패키지 규칙에서 제외하려면 PURL 예외를 사용합니다. PURL 에는 버전을 포함하거나 생략할 수 있습니다. 버전을 생략하면 예외는 해당 패키지의 모든 버전에 적용됩니다.

rules:
  - type: license
    denied:
      - name: GNU General Public License v3.0 only
    exceptions:
      - purl: pkg:npm/my-internal-lib
      - purl: pkg:npm/another-lib@1.2.3

특정 CVE를 위험 심각도 규칙에서 제외하려면 ID 예외를 사용합니다. 예외로 지정된 취약점은 어떤 임계값에도 집계되지 않습니다.

rules:
  - type: risk_severity
    denied:
      - severity: high
        threshold: 0
    exceptions:
      - id: CVE-2024-12345

우회 설정#

우회 설정을 사용하면 특정 사용자나 액세스 토큰이 정책을 건너뛸 수 있습니다. 나열된 사용자가 보낸 요청이나 나열된 액세스 토큰으로 보낸 요청은 해당 정책을 건너뜁니다. 다른 정책이 패키지에 경고하거나 패키지를 차단하는 경우에도, 각 우회는 보안 정책 프로젝트에 감사 이벤트로 기록됩니다.

bypass_settings:
  users:
    - id: 1234
  access_tokens:
    - id: 5678

사용자 ID를 찾으려면 사용자 프로필을 열고 URL 끝에 .json을 붙입니다. 액세스 토큰 ID를 찾으려면 프로젝트 또는 그룹 액세스 토큰 목록을 확인합니다.

내부 패키지를 설치해야 하는 서비스 계정이나 장애 중 긴급 액세스에 우회 설정을 사용합니다.

정책 범위#

기본적으로 의존성 방화벽 정책은 정책이 적용되는 모든 프로젝트에 적용됩니다. policy_scope를 사용해 특정 그룹이나 프로젝트 집합으로 좁히거나, 더 넓은 적용 범위에서 프로젝트를 제외합니다.

policy_scope는 groups와 projects 두 키를 받습니다. 각 키에는 including 목록, excluding 목록 또는 둘 다 지정할 수 있습니다.

각 항목은 id를 가진 객체이며, type을 사용하는 projects.excluding 항목은 예외입니다.

필드 유형 설명
groups.including array 정책이 적용되는 그룹.
groups.excluding array 정책이 적용되지 않는 그룹.
projects.including array 정책이 적용되는 프로젝트.
projects.excluding array 정책이 적용되지 않는 프로젝트. type이 personal 또는 archived이면 모든 개인 프로젝트 또는 보관된 프로젝트를 제외합니다.

예를 들어 다음 범위는 정책을 두 그룹에 적용하되, 프로젝트 하나와 해당 그룹의 보관된 프로젝트 전체를 제외합니다.

policy_scope:
  groups:
    including:
      - id: 100
      - id: 101
  projects:
    excluding:
      - id: 555
      - type: archived

policy_scope를 생략하면 정책은 보안 정책 프로젝트의 적용 대상에 속한 모든 프로젝트에 적용됩니다.

Note

의존성 방화벽 policy_scope는 groups와 projects만 지원합니다. 규정 준수 프레임워크와 보안 속성은 지원되지 않습니다.

정책 예시#

다음 정책은 아래와 같이 동작합니다.

  • 카피레프트 라이선스를 차단합니다.
  • critical 취약점이 있거나 high 취약점이 2개를 넘는 패키지를 차단합니다.
  • 악성 패키지를 차단합니다.
  • 내부 라이브러리를 라이선스 규칙에서, 알려진 오탐 CVE를 위험 심각도 규칙에서 제외합니다.
---
dependency_firewall_policy:
  - name: Restrict copyleft licenses and high-risk packages
    description: Blocks copyleft-licensed packages, high-risk packages, and malicious packages.
    enabled: true
    enforcement_type: enforced
    rules:
      - type: license
        denied:
          - name: GNU General Public License v3.0 only
          - name: GNU Affero General Public License v3.0 only
        exceptions:
          - purl: pkg:npm/my-internal-lib
      - type: risk_severity
        denied:
          - severity: critical
            threshold: 0
          - severity: high
            threshold: 2
        exceptions:
          - id: CVE-2024-12345
      - type: malicious
        denied:
          - is_malicious: true
    bypass_settings:
      users:
        - id: 1234
    policy_scope:
      projects:
        excluding:
          - type: archived

의존성 방화벽 정책 편집#

정책이 정의된 그룹 또는 프로젝트에서 정책을 편집합니다. 상위 그룹에서 상속된 정책은 하위 그룹이나 프로젝트에서 편집할 수 없습니다.

사전 요구 사항:

  • 보안 정책 프로젝트에 대한 Developer, Maintainer 또는 Owner 권한.

의존성 방화벽 정책을 편집하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Policies를 선택합니다.
  3. 정책 옆에서 세로 줄임표(⋮) > Edit를 선택합니다.
  4. 정책을 편집합니다.
  5. Configure with a merge request를 선택합니다.
  6. 머지 리퀘스트를 검토하고 머지합니다.

수정된 정책은 머지 리퀘스트가 머지된 뒤 다음 평가부터 적용됩니다.

의존성 방화벽 정책 삭제#

사전 요구 사항:

  • 보안 정책 프로젝트에 대한 Developer, Maintainer 또는 Owner 권한.

의존성 방화벽 정책을 삭제하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Policies를 선택합니다.
  3. 정책 옆에서 세로 줄임표(⋮) > Delete를 선택합니다. GitLab이 정책을 제거하는 머지 리퀘스트를 엽니다.
  4. 머지 리퀘스트를 검토하고 머지합니다.

머지 리퀘스트가 머지되면 정책은 더 이상 적용되지 않습니다.

의존성 방화벽 대시보드 보기#

의존성 방화벽 대시보드를 사용해 정책이 팀이 설치하는 패키지에 어떤 영향을 주는지 확인합니다. 대시보드는 일정 기간 방화벽이 차단하거나 경고한 패키지 수를 집계합니다. 또한 활성 정책 규칙을 모드와 트리거된 횟수와 함께 나열합니다.

사전 요구 사항:

  • 그룹 또는 인스턴스에서 의존성 방화벽이 켜져 있어야 합니다.
  • 그룹 또는 프로젝트에 대한 Security Manager, Developer, Maintainer 또는 Owner 권한.

의존성 방화벽 대시보드를 보려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Dependency firewall을 선택합니다.
  3. 선택 사항. 기본값인 7일에서 기간을 바꾸려면 드롭다운 목록에서 Last 30 days를 선택합니다.

감사 이벤트 보기#

GitLab은 방화벽이 평가하는 모든 패키지에 대해 프로젝트 감사 이벤트를 기록합니다. 각 이벤트에는 패키지, 작업, 정책 이름, 일치한 규칙이 포함됩니다. 자세한 내용은 감사 이벤트 유형을 참고합니다.

사전 요구 사항:

  • 모든 사용자의 이벤트를 보려면 프로젝트에 대한 Security Manager, Maintainer 또는 Owner 권한.
  • 본인 작업의 이벤트만 보려면 프로젝트에 대한 Developer 권한.

감사 이벤트를 보려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Audit events를 선택합니다.

다음 감사 이벤트 유형이 기록됩니다.

이벤트 유형 기록 시점
dependency_firewall_allowed 우회나 예외를 통한 경우를 포함해 방화벽이 패키지를 허용할 때.
dependency_firewall_warned warn 정책이 패키지와 일치할 때.
dependency_firewall_blocked enforced 정책이 패키지와 일치할 때.

정책을 우회하는 요청은 우회한 정책마다 다음 이벤트 중 하나도 기록합니다. 이 이벤트는 다른 보안 정책 유형의 우회 이벤트와 마찬가지로 보안 정책 프로젝트에 기록됩니다.

이벤트 유형 기록 시점
dependency_firewall_access_token_bypass 정책의 우회 설정에 있는 액세스 토큰으로 보낸 요청이 정책을 건너뛸 때.
dependency_firewall_user_bypass 정책의 우회 설정에 있는 사용자가 보낸 요청이 정책을 건너뛸 때.

문제 해결#

의존성 방화벽을 사용할 때 다음 문제가 발생할 수 있습니다.

GitLab이 패키지를 평가할 수 없으면 CLI는 해당 패키지를 차단합니다. 방화벽이 프로젝트를 평가하지 않는 경우 CLI는 모든 패키지를 허용합니다.

오류: policy check failed#

패키지가 차단되고, 요약의 사유가 policy check failed로 시작합니다.

이 문제는 네트워크 오류, 60초 후 시간 초과, 서버 오류(503), 속도 제한(429), 또는 Reporter 권한이 없는 경우와 같은 권한 오류(403) 때문에 평가 요청이 실패할 때 발생합니다.

CLI는 같은 실행에서 해당 패키지를 다시 요청할 때 실패한 검사를 재시도합니다. glab df package는 패키지를 차단하지 않고 1로 종료합니다.

경고: dependency firewall not evaluating#

CLI가 dependency firewall not evaluating으로 시작하는 줄을 표준 오류로 출력하고, 실행이 끝날 때까지 모든 패키지를 허용합니다.

프로젝트에서 방화벽이 켜져 있지 않으면 이 줄은 정상입니다. 정책이 적용되는지 여부와 관계없이 모든 프로젝트에서 같은 명령을 사용할 수 있습니다.

GitLab이 프로젝트를 찾을 수 없거나 토큰이 프로젝트에 접근할 수 없을 때도 이 문제가 발생합니다. 이 문제를 해결하려면 Git 원격 설정과 프로젝트에 대한 토큰의 액세스 권한을 확인합니다.

의존성 방화벽

GitLab v19.6
Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed
원문 보기

요약

의존성 방화벽은 베타 상태입니다. 의존성 방화벽은 베타 기간에 무료입니다. 의존성 방화벽을 사용해 개발자와 CI/CD job이 설치하는 패키지를 제어합니다. 방화벽은 프로젝트가 이미 사용하는 npmjs.com, PyPI, Maven Central, RubyGems.org 같은 레지스트리와 함께 동작합니다.

히스토리
Note

의존성 방화벽은 베타 상태입니다. 정책 스키마와 지원 에코시스템은 릴리스 사이에 변경될 수 있습니다.

의존성 방화벽은 베타 기간에 무료입니다. 이후 GitLab Credits를 통해 과금하는 유료 기능으로 전환할 계획입니다. 요금이 청구되기 전에 직접 옵트인해야 하며, GitLab이 사전에 공지합니다.

의존성 방화벽을 사용해 개발자와 CI/CD job이 설치하는 패키지를 제어합니다. GitLab CLI에서 glab dependency-firewall 또는 더 짧은 별칭인 glab df로 패키지 관리자를 실행합니다. GitLab은 패키지가 사용자 머신에 도달하기 전에 각 패키지를 의존성 방화벽 정책과 대조해 검사합니다. 정책은 라이선스, 취약점 위험, 악성 코드를 기준으로 패키지를 일치시킵니다.

방화벽은 프로젝트가 이미 사용하는 npmjs.com, PyPI, Maven Central, RubyGems.org 같은 레지스트리와 함께 동작합니다. GitLab은 평가하는 패키지를 호스팅하거나 미러링하지 않으므로, 의존성을 GitLab 패키지 레지스트리로 옮기거나 레지스트리 설정을 변경할 필요가 없습니다.

방화벽은 패키지마다 다음 결과 중 하나를 반환합니다.

  • 허용: 패키지 관리자가 평소처럼 패키지를 가져옵니다.
  • 경고: 패키지 관리자가 패키지를 가져오고, CLI가 이를 보고합니다.
  • 차단: 방화벽이 패키지를 거부하고, 패키지 관리자는 403 Forbidden 응답을 받습니다.

GitLab은 모든 결정을 감사 이벤트로 기록합니다.

지원 에코시스템#

에코시스템 패키지 관리자
Java Maven, Gradle
Node.js npm, pnpm, Yarn
Python pip, uv, Poetry, pipenv, Twine
Ruby RubyGems, Bundler
Rust Cargo
Go GitHub

그 밖의 에코시스템의 패키지는 평가 없이 가져옵니다.

각 패키지 관리자에 사용할 명령은 glab dependency-firewall을 참고합니다.

CLI는 레지스트리에 직접 연결하며 HTTPS 만 사용하고, 일반 http:// 요청은 거부합니다. 외부로 나가는 기업 프록시를 사용하지 않으므로, 프록시가 필수인 네트워크에서는 glab df가 레지스트리에 접근할 수 없습니다.

의존성 방화벽 켜기#

정책을 만들기 전에 의존성 방화벽을 켭니다. 방화벽이 꺼져 있는 동안 GitLab은 패키지를 평가하지 않으며, glab df는 모든 패키지를 허용합니다.

GitLab.com 에서는 최상위 그룹별로 방화벽을 켭니다. 하위 그룹과 프로젝트는 최상위 그룹의 설정을 상속합니다.

사전 요구 사항:

  • 최상위 그룹의 Owner 권한.

의존성 방화벽을 켜려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > Secure를 선택합니다.
  3. Enable dependency firewall 토글을 켭니다.

GitLab Self-Managed 에서는 인스턴스 전체에 대해 방화벽을 한 번 켭니다. 이 설정은 인스턴스의 모든 프로젝트에 적용되며, 그룹별 토글은 없습니다.

사전 요구 사항:

  • 관리자 액세스.

의존성 방화벽을 켜려면 다음과 같이 합니다.

  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Settings > Security and compliance를 선택합니다.
  3. Dependency firewall을 확장합니다.
  4. Enable dependency firewall 체크박스를 선택합니다.
  5. Save changes를 선택합니다.

방화벽을 끄려면 사용 중인 제공 형태에 맞는 단계를 반복해 설정을 끕니다. 기존 정책은 유지되지만, 방화벽은 패키지 평가를 중단합니다.

의존성 방화벽 사용#

GitLab CLI로 패키지 관리자를 실행해 각 패키지를 정책과 대조해 검사합니다. 사용자 머신이나 CI/CD job 에서 실행할 수 있습니다. 인증이 필요합니다.

사전 요구 사항:

  • 그룹 또는 인스턴스에서 의존성 방화벽이 켜져 있어야 합니다.
  • GitLab CLI가 설치되고 인증되어 있어야 합니다.
  • 프로젝트에 대한 Reporter, Security Manager, Developer, Maintainer 또는 Owner 권한.

시작하려면 의존성 방화벽 튜토리얼을 따릅니다.

방화벽 우회 방지#

방화벽은 glab df가 볼 수 있는 트래픽만 평가합니다. 단독으로 실행한 패키지 관리자는 해석된 모든 것을 설치하며, 사용자를 대신해 패키지 관리자를 호출하는 AI 코딩 에이전트도 마찬가지입니다. 둘 다 방화벽을 거치지 않으므로 차단을 보지 못합니다.

패키지 관리자 캐시에 이미 있는 패키지도 다시 평가되지 않습니다. Maven은 ~/.m2/repository/, npm은 node_modules/, Bundler는 vendor/bundle/에서 읽습니다. 방화벽은 패키지 관리자가 네트워크로 패키지를 가져올 때만 패키지를 평가합니다.

이 간극을 메우려면 모든 호출자가 접두사를 기억하도록 맡기지 말고, 네트워크 송신 지점에서 방화벽을 강제합니다.

CLI는 메타데이터 및 인덱스 요청과 허용·경고된 패키지에 대한 요청을 포함해, 레지스트리로 전달하는 모든 요청에 다음 헤더를 추가합니다.

X-Gitlab-Dependency-Firewall: allowed

이 헤더가 있을 때만 패키지 레지스트리로의 HTTPS 트래픽을 허용하도록 송신 프록시나 게이트웨이를 구성합니다. glab df 밖에서 실행되는 패키지 관리자는 이 헤더를 보내지 않으므로, 요청이 조용히 성공하지 않고 네트워크 경계에서 거부됩니다.

이 제어에는 다음이 필요합니다.

  • HTTPS 트래픽을 검사하는 송신 제어 지점. 헤더는 CLI가 레지스트리와 여는 TLS 세션 안에서 전달되므로, 목적지 호스트만 보는 게이트웨이는 헤더를 읽을 수 없습니다.
  • 팀에서 사용하는 각 레지스트리 호스트 이름에 대한 규칙. 예를 들어 registry.npmjs.org, pypi.org, files.pythonhosted.org, repo.maven.apache.org, rubygems.org가 있습니다.

헤더는 CLI가 설정하므로 이는 경계가 아니라 가드레일입니다. 헤더를 모르는 패키지 관리자나 에이전트를 막지만, 헤더를 직접 설정하는 호출자는 여전히 레지스트리에 도달합니다.

또한 헤더는 정책이 요청을 평가했음을 증명하지 않습니다. CLI는 방화벽이 꺼져 있거나 프로젝트를 찾을 수 없는 경우처럼 방화벽이 프로젝트를 평가하지 않을 때도 헤더를 추가합니다. 헤더는 요청이 glab df를 거쳤다는 사실만 보여 줍니다. CLI는 차단된 패키지를 전달하지 않습니다.

일부 구성은 CLI를 우회해 트래픽을 보내기도 합니다. 예를 들어 gemrc 파일의 http_proxy: 설정은 CLI가 gem과 bundle 에 적용하는 프록시 설정보다 우선하므로, 해당 트래픽은 검사되지 않습니다. RubyGems는 시스템 gemrc 파일, ~/.gemrc, GEMRC 변수가 가리키는 파일을 읽습니다. 리포지터리에 있는 이 파일들은 읽지 않으므로 커밋된 프로젝트 파일이 원인이 될 수는 없지만, CI 이미지나 개발자 머신은 원인이 될 수 있습니다.

의존성 방화벽 정책 만들기#

의존성 방화벽 정책은 보안 정책 프로젝트의 .gitlab/security-policies/policy.yml 파일에 저장됩니다. 정책 편집기에서 정책을 작성하거나, 머지 리퀘스트에서 해당 파일을 편집합니다. GitLab은 머지 리퀘스트가 머지될 때만 정책 변경을 적용합니다. 자세한 내용은 정책 편집기를 참고합니다.

보안 정책 프로젝트에는 의존성 방화벽 정책을 최대 5개까지 둘 수 있습니다. 이 제한은 dependency_firewall_policies_per_configuration_limit 애플리케이션 설정으로 제어됩니다.

그룹에서 정책을 만들면 그룹과 하위 그룹의 모든 프로젝트에 정책이 적용됩니다. 프로젝트에서 정책을 만들면 해당 프로젝트에만 정책이 적용됩니다.

사전 요구 사항:

  • 기본적으로 그룹, 하위 그룹 또는 프로젝트 Owner 만 보안 정책 프로젝트를 만들거나 할당하는 데 필요한 권한을 가집니다. 또는 보안 정책 링크를 관리할 수 있는 권한이 있는 사용자 지정 역할을 만들 수 있습니다.

의존성 방화벽 정책을 만들려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Policies를 선택합니다.
  3. New policy를 선택합니다.
  4. Dependency firewall policy에서 Select policy를 선택합니다.
  5. 필드를 입력합니다. 각 필드의 의미는 정책 스키마를 참고합니다.
  6. Configure with a merge request를 선택합니다.
  7. 머지 리퀘스트를 검토하고 머지합니다.

머지 리퀘스트가 머지되면 정책은 다음 평가부터 적용됩니다.

편집기 모드#

정책 편집기는 정책을 대신 만들어 주는 양식인 규칙 모드로 열립니다. 규칙 모드는 이름, 설명, 범위, 적용 모드, 규칙을 다룹니다. 우회 설정은 Advanced 아래에 있습니다.

정책을 YAML로 작성하려면 를 선택합니다. 프로젝트 간에 정책을 복사하거나 규칙 모드에 표시되지 않는 필드를 사용할 때 YAML 모드를 사용합니다.

두 모드는 언제든지 전환할 수 있습니다. YAML 에 오류가 있으면 오류를 고칠 때까지 규칙 모드가 꺼집니다. 자세한 내용은 정책 편집기를 참고합니다.

정책 스키마#

의존성 방화벽 정책에는 다음 최상위 필드가 있습니다.

필드 유형 필수 설명
name string yes 정책 이름. 최대 255자.
description string no 정책에 대한 자세한 설명.
enabled boolean yes 정책을 평가할지 여부. 정책을 제거하지 않고 끄려면 false로 설정합니다.
enforcement_type string yes enforced 또는 warn 중 하나. 적용 모드를 참고합니다.
rules array yes 하나 이상의 규칙. 규칙 유형을 참고합니다.
bypass_settings object no 정책을 우회하는 사용자와 액세스 토큰. 우회 설정을 참고합니다.
policy_scope object no 정책이 적용되는 그룹과 프로젝트. 정책 범위를 참고합니다.

적용 모드#

enforcement_type 필드는 규칙이 일치할 때 일어나는 일을 제어합니다.

  • enforced: 방화벽이 패키지를 거부합니다. 패키지 관리자는 403 Forbidden 응답을 받고 패키지는 설치되지 않습니다.
  • warn: 방화벽이 패키지를 가져오고 실행 요약에 보고합니다. 정책을 적용하기 전에 테스트할 때 이 모드를 사용합니다.

활성 정책의 어떤 규칙도 패키지와 일치하지 않으면 방화벽은 패키지를 허용합니다.

패키지 메타데이터 데이터베이스에 없는 패키지도 허용됩니다. 허용 결과는 GitLab이 해당 패키지의 라이선스나 취약점 데이터를 보유하고 있다는 보증이 아닙니다.

규칙 유형#

정책에는 규칙이 하나 이상 있어야 합니다. 각 규칙에는 license, risk_severity, malicious 중 하나인 type 필드가 있습니다. 규칙 모드에서는 Choose a rule type에서 유형을 선택합니다.

규칙은 패키지 이름, 버전, 에코시스템을 기준으로 일치 여부를 판단합니다. 방화벽은 패키지 메타데이터 데이터베이스와 GitLab 권고 데이터베이스에서 라이선스, 취약점, 악성 패키지 데이터를 확인합니다.

라이선스 규칙#

라이선스 규칙은 SPDX 라이선스 이름으로 패키지를 일치시킵니다. 나열한 라이선스 중 하나라도 선언한 패키지를 차단하려면 denied를 사용합니다. 목록에 없는 라이선스를 선언한 패키지를 차단하려면 allowed를 사용합니다. 두 키는 함께 사용할 수 없습니다.

rules:
  - type: license
    denied:
      - name: GNU General Public License v3.0 only
      - name: GNU Affero General Public License v3.0 only
rules:
  - type: license
    allowed:
      - name: MIT License
      - name: Apache License 2.0

위험 심각도 규칙#

위험 심각도 규칙은 각 심각도에서 패키지가 가진 알려진 취약점의 수로 패키지를 일치시킵니다. 각 항목은 severity와 threshold를 짝지으며, threshold는 해당 심각도에서 허용하는 취약점의 최대 개수입니다. 패키지가 그 개수보다 많이 가지고 있으면 거부됩니다.

threshold가 0이면 하나도 허용하지 않으므로, 해당 심각도의 취약점이 하나만 있어도 패키지를 거부합니다. threshold가 2이면 두 개까지 허용하고 세 번째부터 거부합니다.

심각도는 critical, high, medium, low입니다. 각 심각도는 최대 한 번만 나열합니다. denied만 지원됩니다.

다음 규칙은 critical 취약점이 있거나, high 취약점이 2개를 넘거나, medium 취약점이 10개를 넘는 패키지를 차단합니다.

rules:
  - type: risk_severity
    denied:
      - severity: critical
        threshold: 0
      - severity: high
        threshold: 2
      - severity: medium
        threshold: 10

심각도를 알 수 없는 취약점은 집계되지 않습니다.

악성 패키지 규칙#

악성 패키지 규칙은 GitLab 악성 패키지 데이터 피드가 표시한 패키지를 차단합니다. denied만 지원되며, 단일 항목은 is_malicious: true여야 합니다.

rules:
  - type: malicious
    denied:
      - is_malicious: true

규칙 예외#

각 규칙은 선택 사항인 exceptions 배열을 지원합니다. 예외 항목은 패키지 URL(PURL) 또는 CVE 같은 취약점 식별자입니다. 일치하는 예외는 해당 규칙의 평가에서 패키지 또는 취약점을 제외합니다.

내부 패키지를 라이선스 규칙이나 악성 패키지 규칙에서 제외하려면 PURL 예외를 사용합니다. PURL 에는 버전을 포함하거나 생략할 수 있습니다. 버전을 생략하면 예외는 해당 패키지의 모든 버전에 적용됩니다.

rules:
  - type: license
    denied:
      - name: GNU General Public License v3.0 only
    exceptions:
      - purl: pkg:npm/my-internal-lib
      - purl: pkg:npm/another-lib@1.2.3

특정 CVE를 위험 심각도 규칙에서 제외하려면 ID 예외를 사용합니다. 예외로 지정된 취약점은 어떤 임계값에도 집계되지 않습니다.

rules:
  - type: risk_severity
    denied:
      - severity: high
        threshold: 0
    exceptions:
      - id: CVE-2024-12345

우회 설정#

우회 설정을 사용하면 특정 사용자나 액세스 토큰이 정책을 건너뛸 수 있습니다. 나열된 사용자가 보낸 요청이나 나열된 액세스 토큰으로 보낸 요청은 해당 정책을 건너뜁니다. 다른 정책이 패키지에 경고하거나 패키지를 차단하는 경우에도, 각 우회는 보안 정책 프로젝트에 감사 이벤트로 기록됩니다.

bypass_settings:
  users:
    - id: 1234
  access_tokens:
    - id: 5678

사용자 ID를 찾으려면 사용자 프로필을 열고 URL 끝에 .json을 붙입니다. 액세스 토큰 ID를 찾으려면 프로젝트 또는 그룹 액세스 토큰 목록을 확인합니다.

내부 패키지를 설치해야 하는 서비스 계정이나 장애 중 긴급 액세스에 우회 설정을 사용합니다.

정책 범위#

기본적으로 의존성 방화벽 정책은 정책이 적용되는 모든 프로젝트에 적용됩니다. policy_scope를 사용해 특정 그룹이나 프로젝트 집합으로 좁히거나, 더 넓은 적용 범위에서 프로젝트를 제외합니다.

policy_scope는 groups와 projects 두 키를 받습니다. 각 키에는 including 목록, excluding 목록 또는 둘 다 지정할 수 있습니다.

각 항목은 id를 가진 객체이며, type을 사용하는 projects.excluding 항목은 예외입니다.

필드 유형 설명
groups.including array 정책이 적용되는 그룹.
groups.excluding array 정책이 적용되지 않는 그룹.
projects.including array 정책이 적용되는 프로젝트.
projects.excluding array 정책이 적용되지 않는 프로젝트. type이 personal 또는 archived이면 모든 개인 프로젝트 또는 보관된 프로젝트를 제외합니다.

예를 들어 다음 범위는 정책을 두 그룹에 적용하되, 프로젝트 하나와 해당 그룹의 보관된 프로젝트 전체를 제외합니다.

policy_scope:
  groups:
    including:
      - id: 100
      - id: 101
  projects:
    excluding:
      - id: 555
      - type: archived

policy_scope를 생략하면 정책은 보안 정책 프로젝트의 적용 대상에 속한 모든 프로젝트에 적용됩니다.

Note

의존성 방화벽 policy_scope는 groups와 projects만 지원합니다. 규정 준수 프레임워크와 보안 속성은 지원되지 않습니다.

정책 예시#

다음 정책은 아래와 같이 동작합니다.

  • 카피레프트 라이선스를 차단합니다.
  • critical 취약점이 있거나 high 취약점이 2개를 넘는 패키지를 차단합니다.
  • 악성 패키지를 차단합니다.
  • 내부 라이브러리를 라이선스 규칙에서, 알려진 오탐 CVE를 위험 심각도 규칙에서 제외합니다.
---
dependency_firewall_policy:
  - name: Restrict copyleft licenses and high-risk packages
    description: Blocks copyleft-licensed packages, high-risk packages, and malicious packages.
    enabled: true
    enforcement_type: enforced
    rules:
      - type: license
        denied:
          - name: GNU General Public License v3.0 only
          - name: GNU Affero General Public License v3.0 only
        exceptions:
          - purl: pkg:npm/my-internal-lib
      - type: risk_severity
        denied:
          - severity: critical
            threshold: 0
          - severity: high
            threshold: 2
        exceptions:
          - id: CVE-2024-12345
      - type: malicious
        denied:
          - is_malicious: true
    bypass_settings:
      users:
        - id: 1234
    policy_scope:
      projects:
        excluding:
          - type: archived

의존성 방화벽 정책 편집#

정책이 정의된 그룹 또는 프로젝트에서 정책을 편집합니다. 상위 그룹에서 상속된 정책은 하위 그룹이나 프로젝트에서 편집할 수 없습니다.

사전 요구 사항:

  • 보안 정책 프로젝트에 대한 Developer, Maintainer 또는 Owner 권한.

의존성 방화벽 정책을 편집하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Policies를 선택합니다.
  3. 정책 옆에서 세로 줄임표(⋮) > Edit를 선택합니다.
  4. 정책을 편집합니다.
  5. Configure with a merge request를 선택합니다.
  6. 머지 리퀘스트를 검토하고 머지합니다.

수정된 정책은 머지 리퀘스트가 머지된 뒤 다음 평가부터 적용됩니다.

의존성 방화벽 정책 삭제#

사전 요구 사항:

  • 보안 정책 프로젝트에 대한 Developer, Maintainer 또는 Owner 권한.

의존성 방화벽 정책을 삭제하려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Policies를 선택합니다.
  3. 정책 옆에서 세로 줄임표(⋮) > Delete를 선택합니다. GitLab이 정책을 제거하는 머지 리퀘스트를 엽니다.
  4. 머지 리퀘스트를 검토하고 머지합니다.

머지 리퀘스트가 머지되면 정책은 더 이상 적용되지 않습니다.

의존성 방화벽 대시보드 보기#

의존성 방화벽 대시보드를 사용해 정책이 팀이 설치하는 패키지에 어떤 영향을 주는지 확인합니다. 대시보드는 일정 기간 방화벽이 차단하거나 경고한 패키지 수를 집계합니다. 또한 활성 정책 규칙을 모드와 트리거된 횟수와 함께 나열합니다.

사전 요구 사항:

  • 그룹 또는 인스턴스에서 의존성 방화벽이 켜져 있어야 합니다.
  • 그룹 또는 프로젝트에 대한 Security Manager, Developer, Maintainer 또는 Owner 권한.

의존성 방화벽 대시보드를 보려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹 또는 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Dependency firewall을 선택합니다.
  3. 선택 사항. 기본값인 7일에서 기간을 바꾸려면 드롭다운 목록에서 Last 30 days를 선택합니다.

감사 이벤트 보기#

GitLab은 방화벽이 평가하는 모든 패키지에 대해 프로젝트 감사 이벤트를 기록합니다. 각 이벤트에는 패키지, 작업, 정책 이름, 일치한 규칙이 포함됩니다. 자세한 내용은 감사 이벤트 유형을 참고합니다.

사전 요구 사항:

  • 모든 사용자의 이벤트를 보려면 프로젝트에 대한 Security Manager, Maintainer 또는 Owner 권한.
  • 본인 작업의 이벤트만 보려면 프로젝트에 대한 Developer 권한.

감사 이벤트를 보려면 다음과 같이 합니다.

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. 왼쪽 사이드바에서 Secure > Audit events를 선택합니다.

다음 감사 이벤트 유형이 기록됩니다.

이벤트 유형 기록 시점
dependency_firewall_allowed 우회나 예외를 통한 경우를 포함해 방화벽이 패키지를 허용할 때.
dependency_firewall_warned warn 정책이 패키지와 일치할 때.
dependency_firewall_blocked enforced 정책이 패키지와 일치할 때.

정책을 우회하는 요청은 우회한 정책마다 다음 이벤트 중 하나도 기록합니다. 이 이벤트는 다른 보안 정책 유형의 우회 이벤트와 마찬가지로 보안 정책 프로젝트에 기록됩니다.

이벤트 유형 기록 시점
dependency_firewall_access_token_bypass 정책의 우회 설정에 있는 액세스 토큰으로 보낸 요청이 정책을 건너뛸 때.
dependency_firewall_user_bypass 정책의 우회 설정에 있는 사용자가 보낸 요청이 정책을 건너뛸 때.

문제 해결#

의존성 방화벽을 사용할 때 다음 문제가 발생할 수 있습니다.

GitLab이 패키지를 평가할 수 없으면 CLI는 해당 패키지를 차단합니다. 방화벽이 프로젝트를 평가하지 않는 경우 CLI는 모든 패키지를 허용합니다.

오류: policy check failed#

패키지가 차단되고, 요약의 사유가 policy check failed로 시작합니다.

이 문제는 네트워크 오류, 60초 후 시간 초과, 서버 오류(503), 속도 제한(429), 또는 Reporter 권한이 없는 경우와 같은 권한 오류(403) 때문에 평가 요청이 실패할 때 발생합니다.

CLI는 같은 실행에서 해당 패키지를 다시 요청할 때 실패한 검사를 재시도합니다. glab df package는 패키지를 차단하지 않고 1로 종료합니다.

경고: dependency firewall not evaluating#

CLI가 dependency firewall not evaluating으로 시작하는 줄을 표준 오류로 출력하고, 실행이 끝날 때까지 모든 패키지를 허용합니다.

프로젝트에서 방화벽이 켜져 있지 않으면 이 줄은 정상입니다. 정책이 적용되는지 여부와 관계없이 모든 프로젝트에서 같은 명령을 사용할 수 있습니다.

GitLab이 프로젝트를 찾을 수 없거나 토큰이 프로젝트에 접근할 수 없을 때도 이 문제가 발생합니다. 이 문제를 해결하려면 Git 원격 설정과 프로젝트에 대한 토큰의 액세스 권한을 확인합니다.