InfoGrab DocsInfoGrab Docs

SLSA 레벨 3 출처 증명(Provenance Attestation)

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. GitLab은 SLSA 레벨 3 호환 출처 증명을 생성할 수 있습니다. 증명에 대한 자세한 내용은 GitLab SLSA 출처 명세를 참조합니다. 컨테이너 또는 아티팩트에 대한 증명이 이루어지려면 다음 조건을 충족해야 합니다.

히스토리
  • GitLab 18.3에서 slsa_provenance_statement라는 이름의 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • LOCAL_CA 증명 방식과 GitLab Self-Managed 및 GitLab Dedicated 지원이 GitLab 19.6에서 도입되었습니다.
  • 비공개 및 내부 프로젝트 지원이 GitLab 19.6에서 도입되었습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다. 이 기능은 테스트 용도로 사용할 수 있지만, 프로덕션 환경에서는 아직 사용할 준비가 되지 않았습니다.

GitLab은 SLSA 레벨 3 호환 출처 증명을 생성할 수 있습니다. 레벨 2와 레벨 3 출처 증명의 주요 차이점은 격리 및 "위조 불가" 요구 사항입니다.

증명에 대한 자세한 내용은 GitLab SLSA 출처 명세를 참조합니다.

사전 요구 사항#

컨테이너 또는 아티팩트에 대한 증명이 이루어지려면 다음 조건을 충족해야 합니다.

  • 비공개 및 내부 프로젝트의 경우 빌드는 LOCAL_CA 증명 방식을 사용해야 합니다.
  • 빌드는 build Stage를 사용해야 합니다.
  • 프로젝트에 대해 slsa_provenance_statement 기능 플래그가 활성화되어 있어야 합니다.

증명 방식#

GitLab은 다음 방식 중 하나로 각 증명에 서명합니다.

SIGSTORE : 공개 Sigstore 서비스로 증명에 서명하고, 서명 이벤트를 공개 Rekor 투명성 로그에 기록합니다. 프로젝트 정보가 실수로 공개되는 것을 방지하기 위해, GitLab은 비공개 또는 내부 프로젝트에 대해서는 SIGSTORE 증명을 생성하지 않습니다. 공개 Sigstore 서비스는 GitLab.com 파이프라인만 신뢰하므로, 이 방식은 GitLab.com에서만 동작합니다.

LOCAL_CA : GitLab이 프로젝트용으로 생성하는 인증 기관(CA)의 인증서로 증명에 서명합니다. GitLab은 증명을 Sigstore나 Rekor로 전송하지 않습니다.

기본적으로 GitLab.com의 공개 프로젝트는 SIGSTORE를 사용합니다. GitLab Self-Managed의 모든 프로젝트를 포함해 그 외의 모든 프로젝트는 LOCAL_CA를 사용합니다.

증명 방식 선택#

증명 방식을 선택해 GitLab이 파이프라인 또는 job의 증명에 서명하는 방식을 제어합니다.

증명 방식을 선택하려면 다음을 수행합니다.

  • .gitlab-ci.yml 파일에서 variables 키워드를 사용해 ATTEST_METHOD를 SIGSTORE 또는 LOCAL_CA로 설정합니다.

예를 들어 파이프라인의 모든 job에 LOCAL_CA를 사용하려면 다음과 같이 작성합니다.

variables:
  ATTEST_METHOD: LOCAL_CA

값은 대소문자를 구분하지 않습니다. 값이 SIGSTORE 또는 LOCAL_CA가 아니면 GitLab은 기본 방식을 사용합니다. GitLab은 ATTEST_METHOD를 .gitlab-ci.yml 파일에서만 읽으며, UI에서 정의한 CI/CD 변수와 파이프라인 변수처럼 다른 위치의 값은 무시합니다.

아티팩트에 대한 증명 생성#

빌드에서 생성된 모든 아티팩트에 대한 증명을 생성하려면 다음을 수행합니다.

  • ATTEST_BUILD_ARTIFACTS CI/CD 변수를 true로 설정합니다.
  • 아티팩트는 100 MB를 초과하지 않아야 합니다.

예를 들어 GitLab은 다음 CI/CD job의 아티팩트에 대한 증명을 생성합니다.

build-job:
  stage: build
  variables:
    ATTEST_BUILD_ARTIFACTS: true
  script:
    - echo "Hello, $GITLAB_USER_LOGIN!"
    - echo "Hello, $GITLAB_USER_LOGIN!" > test.txt
  artifacts:
    paths:
      - test.txt

컨테이너에 대한 증명 생성#

