증명 API
증명 API에 대해 설명합니다.
히스토리 GitLab 18.5에서 slsa_provenance_statement 라는 플래그 와 함께 도입 . 기본적으로 비활성화됨. Feature flag 이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다. 이 기능은 테스트 목적으로 사용 가능하지만, 프로덕션 사용에는 아직 준비되지 않았습니다. 이 API를 사용하여 출처 증명 과 상호 작용합니다. 출처 증명 # 일부 엔드포인트는 응답의 일부로 Sigstore 번들 을 반환합니다. SIGSTORE 증명 방식 을 사용하는 증명의 경우 glab 또는 cosign 으로 이 번들을 검증할 수 있습니다. 출처에 대한 자세한 내용은 SLSA 출처 명세 를 참조합니다. 모든 증명 목록 조회 # 히스토리 18.5에서 도입 . GitLab 19.6에서 signing_method 속성이 도입되었습니다 . 지정된 프로젝트와 SHA-256 해시에 대한 모든 증명을 나열합니다. GET /projects/:id/attestations/:subject_digest 지원되는 속성: 속성 유형 필수 설명 id integer or string yes 프로젝트의 ID 또는 URL 인코딩된 경로 subject_digest string yes 아티팩트의 16진수 인코딩된 SHA-256 해시 성공하면 200 OK 와 다음 응답 속성을 반환합니다. 속성 유형 설명 build_id integer 증명을 생성한 CI/CD job의 ID. created_at datetime 증명이 생성된 날짜와 시간. download_url string 증명 번들을 다운로드하는 URL. expire_at datetime 증명이 만료되는 날짜와 시간. id integer 증명의 ID. iid integer 프로젝트 내 증명의 내부 ID. predicate_kind string 프레디케이트의 종류. 가능한 값: provenance 또는 sbom . predicate_type string 프레디케이트 유형의 URI. project_id integer 프로젝트의 ID. signing_method string 증명에 서명하는 데 사용한 증명 방식 . 가능한 값: sigstore 또는 local_ca . ATTEST_METHOD 를 설정하지 않으면 기본값은 local_ca 이지만, GitLab.com의 공개 프로젝트는 기본값이 sigstore 입니다. status string 증명의 상태. 가능한 값: success 또는 error . subject_digest string 아티팩트의 16진수 인코딩된 SHA-256 해시. updated_at datetime 증명이 마지막으로 업데이트된 날짜와 시간. 요청 예시: curl --request GET \ --url "https://gitlab.example.com/api/v4/projects/namespace%2fproject/attestations/5db1fee4b5703808c48078a76768b155b421b210c0761cd6a5d223f4d99f1eaa" 응답