> 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/match-unmatched-components.md).

# 구성 요소 매칭

## 개요

SBOM(Software Bill of Materials)을 업로드하거나 구성 요소를 수동으로 추가한 후, 소프트웨어 구성 요소, 버전, 공급업체의 조합이 NVD(National Vulnerability Database)의 기존 고유 항목과 자동으로 일치하지 않아 여러 상태가 표시될 수 있습니다.

**구성 요소의 취약점을 확인하려면 Matched NVD 이외의 모든 상태를 해결해야 합니다.** 다음 단계에 따라 이러한 상태를 해결하면 소프트웨어 구성 요소가 다음 항목과 정확하게 일치하도록 할 수 있습니다.

### 구성 요소 해결 시 워크스페이스 컨텍스트 이해하기

구성 요소 일치 항목을 해결할 때는 다음 사항을 확인하세요.

* **현재 워크스페이스에 집중**: 현재 워크스페이스의 구성 요소에 대한 일치 항목을 해결합니다
* **조직 전체에서 사용할 별칭**: 생성한 별칭은 모든 워크스페이스에서 유사한 구성 요소를 식별하는 데 도움이 됩니다
* **일치 제안**: 모든 매칭 소스(NVD, 패키지 관리자)는 조직 전체에서 사용할 수 있는 리소스입니다
* **취약점 데이터의 이점**: 성공적으로 매칭된 구성요소는 작업 공간과 관계없이 취약점 데이터를 받습니다

## 매칭 상태

### Select match, Matched to package manager, Not found 상태 해결

* A **Select match**  상태는 소프트웨어 구성요소, 버전, 공급업체 조합에 여러 잠재적 매칭 항목이 있어 올바른 매칭 항목을 판단하기 어려운 경우를 의미합니다.
* A **Matched**  상태에 패키지 관리자 배지가 표시되지만 NVD 배지는 표시되지 않는다면, 해당 구성요소에 알려진 취약점이 없거나 NVD에서 다른 이름으로 등록되어 있음을 나타냅니다.
* A **찾을 수 없음** 상태는 소프트웨어 구성 요소, 버전, 공급업체의 조합을 NVD의 기존 항목과 자동으로 일치시키지 못했음을 의미합니다. 해당 구성 요소에 취약점이 없거나, NVD에서 다른 이름으로 등록되어 있을 수 있습니다.

## **잠재적 일치 항목 검토(Select match 또는 Not found 상태만 해당)**

1. 다음을 클릭합니다. **Match status** 배지를 클릭하여 다음을 엽니다. **Resolution options** 모달을 연 다음 다음을 클릭합니다. **View suggestions** 에 있는 버튼 **Select match** 상자. 그러면 **Multiple matches** 모달이 표시됩니다. 여기에서 다음 세부 정보를 바탕으로 옵션을 평가할 수 있습니다.
   * **Supplier:** 잠재적 일치 항목과 연관된 공급업체의 이름입니다.
   * **Name:** 소프트웨어 구성 요소의 이름입니다.
   * **Sample versions:** CVE 취약점 데이터에서 추출된 버전입니다.
   * **일치 유형:** 여기에는 가능한 일치 항목을 판별하는 데 사용된 출처가 표시됩니다. 예를 들어 별칭, 이름, CPE(Common Platform Enumeration), PURL(Package URL) 또는 특정 패키지 관리자 일치 항목이 있습니다.
2. 결정을 내리는 데 추가 정보가 필요하면 세부 정보 아이콘을 클릭합니다. 그러면 다음 항목이 열립니다. **일치 세부 정보** 모달에서 구성 요소의 추가 버전을 확인하고 시간 경과에 따른 보고된 취약점을 살펴볼 수 있습니다. 보고된 취약점 추세가 구성 요소 버전과 일치하면 높은 신뢰도로 일치한다고 볼 수 있습니다.
3. **별칭 만들기:** 올바른 일치 항목을 확인한 후 해당 일치 항목을 구성 요소에 연결하는 별칭을 만들 수 있습니다. 이 별칭을 사용하면 동일한 소프트웨어 구성 요소, 버전 및 공급업체 조합이 포함된 SBOM을 이후에 업로드할 때 이 별칭이 자동으로 적용됩니다.
4. **검토 메모 추가:** 클릭 **Actions > 검토 메모 추가** 평가 상태를 팀에 알리고, 추가 검토를 제안하거나, 소프트웨어 구성 요소와 관련된 중요한 위험을 강조할 수 있습니다.

### 일치 제안 필드

드래그할 항목을 선택하려면 스페이스바를 누르세요. 드래그하는 동안 화살표 키를 사용해 항목을 이동하세요. 스페이스바를 다시 누르면 새 위치에 항목이 놓이고, Esc 키를 누르면 취소됩니다.