컨테이너에 대한 증명을 생성하려면 다음을 수행합니다.

  • CI/CD 변수 ATTEST_CONTAINER_IMAGES를 true로 설정합니다.

  • IMAGE_DIGEST 변수를 다음 형식의 유효한 SHA256 참조로 설정합니다.

    sha256:9bf00f5090086aba643d21f8ed663576855add63b7b780b4eaffc5124812c3c9
    org/project-name@sha256:9bf00f5090086aba643d21f8ed663576855add63b7b780b4eaffc5124812c3c9
    9bf00f5090086aba643d21f8ed663576855add63b7b780b4eaffc5124812c3c9
    

예를 들어 GitLab은 다음 CI/CD job에서 생성된 이미지에 대한 증명을 생성합니다.

build-dockerhub:
  stage: build
  variables:
    ATTEST_CONTAINER_IMAGES: true
    CI_REGISTRY: docker.io
    DOCKER_IMAGE_NAME: sroqueworcel/test-slsa-sbom:stable
  script:
    - echo $DOCKER_REGISTRY_PASSWORD | docker login $CI_REGISTRY -u $DOCKER_REGISTRY_USER --password-stdin
    - docker build -t $DOCKER_IMAGE_NAME .
    - docker push $DOCKER_IMAGE_NAME
    - IMAGE_DIGEST="$(docker inspect --format='{{index .Id}}' "$DOCKER_IMAGE_NAME")"
    - echo "IMAGE_DIGEST=$IMAGE_DIGEST" >> build.env
  artifacts:
    reports:
      dotenv: build.env

증명 보기#

성공한 증명은 증명 페이지에 저장됩니다. 증명을 보려면 다음을 수행합니다.

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

증명이 성공하지 못한 경우 CI/CD job 로그에 오류가 표시됩니다.

증명 API를 사용해 성공한 증명을 가져올 수도 있습니다.

증명 검증#

glab 명령줄 인터페이스를 사용해 아티팩트와 컨테이너를 모두 검증할 수 있습니다. glab CLI는 SIGSTORE 증명만 검증하며 LOCAL_CA 증명은 검증하지 않습니다.

예를 들면 다음과 같습니다.

  • 검증에 성공한 경우:

    % glab attestation verify ~/file-or-container -p org/project-name
    Artifact provenance successfully verified. Signatures confirm file.txt was attested by org/project-name
    
  • 검증에 실패한 경우:

    % glab attestation verify ~/file.txt -p org/project-name
    
       ERROR
    
      Unable to find a provenance statement for 1f9e5808a340916aa5618ee13a893dcf9d4f7e2d42a254be0f7eb06a094ab8ea.
    

SLSA 레벨 3 출처 증명(Provenance Attestation)

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

요약

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. GitLab은 SLSA 레벨 3 호환 출처 증명을 생성할 수 있습니다. 증명에 대한 자세한 내용은 GitLab SLSA 출처 명세를 참조합니다. 컨테이너 또는 아티팩트에 대한 증명이 이루어지려면 다음 조건을 충족해야 합니다.

히스토리
  • GitLab 18.3에서 slsa_provenance_statement라는 이름의 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • LOCAL_CA 증명 방식과 GitLab Self-Managed 및 GitLab Dedicated 지원이 GitLab 19.6에서 도입되었습니다.
  • 비공개 및 내부 프로젝트 지원이 GitLab 19.6에서 도입되었습니다.
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다. 이 기능은 테스트 용도로 사용할 수 있지만, 프로덕션 환경에서는 아직 사용할 준비가 되지 않았습니다.

GitLab은 SLSA 레벨 3 호환 출처 증명을 생성할 수 있습니다. 레벨 2와 레벨 3 출처 증명의 주요 차이점은 격리 및 "위조 불가" 요구 사항입니다.

증명에 대한 자세한 내용은 GitLab SLSA 출처 명세를 참조합니다.

사전 요구 사항#

컨테이너 또는 아티팩트에 대한 증명이 이루어지려면 다음 조건을 충족해야 합니다.

  • 비공개 및 내부 프로젝트의 경우 빌드는 LOCAL_CA 증명 방식을 사용해야 합니다.
  • 빌드는 build Stage를 사용해야 합니다.
  • 프로젝트에 대해 slsa_provenance_statement 기능 플래그가 활성화되어 있어야 합니다.

증명 방식#

GitLab은 다음 방식 중 하나로 각 증명에 서명합니다.

SIGSTORE : 공개 Sigstore 서비스로 증명에 서명하고, 서명 이벤트를 공개 Rekor 투명성 로그에 기록합니다. 프로젝트 정보가 실수로 공개되는 것을 방지하기 위해, GitLab은 비공개 또는 내부 프로젝트에 대해서는 SIGSTORE 증명을 생성하지 않습니다. 공개 Sigstore 서비스는 GitLab.com 파이프라인만 신뢰하므로, 이 방식은 GitLab.com에서만 동작합니다.

