> For the complete documentation index, see [llms.txt](https://docs.medcrypt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.medcrypt.com/ko/helm/get-started-with-helm/upload-your-first-sbom.md). # 첫 SBOM 업로드 첫 SBOM을 업로드할 준비가 되셨나요? 또는 SBOM이 무엇인지 잘 모르시겠나요? 도와드리겠습니다! Helm은 CycloneDX 및 SPDX SBOM 형식을 모두 지원하므로 소프트웨어 구성 요소를 쉽게 관리할 수 있습니다. ## **SBOM 업로드를 위한 워크스페이스 컨텍스트 이해하기** 워크스페이스는 기본적으로 조직 내 부서나 사업부와 같은 조직 단위입니다. SBOM을 업로드할 때는 다음 사항을 참고하세요: * **제품은 워크스페이스별로 관리됩니다**: 업로드 중에 생성하는 모든 제품은 현재 워크스페이스에 속합니다. 제품을 생성한 후에는 다른 워크스페이스로 이동할 수 없습니다. 다른 워크스페이스에 제품을 생성하려면 먼저 [워크스페이스를 전환한](/ko/helm/get-started-with-helm/get-familiar-with-the-helm-ui.md#selected-workspace) 후 이동 경로 드롭다운 또는 계정 메뉴를 사용하세요. * **버전 관리**: 제품 버전도 워크스페이스 범위로 관리됩니다 * **구성 요소 표시 범위**: 업로드한 구성 요소와 해당 취약점은 해당 워크스페이스 내에서만 확인할 수 있습니다 이를 통해 서로 다른 사업부나 팀 간에 데이터가 적절히 분리됩니다. ## CycloneDX 또는 SPDX SBOM 업로드 1. 아직 SBOM을 추가하지 않았다면 **Upload SBOM** 버튼을 클릭하세요. * 팀에서 이미 SBOM을 업로드했다면 **Manage SBOMs > Upload SBOM**. 2. 압축된 SPDX SBOM 파일을 업로드하는 경우, [다음 단계를 따르세요](#upload-a-compressed-spdx-file). {% hint style="success" %} **지원되는 SBOM 버전 및 형식** **버전:** * **CycloneDX:** 1.3(가져오기만 지원), 1.4(가져오기 및 내보내기 지원), 1.5(가져오기만 지원) * **SPDX:** 2.2, 2.3 **형식:** * **CycloneDX:** .json, .xml * **단일 SPDX 파일:** .spdx, .json, .yaml, .xml * **압축된 SPDX 파일:** .gz, .tgz, .zip, .zst, .tzst * **Excel:** .xlsx, .xls * **CSV** **파일 크기:** 50MB {% endhint %} 2. 에서 **SBOM type** 드롭다운을 열고 **Document**. 3. 파일을 선택하거나 **SBOM file** 필드에 끌어다 놓으세요. 1. [**Excel 또는 CSV**](#upload-a-csv-or-excel-sbom): 이 파일 중 하나를 업로드하면 **Generate CycloneDX** 버튼이 표시됩니다. 4. 클릭하세요. **Upload SBOM**. 1. **EOS/EOL 정보를 포함해야 하나요?** EOS/EOL 정보가 포함된 CycloneDX SBOM은 [이 속성에](#including-lifecycle-information). 2. Windows KB 패치 정보를 포함해야 하나요? WinKB가 포함된 CycloneDX SBOM은 [이 속성에](#including-windows-kb-patch-information). 5. SBOM 구성 요소가 로드되지 않는다면 **Auto-refresh** 가 켜져 있는지 확인하거나 페이지를 수동으로 새로고침하세요. SBOM 파일이 클수록 처리 시간이 더 걸립니다. 1. 그래도 SBOM이 표시되지 않으면 **Manage SBOMs > View file upload status**를 클릭하세요. 여기에서 **Failed** 상태가 표시되면 해당 상태 옆의 아이콘을 클릭하여 자세한 정보를 확인하세요. 2. 문제를 해결할 수 없다면 [문의해 주세요](mailto:support@medcrypt.com) . 6. SBOM을 업로드하면 해당 제품에 포함된 모든 구성 요소가 페이지에 표시됩니다. 이미 NVD의 데이터를 가져와 매칭을 시작하고 있습니다. 매칭에는 Cargo, NPM, Nuget 또는 Pypi 패키지 관리자의 Package URL(PURL), CPE 문자열, 구성 요소 이름/버전/공급업체 조합 및 별칭 매칭이 포함됩니다. 7. 이 SBOM에 추가 SBOM을 통합하고 병합하려면 **Manage SBOMs > Upload SBOM**을 클릭하세요. 그러면 해당 SBOM의 구성 요소가 기존 SBOM에 추가됩니다. 8. 구성 요소 버전 옆에 경고 또는 오류 아이콘이 표시되면 아이콘을 클릭하여 자세한 정보를 확인하세요. 1. 경고가 표시된 경우에는 버전만 수정하면 되지만, 오류가 표시된 경우에는 [문의해 주세요](mailto:support@medcrypt.com) . 2. 이 구성 요소를 매칭하고 취약점 정보를 반환하려면 먼저 이 문제를 해결해야 합니다. ### **압축된 SPDX 파일 업로드** 압축된 SPDX SBOM 파일이 있다면 다음 단계에 따라 업로드하세요. 1. **파일 준비**: * zip 파일 이름으로 사용할 이름의 디렉터리를 만드세요. * 해당 디렉터리로 이동하여 다음 이름의 하위 디렉터리를 만드세요. `packages` 이 디렉터리에 만드세요. * 개별 SBOM 파일을 `packages` 디렉터리에 복사하세요. 2. **파일 압축**: * 다음 명령을 사용하여 파일을 다음 형식으로 압축하세요. `.tar.gz` 또는 `.zip` : * **.tar.gz 만들기**: `COPYFILE_DISABLE=1 tar -zcvf yourfilename.tar.gz yourdirectory` * **.zip 만들기**: `zip -r yourfilename.zip yourdirectory -x '**/.*'` 3. **파일 업로드**: * 압축이 완료되면 Helm으로 이동하여 다음 파일을 업로드하세요. `.tar.gz` 또는 `.zip` 다음에 이어지는 압축 파일 [업로드 절차는](#have-a-cyclonedx-or-spdx-sbom) 위에 설명되어 있습니다. 수명 주기 정보를 포함하려면 CycloneDX SBOM에서 사용할 수 있는 지원 속성은 다음과 같습니다. 이 정보는 **제품** 표의 해당 열과 구성 요소 세부 정보에 표시됩니다. SBOM에 동일한 구성 요소에 대한 중복 속성이 포함된 경우 Helm은 첫 번째 속성만 사용하고 나머지는 무시합니다. 각 필드에는 날짜 값이나 텍스트 값 중 하나만 포함할 수 있습니다. 둘 다 포함하면 Helm UI에는 날짜만 표시됩니다. ### **CSV 또는 Excel SBOM 업로드** {% hint style="warning" %} **이 기능은 베타 버전입니다.** 의견과 이 경험을 개선하기 위해 할 수 있는 일을 알려주세요! {% endhint %} CSV 및 Excel 파일을 Helm에 직접 업로드하면 CycloneDX SBOM으로 자동 변환할 수 있습니다. 따라서 다음이 필요하지 않습니다. [수동 변환 도구나 스크립트](/ko/helm/get-started-with-helm/dont-have-an-sbom/convert-your-sbom-from-csv-to-cyclonedx.md). 1. 을 클릭합니다. **Upload SBOM** 버튼을 클릭합니다. 2. 표시되는 모달에서 제품 이름과 버전을 지정합니다. 3. 에서 **SBOM type** 드롭다운을 열고 **Document**. 4. 파일을 선택하거나 **SBOM file** 필드에 끌어다 놓으세요. 5. 을 클릭합니다. **Generate CycloneDX SBOM**. 6. 업로드하기 전에 데이터를 미리 확인합니다. 구성 요소 정보를 검토하여 모든 내용이 올바른지 확인하고 서식 문제를 찾아냅니다. 7. 을 클릭합니다. **Upload** 을 클릭하여 SBOM을 변환하고 가져옵니다. 8. 가져오기가 완료되면 SBOM을 취약점 분석 및 해결에 사용할 수 있으며, 다음 형식으로 내보낼 수 있습니다. [CycloneDX, SPDX 또는 CSV 형식](/ko/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports.md), 그리고 당사의 [전문가가 작성한 FDA SBOM](/ko/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports/meet-fda-requirements-with-your-fda-sbom-report.md)도 내보낼 수 있습니다. 또한 다음 보고서도 내보낼 수 있습니다. [VEX 및 VDR 보고서](/ko/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports/vex-and-vdr-reports.md). ## 수명 주기 정보를 포함하시겠습니까? 수명 주기 정보를 포함하려면 CycloneDX SBOM에서 사용할 수 있는 지원 속성은 다음과 같습니다. 이 정보는 **제품** 표의 해당 열과 구성 요소 세부 정보에 표시됩니다. SBOM에 동일한 구성 요소에 대한 중복 속성이 포함된 경우 Helm은 첫 번째 속성만 사용하고 나머지는 무시합니다. 각 필드에는 날짜 값이나 텍스트 값 중 하나만 포함할 수 있습니다. 둘 다 포함하면 Helm UI에는 날짜만 표시됩니다. 이러한 속성을 사용하려면 전체 네임스페이스 값을 포함해야 합니다(예: `cdx:lifecyle:milestone.endOfSupport` 또는 `medcrypt:lifecycle:milestone:endOfLifeText)` 의 `name` 필드에 입력하고 속성의 `value` 에 해당 값을 입력해야 합니다. CycloneDX SBOM의`component` 및/또는 `metadata > components` 배열에서 가져오고 내보냅니다. 1. **지원 수준(날짜):** 가져올 때는 다음 속성을 지원합니다. `cdx:lifecycle:milestone:endOfSupport` 이름 속성 또는 `eos_date` (Medcrypt 전용 이름 속성)입니다. 내보낼 때는 CycloneDX 기본 속성을 사용합니다. 2. **EOS/EOL(날짜):** 가져올 때는 다음 속성을 지원합니다. `cdx:lifecycle:milestone:endOfLife` 이름 속성 또는 `eol_date` (Medcrypt 전용 이름 속성)입니다. 내보낼 때는 CycloneDX 기본 속성을 사용합니다. 3. **지원 수준(텍스트):** 가져올 때는 다음 속성을 지원합니다. `medcrypt:lifecycle:milestone:endOfLifeText` 또는 `eol_text` 이름 속성을 지원합니다. 내보낼 때는 \``medcrypt:lifecycle:milestone:endOfLifeText`. 4. **EOS/EOL(텍스트):** 가져올 때는 다음 속성을 지원합니다. `medcrypt:lifecycle:milestone:levelOfSupportText` 또는 `eos_text` 이름 속성을 지원합니다. 내보낼 때는 \``medcrypt:lifecycle:milestone:levelOfSupportText`. **구성 요소 배열을 사용한 지원 종료 예시** ``` ... "component" : { "name" : "[PRODUCT_NAME]", "version" : "2.2.3". "type" : "application", "bom-ref" : "dd8fc70b-767a-4398-885c-bbd0e8f6c68", "properties" : [ { "name" : "cdx:lifecycle:milestone:endOfSupport", "value" : "2026-02-07T22:00:0Z" }, {{ "name" : "medcrypt:lifecycle:milestone:levelOfSupportText", "value" : "Q1 2026" } ... ``` 자세한 내용은 [CycloneDX GitHub 저장소 ](https://github.com/CycloneDX/cyclonedx-property-taxonomy/blob/479acf89cc0595995ad20d7fa9439f007250b050/cdx/lifecycle.md)에서 기본 제공 속성을 확인하세요. **구성 요소 배열을 사용한 지원 종료 예시** ``` ... "component" : { "name" : "[PRODUCT_NAME]", "version" : "2.2.3". "type" : "application", "bom-ref" : "dd8fc70b-767a-4398-885c-bbd0e8f6c68", "properties" : [ { "name" : "cdx:lifecycle:milestone:endOfSupport", "value" : "2026-02-07T22:00:0Z" }, {{ "name" : "medcrypt:lifecycle:milestone:levelOfSupportText", "value" : "Q1 2026" } ... ``` 자세한 내용은 [CycloneDX GitHub 저장소 ](https://github.com/CycloneDX/cyclonedx-property-taxonomy/blob/479acf89cc0595995ad20d7fa9439f007250b050/cdx/lifecycle.md)에서 기본 제공 속성을 확인하세요. ## **Windows KB 패치 정보를 포함하시나요?** CycloneDX는 Windows KB 정보를 기본적으로 지원하지 않습니다. 따라서 Windows KB 패치 정보를 포함하려면 CycloneDX SBOM에서 다음 Medcrypt 전용 속성을 사용할 수 있습니다. 이 속성을 사용하려면 전체 네임스페이스 값(예: `medcrypt:vulnerability:remediation:mskb` )을 `name` 필드에 포함하고 해당 값을 속성의 `value` 에 포함해야 합니다. CycloneDX SBOM의 `component` 또는 `metadata > components` 배열에서 가져오고 내보냅니다. CycloneDX SBOM의`component` 및/또는 `metadata > components` 배열에서 가져오고 내보냅니다. * 가져오기와 내보내기에서는 `medcrypt:vulnerability:remediation:mskb` 이름 속성을 지원합니다. 단, 원본 SBOM에서 KB가 어디에 있었든 내보낼 때는 `metadata > component` 에만 배치됩니다. **component 배열을 사용한 Windows KB 예시** ``` ... "component" : { "name" : "[PRODUCT_NAME]", "version" : "2.2.3". "type" : "application", "bom-ref" : "dd8fc70b-767a-4398-885c-bbd0e8f6c68", "properties" : [ { "name" : "medcrypt:vulnerability:remediation:mskb", "value" : "KB12849" }, {{ "name" : "medcrypt:vulnerability:remediation:mskb", "value" : "KB994849" } ... ``` ## 수명 주기 정보를 포함하시겠습니까? 수명 주기 정보를 포함하려면 다음 지원 속성을 사용하세요. 이 정보는 **제품** 표의 해당 열과 구성 요소 세부 정보에 표시됩니다. SBOM에 동일한 구성 요소에 대한 중복 속성이 포함된 경우 Helm은 첫 번째 속성만 사용하고 나머지는 무시합니다. 각 필드에는 날짜 또는 텍스트 값 중 하나만 포함할 수 있습니다. 둘 다 포함하면 하나만 업로드됩니다. 1. **지원 수준(날짜):** 가져오기는 다음을 지원합니다. `cdx:lifecycle:milestone:endOfSupport` 속성 또는 `eos_date` (Medcrypt 전용 속성). 내보낼 때는 CycloneDX 기본 속성이 사용됩니다. 2. **EOS/EOL(날짜):** 가져오기는 다음을 지원합니다. `cdx:lifecycle:milestone:endOfLife` 속성 또는 `eol_date` (Medcrypt 전용 속성). 내보낼 때는 CycloneDX 기본 속성이 사용됩니다. 3. **지원 수준(텍스트):** 가져오기는 다음을 지원합니다. `medcrypt:lifecycle:milestone:endOfLifeText` 또는 `eol_text`. 내보내기 형식은 \``medcrypt:lifecycle:milestone:endOfLifeText`. 4. **EOS/EOL(텍스트):** 가져오기는 다음을 지원합니다 `medcrypt:lifecycle:milestone:levelOfSupportText` 또는 `eos_text`. 내보내기 형식은 \``medcrypt:lifecycle:milestone:levelOfSupportText`. ## **종속성 데이터를 포함하시겠습니까?** CycloneDX SBOM에 구성 요소의 종속성 데이터가 있는 경우 Helm은 이러한 종속 관계를 캡처하고 보존하며, CycloneDX 형식으로 다시 내보낼 때 이를 포함합니다. 따라서 구성 요소 관계 데이터가 포함된 CycloneDX SBOM을 사용할 때 데이터의 충실도와 완전성을 보장할 수 있습니다. ## **업로드 후에는 어떻게 되나요?** SBOM을 업로드하면 Helm은 NVD(National Vulnerability Database)에 등록된 알려진 소프트웨어와 구성 요소의 일치 항목을 자동으로 찾기 시작합니다. 이 과정에서는 여러 [일치 소스](/ko/helm/match-unmatched-components/understand-match-sources.md)를 활용합니다. 여기에는 Package URL(PURL), CPE 문자열, 구성 요소 이름 및 별칭 일치가 포함됩니다. 자세한 내용은 일치 상태 및 일치 상태 해결을 참조하세요. 자세한 내용은 [일치 소스](/ko/helm/match-unmatched-components/understand-match-sources.md) 에서 참조하는 소스를 확인하고, [일치 상태](/ko/helm/match-unmatched-components/understand-match-statuses.md) 에서 일치 상태를 판단하는 방법과 가능한 일치 항목을 제안하는 방식을 알아보세요. ## **SBOM 없이 제품 및 버전 만들기** 1. 에서 **제품 선택** 드롭다운을 열고 **제품 만들기**를 선택한 다음 제품 이름을 지정하고 **저장**을 클릭합니다. 이 제품은 현재 작업 공간에 생성되며, 생성 후에는 다른 작업 공간으로 이동할 수 없습니다. 다른 작업 공간에 제품을 만들려면 먼저 [작업 공간 전환](/ko/helm/get-started-with-helm/get-familiar-with-the-helm-ui.md#selected-workspace) 을 해야 합니다. 2. 에서 **버전 선택** 드롭다운을 열고 **버전 만들기**를 선택한 다음 버전을 지정하고 **저장**. 3. SBOM을 준비했으면 **SBOM 추가** 드롭다운 버튼을 클릭하고(**SBOM 관리** —이미 다른 SBOM을 업로드한 경우), 준비가 되면 **SBOM 업로드** 를 선택해 SBOM 파일을 추가합니다. ## **문제 해결 및 지원** 자동 새로고침을 껐을 수 있습니다. 표 위의 **자동 새로고침** 스위치를 켜서 다시 활성화하거나 새로고침을 클릭해 페이지를 수동으로 새로고침할 수 있습니다. ### **SBOM 구성 요소가 표시되지 않나요?** 자동 새로고침을 껐을 수 있습니다. 표 위의 **자동 새로고침** 표 위의 전환 버튼을 사용하거나 **새로고침** 을 클릭해 페이지를 수동으로 새로고침할 수 있습니다. 그래도 SBOM이 표시되지 않으면 **Manage SBOMs** 드롭다운 버튼 > **View file upload status**를 통해 SBOM 파일 업로드 상태를 확인하세요. 상태 모달에서 Failed 상태 옆의 아이콘을 클릭하면 자세한 정보를 확인할 수 있습니다. 도움이 필요하면 [문의해 주세요](mailto:support@medcrypt.com). ### **일치 항목 없음** Helm에서 NVD의 정확히 일치하는 항목을 찾을 수 없는 경우 [일치 상태 해결 ](/ko/helm/match-unmatched-components.md)에서 안내를 확인하세요. ### 업로드 문제 **용량이 큰 SBOM 파일인가요?** SBOM 파일이 크면 업로드에 시간이 조금 더 걸릴 수 있습니다. SBOM을 처리하는 동안 커피나 차 한 잔을 즐겨 보세요! 업로드가 성공적으로 완료되면 NVD의 알려진 소프트웨어와 자동으로 일치 항목을 찾기 시작합니다. **SBOM이 제대로 업로드되지 않은 것 같나요?** 그래도 SBOM이 표시되지 않으면 **Manage SBOMs** 드롭다운 버튼 > **View file upload status**를 통해 SBOM 파일 업로드 상태를 확인하세요. 상태 모달에서 **Failed** 상태 옆의 아이콘을 클릭하면 자세한 정보를 확인할 수 있습니다. 도움이 필요하면 [문의해 주세요](mailto:support@medcrypt.com). **SBOM에 구성 요소 해시가 포함되어 있음** 현재 Helm에서는 마스킹된 구성 요소 해시를 확인할 수 없지만, SBOM의 구성 요소 해시 정보는 보존되며 모든 [SBOM 보고서](/ko/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports.md). ## 시작하는 데 도움이 필요하신가요? ### **다른 SBOM 형식을 사용하시나요?** 다른 형식(예: Word, CSV)을 사용하시는 경우 [문의해 주세요](mailto:support@medcrypt.com) . 파일을 변환해 드리겠습니다. 현재 CycloneDX 형식 SBOM의 모든 데이터에 대한 지원을 확대하고 SPDX SBOM 형식도 지원하기 위해 작업하고 있습니다. 걱정하지 마세요. 저희가 도와드리겠습니다! 다음과 같은 분야에 [전문적인 평가, 지침 및 설계 지원을 제공할 수 있습니다](https://www.medcrypt.com/services/overview) 제품 개발 수명 주기에 사이버 보안과 지속적 개선을 반영하는 일부터 공개 키 기반 구조의 암호화, FDA 서신에 이르기까지 거의 모든 분야를 지원합니다. ### **SBOM을 생성해야 하나요?** 저희도 다양한 오픈 소스 도구를 사용해 왔으며, 다음을 생성하는 데 사용할 수 있는 다른 도구도 안내해 드립니다. [CycloneDX SBOM](/ko/helm/get-started-with-helm/dont-have-an-sbom/generate-cyclonedx-sbom-with-open-source-tools.md) 또는 [SPDX SBOM](/ko/helm/get-started-with-helm/dont-have-an-sbom/generate-spdx-sbom-with-open-source-tools.md). ### **SBOM이 무엇인지 모르거나 어디서부터 시작해야 할지 모르시나요?** 다음 설문에 참여해 보세요: [FDA 준비도 평가 설문](https://docs.google.com/forms/d/1REk-QXwY4JM3gYg87xXp7z-iddW1-m87ynn2HmWvkTo/viewform?edit_requested=true) 원활한 FDA 제출 절차를 위한 첫걸음을 시작해 보세요! --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.medcrypt.com/ko/helm/get-started-with-helm/upload-your-first-sbom.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.