<table><thead><tr><th width="152.9791259765625">이름</th><th>설명</th></tr></thead><tbody><tr><td>공급업체</td><td>구성 요소를 공급한 조직입니다. 공급업체는 제조업체인 경우가 많지만, 유통업체나 재포장업체일 수도 있습니다(예: Windows의 Microsoft).</td></tr><tr><td>세부정보 아이콘</td><td>이 아이콘을 클릭하면 시간 경과에 따른 보고된 취약점과 CVE에서 확인된 버전을 비롯해 가능한 일치 항목의 세부정보를 더 볼 수 있습니다. 이러한 버전이 구성 요소의 버전과 일치하고 보고된 취약점이 있다면 올바른 일치 항목일 가능성이 높습니다.</td></tr><tr><td>제품 이름</td><td>다른 시스템에서는 구성 요소라고 부를 수 있는 항목입니다. 이는 장치의 물리적 구현에 설치되는 펌웨어, 소프트웨어, 패치 또는 운영 체제입니다(예: Windows, OpenSSL).</td></tr><tr><td>일치 기준</td><td>일치 강도를 나타냅니다. 자세한 내용은 일치 출처를 참조하세요.</td></tr><tr><td>Type</td><td><p>일치 항목의 신뢰도를 나타냅니다.</p><ul><li>정확히 일치: NVD에서 정확히 일치하는 항목입니다. 여기에는 PURL 문자열(Cargo, NPM, Nuget 또는 Pypi 패키지 관리자), CPE 문자열 또는 이름이 일치하는 경우가 포함될 수 있습니다.</li><li>별칭 일치: 이 구성 요소가 기존 별칭과 일치합니다.</li><li>일치 가능성 있음: 이 구성 요소가 하나 이상의 출처에서 일치 항목을 찾았습니다. 일치 기준 열을 확인한 다음, 일치하는 토큰 위에 마우스 포인터를 올려 자세한 정보를 확인하세요.</li></ul></td></tr></tbody></table>

시간 경과에 따른 보고된 취약점 추이와 이 일치 제안에 대해 알려진 버전을 확인하면 올바른 일치 항목일 가능성을 평가할 수 있습니다. 보고된 취약점 추이가 있고 구성 요소의 버전(또는 최소한 버전 형식)과 일치하는 항목이 여러 개라면 더 신뢰할 수 있는 일치로 간주됩니다.

#### 일치 세부정보 필드

드래그할 항목을 선택하려면 스페이스바를 누르세요. 드래그하는 동안 화살표 키를 사용해 항목을 이동하세요. 스페이스바를 다시 누르면 새 위치에 항목이 놓이고, Esc 키를 누르면 취소됩니다.

<table><thead><tr><th width="194.2447509765625">이름</th><th>설명</th></tr></thead><tbody><tr><td>시간 경과에 따른 보고된 취약점</td><td>보고된 취약점 추이가 있는 일치 항목이 여러 개라면 해당 구성 요소가 자주 사용된다는 의미입니다. 시간 경과에 따른 보고된 취약점이 많지 않다면 올바른 일치 항목이 아닐 가능성이 높습니다. 구성 요소의 버전(또는 최소한 버전 형식)이 신뢰할 수 있는 일치 기준에 부합하는지 확인하세요.</td></tr><tr><td>알려진 버전</td><td>제안된 일치 항목에 대해 CVE 취약점 ID에서 가져온 알려진 버전입니다. 구성 요소의 버전(또는 최소한 버전 형식)이 이 버전들과 일치하는지 확인하세요.</td></tr></tbody></table>

## Fix version 상태 해결

SBOM을 업로드하거나 구성 요소를 수동으로 추가한 후 구성 요소 버전 옆에 경고 아이콘과 Fix version 일치 상태가 표시될 수 있습니다. 이는 버전 형식이 예상되는 공급업체 버전 형식과 일치하지 않음을 나타냅니다.

1. 경고 아이콘이 표시된 구성 요소의 **Fix version** 상태 배지를 클릭하세요. 또는 경고 아이콘이 표시된 구성 요소에서 **Actions > Fix version** 을 선택하세요.
2. 버전 형식을 확인해 알려진 버전 번호와 일치하는지 확인하고, 필요한 경우 수정한 다음 저장하세요.
3. 문제가 계속되면 [문의해 주세요](mailto:support@medcrypt.com) 지원을 받으세요.

## Contact us 상태 해결

SBOM을 업로드하거나 구성 요소를 수동으로 추가한 후 구성 요소 버전 옆에 오류 아이콘과 함께 **Contact us** 일치 상태가 표시될 수 있습니다. 이는 이 특정 버전 형식을 처리하는 버전 파서가 없음을 의미합니다.