LOCAL_CA : GitLab이 프로젝트용으로 생성하는 인증 기관(CA)의 인증서로 증명에 서명합니다. GitLab은 증명을 Sigstore나 Rekor로 전송하지 않습니다.

기본적으로 GitLab.com의 공개 프로젝트는 SIGSTORE를 사용합니다. GitLab Self-Managed의 모든 프로젝트를 포함해 그 외의 모든 프로젝트는 LOCAL_CA를 사용합니다.

증명 방식 선택#

증명 방식을 선택해 GitLab이 파이프라인 또는 job의 증명에 서명하는 방식을 제어합니다.

증명 방식을 선택하려면 다음을 수행합니다.

  • .gitlab-ci.yml 파일에서 variables 키워드를 사용해 ATTEST_METHOD를 SIGSTORE 또는 LOCAL_CA로 설정합니다.

예를 들어 파이프라인의 모든 job에 LOCAL_CA를 사용하려면 다음과 같이 작성합니다.

variables:
  ATTEST_METHOD: LOCAL_CA

값은 대소문자를 구분하지 않습니다. 값이 SIGSTORE 또는 LOCAL_CA가 아니면 GitLab은 기본 방식을 사용합니다. GitLab은 ATTEST_METHOD를 .gitlab-ci.yml 파일에서만 읽으며, UI에서 정의한 CI/CD 변수와 파이프라인 변수처럼 다른 위치의 값은 무시합니다.

아티팩트에 대한 증명 생성#

빌드에서 생성된 모든 아티팩트에 대한 증명을 생성하려면 다음을 수행합니다.

  • ATTEST_BUILD_ARTIFACTS CI/CD 변수를 true로 설정합니다.
  • 아티팩트는 100 MB를 초과하지 않아야 합니다.

예를 들어 GitLab은 다음 CI/CD job의 아티팩트에 대한 증명을 생성합니다.

build-job:
  stage: build
  variables:
    ATTEST_BUILD_ARTIFACTS: true
  script:
    - echo "Hello, $GITLAB_USER_LOGIN!"
    - echo "Hello, $GITLAB_USER_LOGIN!" > test.txt
  artifacts:
    paths:
      - test.txt

컨테이너에 대한 증명 생성#

컨테이너에 대한 증명을 생성하려면 다음을 수행합니다.

  • CI/CD 변수 ATTEST_CONTAINER_IMAGES를 true로 설정합니다.

  • IMAGE_DIGEST 변수를 다음 형식의 유효한 SHA256 참조로 설정합니다.

    sha256:9bf00f5090086aba643d21f8ed663576855add63b7b780b4eaffc5124812c3c9
    org/project-name@sha256:9bf00f5090086aba643d21f8ed663576855add63b7b780b4eaffc5124812c3c9
    9bf00f5090086aba643d21f8ed663576855add63b7b780b4eaffc5124812c3c9
    

예를 들어 GitLab은 다음 CI/CD job에서 생성된 이미지에 대한 증명을 생성합니다.

build-dockerhub:
  stage: build
  variables:
    ATTEST_CONTAINER_IMAGES: true
    CI_REGISTRY: docker.io
    DOCKER_IMAGE_NAME: sroqueworcel/test-slsa-sbom:stable
  script:
    - echo $DOCKER_REGISTRY_PASSWORD | docker login $CI_REGISTRY -u $DOCKER_REGISTRY_USER --password-stdin
    - docker build -t $DOCKER_IMAGE_NAME .
    - docker push $DOCKER_IMAGE_NAME
    - IMAGE_DIGEST="$(docker inspect --format='{{index .Id}}' "$DOCKER_IMAGE_NAME")"
    - echo "IMAGE_DIGEST=$IMAGE_DIGEST" >> build.env
  artifacts:
    reports:
      dotenv: build.env

증명 보기#

성공한 증명은 증명 페이지에 저장됩니다. 증명을 보려면 다음을 수행합니다.

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

증명이 성공하지 못한 경우 CI/CD job 로그에 오류가 표시됩니다.

증명 API를 사용해 성공한 증명을 가져올 수도 있습니다.

증명 검증#

glab 명령줄 인터페이스를 사용해 아티팩트와 컨테이너를 모두 검증할 수 있습니다. glab CLI는 SIGSTORE 증명만 검증하며 LOCAL_CA 증명은 검증하지 않습니다.

예를 들면 다음과 같습니다.

  • 검증에 성공한 경우:

    % glab attestation verify ~/file-or-container -p org/project-name
    Artifact provenance successfully verified. Signatures confirm file.txt was attested by org/project-name
    
  • 검증에 실패한 경우:

    % glab attestation verify ~/file.txt -p org/project-name
    
       ERROR
    
      Unable to find a provenance statement for 1f9e5808a340916aa5618ee13a893dcf9d4f7e2d42a254be0f7eb06a094ab8ea.