> 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/manage-sbom/manage-component.md).

# 구성요소 관리

## 개요

구성 요소의 라이선스, 일치 방식 및 검토 정보를 포함한 세부 정보를 확인할 수 있습니다. Software Bill of Materials (Products) 페이지에서  **Actions ... > Manage component** 를 선택하여 구성 요소 세부 정보를 수정합니다.

다음  **Manage component**  패널에는 구성 요소가 포함된 제품, 구성 요소 자체와 일치 방식, 수명 주기와 라이선스 정보 및 검토 세부 정보가 표시됩니다. 구성 요소 테이블에서  **Actions ... > Manage component** 를 선택하여 구성 요소 세부 정보를 수정합니다.

### **Product details** <a href="#product-details" id="product-details"></a>

* **Product name:** 제품 이름입니다.
* **Product version:** 제품 버전입니다.

**개별 구성 요소 작업**

* **구성 요소 관리**: 이 작업을 수행하면 [모든 세부 정보가 표시됩니다](/ko/helm/manage-sbom/manage-component.md#dependency-component-details) 보기 모드에서 이 구성 요소의 모든 세부 정보를 확인할 수 있습니다. 또한 Helm이 구성 요소를 어떻게 일치시켰는지와 팀의 검토 정보도 표시됩니다. 구성 요소를 편집하면 변경 사항을 확인하라는 메시지가 표시됩니다. Helm이 구성 요소를 다시 로드하고 다시 일치시켜 추가한 검토 정보를 모두 삭제하기 때문입니다.
* **검토 메모 추가**: 검토 메모를 추가한 다음 검토 상태를 Reviewed로 변경합니다. 검토 상태 열에 메모 아이콘과 함께 업데이트된 상태가 표시됩니다.
* **검토 기록**: 팀에서 작성한 분석 메모나 검토 상태 변경 내역을 확인할 수 있습니다. 여기에서 검토 메모를 추가할 수도 있습니다.
* **구성 요소 다시 로드**: 구성 요소가 부정확하거나 지원되지 않는 버전으로 인한 것이 아닌 오류 상태라면 다시 로드할 수 있지만, 이 작업이 필요한 경우는 거의 없습니다. 오류 상태가 발생했을 때를 대비한 예비 조치입니다. Helm은 구성 요소에 대한 이전 정보를 모두 삭제하고 알려진 소프트웨어와 일치시키려고 시도합니다.
* **CPE 및 PURL 자동 보강**: Helm은 자동으로 업데이트하고 [구성 요소 식별 정보인 CPE 및 PURL 데이터를 보강합니다](/ko/helm/manage-sbom/manage-component.md#enhanced-cpe-parsing-and-matching) 더 정확하게 일치시키기 위해서입니다.
* **누락된 라이선스 정보 추가**: [구성 요소 자동 보강](/ko/helm/manage-sbom/manage-component.md#automatically-generate-component-license-information) Helm 데이터 소스에서 누락된 라이선스 데이터를 가져와 보강합니다.
* **수명 주기 규칙 생성**: [자동화된 규칙 설정](/ko/helm/automate-and-integrate/create-and-manage-lifecycle-rules-to-automate-eos-and-eol-information-across-all-products.md) 관리할 **지원 수준** 및 **EOS/EOL** 제품 전반의 정보(을 통해 **Rules manager**).
* **일치 상태 배지 클릭:** Helm 표의 일치 상태 배지를 클릭하면 일치 항목 구분, 버전 수정, 문의 등 추가 정보를 빠르게 확인할 수 있습니다.
* **명확한 다음 단계:** 각 구성 요소에 대해 수행해야 할 다음 단계가 명확한 경우 해당 단계는 **Actions** 열에 표시됩니다. 그렇지 않으면 **작업 더보기 ...** 버튼만 표시됩니다.
* **구성 요소 삭제**: [개별 구성 요소 제거](/ko/helm/manage-sbom/manage-component.md#delete-component) 제품 버전에서.

### **Component details** <a href="#dependency-component-details" id="dependency-component-details"></a>

* **Component name:** 기기의 물리적 구현체에 설치된 구성 요소(종속성)의 이름입니다. 구성 요소에는 펌웨어, 소프트웨어, 프레임워크, 라이브러리, 파일, 운영 체제 등이 포함됩니다(예: Windows, OpenSSL). SBOM에 명시된 구성 요소 이름입니다.
* **Version:** SBOM에 명시된 해당 구성 요소의 버전입니다(예: Windows의 경우 10.1).
* **Supplier:** 구성 요소를 공급한 조직입니다. 공급업체는 제조업체인 경우가 많지만 유통업체나 재포장 업체일 수도 있습니다(예: Windows의 경우 Microsoft). SBOM에 명시된 구성 요소 공급업체입니다.
* **Matched dependency name:** 일치 과정에서 Helm은 일치 정확도를 높이기 위해 구성 요소 이름을 보강할 수 있습니다. 이 필드는 이름이 보강된 경우에만 표시됩니다.
* **Matched dependency version:** 일치 과정에서 Helm은 일치 정확도를 높이기 위해 구성 요소 버전을 보강할 수 있습니다. 이 필드는 버전이 보강된 경우에만 표시됩니다.
* **Matched dependency supplier:** 일치 과정에서 Helm은 일치 정확도를 높이기 위해 공급업체 이름을 보강할 수 있습니다. 이 필드는 공급업체 정보가 보강된 경우에만 표시됩니다.
* **Original CPE:** SBOM 파일에서 이 구성 요소에 할당된 원본 PURL입니다. 형식 예시: (예: cpe:2.3:part:vendor:product:version:update:edition:language:sw\_edition:target\_sw:target\_hw:other)
* **Enriched CPE:** 구성 요소 일치 과정에서 해당 패키지 관리자로부터 추가되거나 보강된 PURL입니다. 값이 있는 경우에만 표시되며 수정할 수 없습니다.
* **Original PURL:** SBOM 파일에서 이 구성 요소에 할당된 원본 CPE입니다. 형식 예시: (예: scheme:type/namespace/name\@version?qualifiers#subpath)
* **Enriched PURL:** 구성 요소 일치 과정에서 AI 코파일럿이 추가하거나 보강한 CPE입니다. 값이 있는 경우에만 표시되며 수정할 수 없습니다.

### **CPE 및 PURL 자동 보강** <a href="#enhanced-cpe-parsing-and-matching" id="enhanced-cpe-parsing-and-matching"></a>

Helm이 더 정확하게 일치하는 항목을 감지하거나 도출할 수 있는 경우 구성 요소의 CPE 또는 PURL을 자동으로 업데이트하고 보강합니다. 제공한 CPE 또는 PURL과 정확히 일치해야 하는 경우  [이 자동 일치를 재정의](/ko/helm/match-unmatched-components.md#control-matching-precision) 할 수 있습니다.

* **Enriched CPE:** Helm의 AI 코파일럿이 구성 요소의 CPE와 일치하거나 더 정확하게 일치하는 항목을 찾으면 해당 구성 요소의 Enriched CPE 필드에 정보를 자동으로 입력합니다. 기존 CPE가 있는 경우 Original CPE 필드에 그대로 유지됩니다.
* **Incomplete CPE:** Helm은 불완전한 CPE를 해석하고, 누락된 CPE 세그먼트를 와일드카드(\*)로 채웁니다. 단, 가능한 13개 세그먼트 중 최소 5개가 있어야 합니다.
* **Enriched PURL:** Helm의 AI 코파일럿이 구성 요소의 PURL과 일치하거나 더 정확하게 일치하는 항목을 찾으면 해당 구성 요소의 Enriched PURL 필드에 정보를 자동으로 입력합니다. 기존 PURL이 있는 경우 Original PURL 필드에 그대로 유지됩니다.

이 정보는 구성 요소 테이블에서 확인할 수 있으며, 보강된 SBOM, FDA SBOM 또는 VDR 보고서를 비롯하여 SBOM 구성 요소가 포함된 FDA 보고서로 내보낼 수 있습니다.

### **Match details** <a href="#match-details" id="match-details"></a>

Helm이 구성 요소를 일치시켰거나 일치를 시도한 방식입니다.

* **Match status:** 현재  [일치 상태를 보여줍니다.](broken://spaces/vNSbMpAkAfWOaOQ7r1kN/pages/JHh1vpAMvG0U8Xxoy1vS)및 어떤 [소스가](broken://spaces/vNSbMpAkAfWOaOQ7r1kN/pages/vRbfm4YC86Lxmqfrmtfk) 일치했는지도 표시합니다.
* **취약점 소스:** 이 구성 요소를 찾은 소스입니다. 현재는 항상 NVD입니다. NVD에서 찾을 수 없는 경우 [찾을 수 없음](/ko/helm/match-unmatched-components/understand-match-statuses.md#not-found) 배지가 표시됩니다.
* **일치 기준:**
  * **시스템:** Helm은 NVD에서 정확히 일치하는 항목을 기준으로 이 구성 요소를 자동으로 일치시켰습니다. 일치 항목은 CPE, PURL 패키지 관리자 또는 이름/버전/공급업체 정보에서 찾았을 수 있습니다.
  * **별칭:** Helm은 팀에서 만든 별칭을 기준으로 이 구성 요소를 자동으로 일치시켰습니다.
  * **시스템 별칭:** Helm은 저희가 만든 전역 별칭을 기준으로 이 구성 요소를 자동으로 일치시켰습니다.
  * **사용자 이름:** 이 사용자는 이 구성 요소를 제안된 일치 항목과 수동으로 연결하거나, 알려진 소프트웨어와 연결하기 위해 새 별칭을 만들었습니다.

### 수명 주기 세부 정보

새 장치를 개발할 때 구성 요소가 지속적으로 유지 관리되고 있는지 확인하거나 더 안정적인 버전으로 업그레이드하는 일을 우선시할 수 있습니다. 현장에 배포된 장치를 업데이트할 때는 지원 종료 또는 수명 종료가 가까운 구성 요소의 업그레이드를 우선시할 수 있습니다. 이를 통해 전체 수명 주기 동안 장치의 안정성과 보안을 보장할 수 있습니다.

이 정보는 다음에도 입력됩니다: [FDA SBOM 보고서](/ko/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports.md) 또는 [SBOM CSV 보고서](/ko/helm/ensure-fda-readiness/fda-ready-sbom-and-vulnerability-reports.md).

* **지원 수준:** 구성 요소가 지속적으로 유지 관리되고 있는지 지정합니다. 날짜 또는 텍스트 값을 지정할 수 있습니다.
* **EOS/EOL:** EOS 또는 EOL 날짜나 기타 텍스트 값을 입력합니다.

#### 포트폴리오 전반에 걸쳐 일관된 수명 주기 정보 유지

[규칙 생성 ](/ko/helm/automate-and-integrate/create-and-manage-lifecycle-rules-to-automate-eos-and-eol-information-across-all-products.md)을 통해 제품 전반의 특정 구성 요소 기준에 따라 수명 주기 정보를 자동으로 업데이트할 수 있습니다. 이 작업은 **규칙 관리자**.

### 라이선스 세부 정보

라이선스 세부 정보 섹션에는 각 구성 요소의 포괄적인 라이선스 정보가 표시됩니다. Helm은 CycloneDX 및 SPDX SBOM에서 라이선스 정보를 가져오고 Tidelift 파트너십 통합을 통해 해당 정보를 보강합니다. 자세한 내용은 [라이선스 관리](/ko/helm/manage-sbom/manage-licenses.md) 를 참조하세요.

**라이선스 정보 필드**

* **라이선스 유형**: 이 필드는 SBOM의 라이선스 정보에서 입력되며, 다음 중 하나일 수 있습니다.
* **라이선스 표현식**: 여러 SPDX 라이선스를 AND 또는 OR로 결합하거나 SPDX 라이선스 예외를 사용하는 구성 요소의 경우
* **개별 라이선스**: SBOM 구성 요소에 AND, OR 또는 +로 결합되지 않은 여러 SPDX 라이선스가 포함되어 있거나 구성 요소에 사용자 지정 라이선스가 있는 경우
* **라이선스 없음(SPDX에서 NONE)**: SBOM 구성 요소에 연결된 라이선스가 없다고 확신하는 경우
* **알 수 없음(SPDX에서 NOASSERTION)**: SBOM에 연결된 라이선스가 있는지 확실하지 않은 경우

#### **라이선스 정보 자동 보강**

"라이선스 없음" 또는 "알 수 없음" 상태의 구성 요소에 대해 Helm은 Tidelift 파트너십 통합 데이터를 사용하여 고유한 PURL을 가진 오픈 소스 구성 요소의 라이선스 정보를 식별하고 추가하도록 자동으로 시도합니다.

#### **누락된 구성 요소 라이선스 정보 자동 추가** <a href="#automatically-generate-component-license-information" id="automatically-generate-component-license-information"></a>

Helm은 라이선스가 연결되지 않은 새 SBOM 구성 요소의 누락된 라이선스를 감지하고 자동으로 보강합니다. 기존 구성 요소의 라이선스 정보도 Helm이 자동으로 추가하도록 설정할 수 있습니다.

1. 라이선스 정보로 보강할 구성 요소에서 다음을 클릭합니다. **Actions > Reload component**.
2. 이 구성 요소를 다시 로드하면 메타데이터(예: 검토 정보, 일치 상태, 관련 취약점 등)가 모두 삭제되므로, 확인 메시지가 표시됩니다. 다시 로드한 후에는 관련 취약점을 다시 식별하므로 해당 구성 요소의 취약점 수가 달라질 수 있습니다. 이렇게 하면 라이선스 정보를 직접 추적하는 데 드는 수고를 줄이고, 데이터 소스에서 제공하는 최신 라이선스 정보를 확인할 수 있습니다.

### 검토 세부 정보 <a href="#review-details" id="review-details"></a>

이 구성 요소에 대해 가장 최근에 추가된 검토 정보가 표시됩니다. 직접 검토 정보를 추가하거나 모든 검토 정보를 볼 수도 있습니다.

* **검토 상태:** 구성 요소를 검토했는지 또는 검토가 필요한지 표시합니다. 이 배지를 클릭하면 새 상태를 설정할 수 있습니다.
* **최근 검토일:** 사용자가 이 구성 요소를 마지막으로 검토한 시점을 표시합니다.
* **최근 검토자:** 이 구성 요소를 마지막으로 검토한 사용자를 표시합니다.
* **마지막 검토:** 이 구성 요소에 대한 마지막 검토 메모로, 팀에 진행 상황, 최종 상태 또는 중대한 위험을 알립니다.

## 개별 구성 요소 편집 <a href="#edit-dependency-component" id="edit-dependency-component"></a>

이 항목에서는 구성 요소 세부 정보를 관리하는 방법을 다룹니다. 그 밖의 모든 구성 요소 작업은 구성 요소 표의 **작업** 열에서 사용할 수 있습니다.

1. 편집하려는 구성 요소에서 **Actions ... > Manage component를 클릭합니다.**
2. 클릭합니다. **편집** 편집하려는 섹션에서 클릭합니다. 단, 다음 항목은 편집할 수 없습니다. **일치 세부 정보** 섹션입니다.
3. 다음 항목의 필드를 수정한 후 **Component details** 섹션에서 변경 사항을 저장하면 이 구성 요소를 다시 불러오라는 메시지가 표시됩니다. 이 경우 구성 요소가 새로 평가되며, 직접 추가한 매칭 정보, EOS/EOL, 라이선스 또는 검토 정보를 포함한 이전 메타데이터가 모두 삭제됩니다.
4. 업데이트된 구성 요소가 표시되지 않으면 **Auto-refresh** 가 켜져 있는지 확인하거나 **Refresh** 를 클릭해 페이지를 수동으로 업데이트하세요.

### 구성 요소 삭제

클릭 **Actions > Remove (Delete)** **구성 요소**. 삭제한 구성 요소는 복구할 수 없으므로 확인 메시지가 표시됩니다. 이 작업은 이 제품 버전에서만 해당 구성 요소를 삭제합니다.


---

# 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/manage-sbom/manage-component.md?ask=<question>&goal=<user_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.