* 이 아이콘이 표시되면 해당 문제를 인지하고 있습니다. 다만 더 신속한 해결이 필요하면 [문의해 주세요](mailto:support@medcrypt.com) 신속한 지원을 받으실 수 있습니다.
* **이 버전 파서를 추가하면 어떻게 되나요?** 새 버전 파서 형식에 대한 지원을 추가하면 영향을 받는 모든 SBOM과 해당 구성 요소를 자동으로 다시 불러와 NVD의 알려진 소프트웨어와 일치하는지 확인합니다. 문제가 해결되면 알려드립니다.
* **이것이 어떤 영향을 미치나요?**
  * **정확히 일치:** NVD에 등록된 알려진 취약점이 모두 반영됩니다.
  * **취약점 불일치:** 취약점 수에 차이가 있더라도 걱정하지 마세요. 이는 정확한 추적과 보고를 보장하기 위한 과정의 일부입니다.
  * **일치 항목 여러 개:** 제안을 검토하여 올바른 일치 항목을 확인하세요.
  * **일치 항목 없음:** NVD에서 정확히 일치하는 항목을 찾을 수 없다면 해당 구성 요소가 NVD에 없거나(알려진 취약점이 없음을 의미) 다른 이름으로 등록되어 있을 수 있습니다. 이러한 경우 NVD를 확인하거나 별칭 규칙을 만들어 모든 SBOM에서 해당 구성 요소를 연결해야 합니다.

### Fix version 상태 해결

SBOM을 업로드하거나 구성 요소를 수동으로 추가한 후 구성 요소 버전 옆에 경고 아이콘과 함께 다음 항목이 표시될 수 있습니다. **버전 수정** 일치 상태가 표시됩니다. 이는 버전 형식 또는 PURL 값이 예상 값과 일치하지 않음을 나타냅니다.

1. 경고 아이콘이 표시된 구성 요소에서 **버전 수정** 일치 상태 배지를 클릭하거나 **작업 > ... > 버전 수정** 을 클릭합니다. 그러면 **구성 요소 관리** 패널이 열립니다.
2. 버전 경고는 일반적으로 PURL 또는 버전 형식이 잘못되어 발생합니다. 구성 요소의 PURL과 버전을 확인하여 문제가 해결되는지 살펴보세요. 버전 형식이 알려진 버전 번호 및 PURL과 일치하는지 확인하세요.
3. 문제가 계속되면 [지원팀에 문의하세요](mailto:support@medcrypt.com).

### Contact us 상태 해결

SBOM을 업로드하거나 구성 요소를 수동으로 추가한 후 구성 요소 버전 옆에 오류 아이콘과 함께 다음 항목이 표시될 수 있습니다. **문의하기** 일치 상태가 표시됩니다. 이는 이 버전 형식에 사용할 수 있는 버전 파서가 없음을 나타냅니다. 이 아이콘이 표시되면 해당 문제를 이미 인지하고 있습니다. 다만 더 빠른 해결이 필요하면 [지원팀에 문의하세요](mailto:support@medcrypt.com).

**이 버전 파서를 추가하면 어떻게 되나요?**

새 버전 파서 형식을 지원하게 되면 영향을 받는 모든 SBOM과 해당 구성 요소를 자동으로 다시 불러와 NVD의 알려진 소프트웨어와 일치시키려고 합니다. 문제가 해결되면 알림을 보내드립니다.

**어떤 영향을 받나요?**

* **정확히 일치하는 항목을 찾음:** NVD에 등록된 알려진 취약점이 구성 요소와 연결됩니다. 취약점 수에 차이가 있더라도 걱정하지 마세요. 이 과정은 정확한 추적 및 보고를 보장하기 위한 절차입니다.
* **일치 항목 선택:** 제안된 항목을 검토하여 올바른 일치 항목을 판단해야 합니다.
* **일치 항목을 찾지 못함:** 이는 해당 구성 요소가 NVD에 없거나(알려진 취약점이 없음을 의미) 다른 이름으로 등록되어 있음을 나타낼 수 있습니다. 이러한 경우 NVD에서 올바른 일치 항목을 확인한 다음 [별칭을 생성하여](/ko/helm/match-unmatched-components/create-and-manage-alias-rules-to-match-and-rematch-components-across-all-products.md) 앞으로 소프트웨어 구성 요소가 올바르게 연결되도록 하세요.

## 일치 정밀도 제어

개별 구성 요소의 일치 문제를 해결하기 전에 Helm에서 CPE와 PURL의 일치를 처리하는 방식을 조정할 수 있습니다. 기본적으로 Helm은 일치 정확도를 높이기 위해 CPE와 PURL을 자동으로 보강하지만, 제공한 CPE 및 PURL과 정확히 일치하는 항목만 필요할 때는 이 동작을 재정의할 수 있습니다. 이 설정은 새 제품 버전에 자동으로 켜집니다.

