--- sourceDocument: 호주 보안 관리 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/security-management Release : - australia ft:locale : - ko-KR ft:publication_title : - 호주 보안 관리 ft:clusterId : - security bundleId : - security workflow : - Technology --- # REST API를 사용하여 파일 업로드 소프트웨어 자재 명세서 # REST API를 사용하여 파일 업로드 소프트웨어 자재 명세서 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분 API를 사용하여 파일을 업로드 소프트웨어 자재 명세서 하기 전에 다음 정보를 검토합니다. ## REST API 사용 {#vr-sbom-preparing-upload__section_u41_c3p_xzb} API를 사용하여 SBOM 파일을 업로드하려면 sn_sbom_core.sbom_ingest 역할이 필요합니다. 업로드 API. 이 API는 SBOM 파일(CycloneDX/SPDX)을 인스턴스에 업로드하고 수집하는 데 사용됩니다. Core 버전 4.0 SBOM 은 다음을 지원합니다. * CycloneDx의 XML 및 JSON(버전 1.0\~1.6). * SPDX의 JSON(버전 2.2-2.3) * 주: 32MB를 초과하는 파일은 제대로 로드되지 않을 수 있습니다. {#vr-sbom-preparing-upload__ul_rys_3wh_2cc} HTTP 메서드: (POST) API URL: \/api/sbom/core/upload 주: 인스턴스 이름은 ServiceNow\입니다. 아래의 모든 요청 매개변수는 선택 사항입니다. 요청 본문은 SBOM 파일 내용입니다. DevOps를 개발 프로세스의 일부로 사용하는 경우 "requestedBy"의 값은 "devops"여야 합니다. DevOps에 대한 일반적인 정보는 문서를 참조하십시오 [DevOps SBOM 파일에 대해 업로드하는 중 소프트웨어 자재 명세서](https://servicenow-prod.fluidtopics.net/gKjxKoghY9TUm_wi8CvWMw "지속적 통합과 지속적 배포 개발 주기 동안 소프트웨어에 대한 파일을 생성하고 업로드 소프트웨어 자재 명세서 SBOM 합니다.") . "requestedby"의 값이 "devops"(개발 작업)인 경우 다음 매개변수는 필수입니다. * 빌드 ID * 수명주기스테이지 {#vr-sbom-preparing-upload__ul_p3t_z3h_2cc} 또한 'requestedBy'가 'devops'인 경우 fetchVulenrabilityInfo 및 fetchPackageInfo에 대한 데이터가 포함됩니다. * buildId- 보내는 문자열 * lifecycleStage - 두 개의 값, production 또는 pre_production * fetchVulenrabilityInfo- t/f * fetchPackageInfo-t/f {#vr-sbom-preparing-upload__ul_j2m_ybh_2cc} {#vr-sbom-preparing-upload__table_fsh_lgh_2cc__entry__3} | 매개변수 요청 | 가능한 값 | 설명 | |-|-|-| | productModelId | 시스템 ID | 지정된 의 루트 애플리케이션과 매핑할 제품 모델의 시스템 ID입니다 SBOM. | | businessApplicationId | 시스템 ID | 지정한 루트 애플리케이션과 매핑할 비즈니스 애플리케이션의 시스템 ID입니다 SBOM. | | businessApplicationName(사용하지 않음) | 비즈니스 애플리케이션 이름 | SBOM의 루트 애플리케이션과 매핑할 비즈니스 애플리케이션의 이름입니다. | | sbom소스 | Veracode예: | 파일의 소스 SBOM 입니다. | | requestedBy | 도구 또는 방법론의 이름인 Jenkins입니다. "devops"를 사용하는 경우 buildId 및 lifecycleStage는 필수입니다. | 업로드 요청자 | | 빌드 ID | 요청자가 보낸 문자열입니다. | 빌드의 빌드 ID입니다 SBOM . | | 수명주기스테이지 | 프로덕션 또는 pre_production | 엔터티의 수명 주기 스테이지입니다. | | fetchVulenrabilityInfo | 티/에프 | true일 경우 취약성 인텔리전스 통합을 트리거합니다. | | fetchPackage 정보 | 티/에프 | 예일 경우 패키지 인텔리전스 통합을 트리거합니다. | [ ] {#vr-sbom-preparing-upload__table_fsh_lgh_2cc} 업로드 API 응답: "상태" 성공/실패, "메시지"(문자열), "bomRecordId"(성공적인 SBOM 업로드를 위해 업로드 API를 통해 반환되는 SBOM의 시스템 ID임)이 포함되었습니다. { "result": { "status": "success", "message": "Queued for processing.", "bomRecordId": "f207059b4393c290629aa597cbb8f247" } } ## 상태 API {#vr-sbom-preparing-upload__section_jzy_rjh_2cc} 이 API는 수집을 위해 대기 중인 SBOM의 상태와 요약을 가져옵니다. * API URL: /api/sbom/core/upload/status * HTTP 메서드(GET) {#vr-sbom-preparing-upload__ul_pvm_3ch_2cc} {#vr-sbom-preparing-upload__table_rw2_fkh_2cc__entry__3} | 매개변수 요청 | 가능한 값 | 설명 | |-|-|-| | bomRecordId | 시스템 ID | 성공적인 SBOM 업로드를 위해 업로드 API를 통해 반환되는 SBOM 기록 ID입니다. | [ ] {#vr-sbom-preparing-upload__table_rw2_fkh_2cc} 상태 API 기본 응답 예입니다. { "result": { "bomRecordId": "0407c0fea3e70a505df340f5251e617e", "uploadStatus": "processed", "additionalInfoStatus": "not_requested", "uploadSummary": { "components": { "added": 0, "removed": 0, "total": 70 } } } } 추가 매개변수가 있는 상태 API 응답 예. 해당 SBOM에 대한 fetchVulenrabilityInfo를 요청한 경우 응답의 일부로 취약성 세부 항목을 가져옵니다. { "result": { "bomRecordId": "93af349b4393c290629aa597cbb8f258", "uploadStatus": "processed", "additionalInfoStatus": "complete", "uploadSummary": { "components": { "added": 0, "removed": 0, "total": 3 }, "vulnerabilityInfo": { "critical": 0, "high": 0, "medium": 0, "low": 0, "none": 0 } }, "buildId": "1" } } 해당 SBOM에 대해 fetchPackageInfo를 요청한 경우 응답의 일부로 부실 및 중단된 카운트가 표시됩니다. 성공적으로 SBOM 처리된 후 업로드된 기록을 보는 위치는 사용 중인 애플리케이션에 따라 다릅니다. * 응답을 사용하는 SBOM 경우 작업 공간의 BOM 큐 모듈 SBOM 에 있는 수집 상태 목록에 BOM 엔터티 기록이 표시됩니다SBOM. * SBOM Core를 사용하는 경우 SBOM CoreBOM 수집 상태. {#vr-sbom-preparing-upload__ul_dtp_21v_xzb} ## 지원되는 SBOM 표준 및 일반 사용 정보의 개선 사항 {#vr-sbom-preparing-upload__section_em2_wbp_xzb} Core 버전 4.0 SBOM 은 다음을 지원합니다. * CycloneDx의 XML 및 JSON(버전 1.0\~1.6). * SPDX의 JSON(버전 2.2-2.3) * 주: 32MB를 초과하는 파일은 제대로 로드되지 않을 수 있습니다. {#vr-sbom-preparing-upload__ul_hj5_vbb_2cc} Core v4.0 SBOM 부터 버전 1.0 - 1.6에 대한 CycloneDx 표준을 지원하기 위해 다음과 같은 개선 사항이 적용되었습니다. * (sn_sbom_core.collect_properties) 속성을 사용하여 CycloneDX SBOM 파일에 추가 정보를 임포트합니다. 이 속성은 기본적으로 비활성화되어 있습니다. 일반적으로 지원되지 않는 정보를 임포트하려면 속성을 활성화합니다. 이러한 속성에서 임포트된 모든 정보는 다음에 대한 SBOM 구성요소 속성 \[sn_sbom_comp_property\] 테이블에 업로드됩니다. * 업로드된 SBOM 파일 * 메타데이터 * 개별 취약성 * 구성 요소 {#vr-sbom-preparing-upload__ul_v5n_gbb_2cc} * CycloneDX 버전 1.4 이상의 SBOM 파일에 대한 선언 및 체결된 라이센스에 대해 가져온 구성요소 데이터를 두 개의 새 라이센스 필드에서 볼 수 있습니다. * 선언함 * 종료됨 {#vr-sbom-preparing-upload__ul_dv2_1bb_2cc} * SBOM 구문 분석 지원은 다음 CycloneDX 구성요소 유형에 대해 확장됩니다. * 버전 1.5: 플랫폼, 데이터, 장치 드라이버, 머신 러닝 모델 * 버전 1.6: 암호화 {#vr-sbom-preparing-upload__ul_ayz_mbb_2cc} {#vr-sbom-preparing-upload__ul_xp2_y1b_2cc} Core 버전 SBOM 3.0은 다음을 지원합니다. * CycloneDx의 XML 및 JSON(버전 1.4 포함). * SPDX의 JSON(최대 v2.3 포함). {#vr-sbom-preparing-upload__ul_h1l_1yh_2cc} 호출 사용자가 성공적으로 인증되고 인스턴스에 ServiceNow sn_sbom_core.sbom_ingest 역할이 있는 경우 인스턴스 외부에서 API에 액세스하여 데이터를 업로드할 수 있습니다.SBOM 데이터가 업로드되면 구문 분석됩니다. 데이터를 구문 분석하기 전에 다음 요구 사항이 검증됩니다. * 수신 데이터가 유효한 JSON 또는 XML인지 확인합니다. * BOM 형식이 지원됩니다. Core v2.1 SBOM 부터는 CycloneDX(JSON 및 XML) 및 SPDX(XML) 형식이 지원됩니다. * 데이터를 구문 분석할 수 있도록 최소 필드를 사용할 수 있습니다. {#vr-sbom-preparing-upload__ul_rrd_fcp_xzb} 이러한 검사가 확인되면 들어오 SBOM 는 데이터가 첨부 파일로 포함된 BOM \[sn_sbom_doc\] 테이블에 항목이 작성됩니다. Process BOM file 비즈니스 규칙은 기록 삽입 및 데이터 구문 분석의 결과로 자동으로 트리거됩니다. 주: 이 비즈니스 규칙은 기본적으로 코어를 SBOM 설치하는 동안 활성화됩니다. 에 SBOM 나열된 모든 구성요소에는 정의된 유형이 있습니다. * 파일이 업로드된 구성요소 SBOM 는 BOM 엔터티로 간주됩니다. * type=library로 나열된 구성요소는 외부 공급업체 구성요소로 간주됩니다. {#vr-sbom-preparing-upload__ul_srd_fcp_xzb} **관련 개념** * [작업 공간에서 소프트웨어 자재 명세서 보고서 및 대시보드 보기](https://servicenow-prod.fluidtopics.net/Gk~n3ueFquGwqDKgru879Q "취약성 분석가는 (SBOM) 작업 공간에서 기록, 데이터 시각화 및 향상된 취약성 인텔리전스에서 업로드된 소프트웨어 자재 명세서 파일을 확인합니다.소프트웨어 자재 명세서") **관련 태스크** * [파일의 업로드 상태 소프트웨어 자재 명세서 보기](https://servicenow-prod.fluidtopics.net/c6goby1dnOT7Ixj5UMgvPQ "(SBOM) 작업 공간의 BOM 큐 모듈 소프트웨어 자재 명세서 에 업로드한 소프트웨어 자재 명세서(SBOM) 파일의 업로드 상태를 확인합니다. 성공적으로 업로드한 파일, 업로드 이력 및 오류를 추적합니다.")