**정확히 일치하도록 설정해야 하는 경우**

* 규정 준수 요건에 따라 특정 CPE 또는 PURL 값을 수동으로 선별한 경우
* SBOM에 수정해서는 안 되는 정확한 CPE/PURL 데이터가 포함된 경우

**일치 동작 구성**

1. 구성 요소 **구성 요소** 표에서 **설정** 드롭다운을 클릭합니다.
2. 끄기 **SBOM CPE 자동 일치 재정의** 를 끄면 값을 제공한 경우 정확히 일치하는 CPE만 사용합니다.
3. 끄기 **SBOM PURL 자동 일치 재정의** 를 끄면 값을 제공한 경우 정확히 일치하는 PURL만 사용합니다.

{% hint style="success" %}
중요: 이 설정은 CPE/PURL 데이터를 수동으로 추가하거나 업로드한 구성 요소에만 영향을 줍니다. 기존 CPE 또는 PURL이 없는 구성 요소는 포괄적인 취약점 범위를 보장하기 위해 계속 자동 보강됩니다.
{% endhint %}

**영향 이해하기**

* 자동 보강 활성화(기본값 - 스위치 끔): 더 넓은 범위에서 일치시켜 일치율을 높입니다.
* 정확한 일치 활성화(스위치 켬): 일치의 정확도는 높아지지만 찾을 수 있는 일치 항목은 줄어들 수 있습니다.
* 이 선택을 할 때 일치 정확도와 취약점 범위 간의 상충 관계를 고려하세요.

## 일치 정밀도 제어

개별 구성 요소 일치 항목을 해결하기 전에 Helm이 CPE 및 PURL 일치를 처리하는 방식을 조정할 수 있습니다. 기본적으로 Helm은 일치 정확도를 높이기 위해 CPE와 PURL을 자동으로 보강하지만, 제공한 CPE 및 PURL과 정확히 일치해야 하는 경우 이 동작을 재정의할 수 있습니다.

**정확히 일치하도록 설정해야 하는 경우**

* 규정 준수 요구 사항에 따라 특정 CPE 또는 PURL 값을 직접 선별해 관리한 경우
* SBOM에 수정해서는 안 되는 정밀한 CPE/PURL 데이터가 포함된 경우
* 규제 또는 감사 목적으로 정확한 일치가 필요한 경우

#### 일치 동작 구성

1. 다음 **구성 요소** 표에서 **설정** 드롭다운을 클릭합니다
2. 전환 **SBOM CPE 자동 매칭 재정의** 하여 값을 입력한 경우 정확히 일치하는 CPE만 요구합니다.
3. 전환 **SBOM PURL 자동 매칭 재정의** 하여 값을 입력한 경우 정확히 일치하는 PURL만 요구합니다.

{% hint style="success" %}
**중요:** 이 설정은 CPE/PURL 데이터를 수동으로 추가하거나 업로드한 구성 요소에만 적용됩니다. 기존 CPE 또는 PURL이 없는 구성 요소는 포괄적인 취약점 범위를 보장하기 위해 계속 자동으로 보강됩니다.
{% endhint %}

#### 영향 이해하기

* **자동 보강 사용** (기본값 - 끔): 더 넓은 매칭 범위로 일치율 향상
* **정확히 일치하는 항목만 검색 사용** (켜짐): 더 정밀하게 일치 항목을 찾지만, 검색되는 항목 수가 줄어들 수 있습니다
* 이 선택을 할 때 일치 정확도와 취약점 범위 간의 상충 관계를 고려하세요.

## 구성 요소 검토 추가

일치 항목을 찾거나 잠재적 일치 항목을 평가한 후 또는 다른 조사를 수행한 후, 팀의 중복 작업을 줄일 수 있도록 메모를 추가할 수 있습니다.

1. 클릭합니다 **Actions > ... > Add review**. 그러면 다음이 표시됩니다. **Review component** 패널입니다.
2. 구성 요소에 아직 **검토됨** 상태로 자동 업데이트됩니다. **검토됨**.
3. 검토 메모를 추가한 다음 저장합니다. 그러면 다음 항목이 업데이트됩니다. **검토 상태** 해당 구성 요소의 검토 상태가 업데이트되고 메모 아이콘이 추가됩니다. [현재 보기에서 이 열이 표시되는지 확인하세요.](/ko/helm/get-started-with-helm/get-familiar-with-the-helm-ui.md#why-cant-i-see-some-columns).


---

# 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/match-unmatched-components.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.