> 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/understand-match-statuses.md).

# 매칭 상태 이해

{% hint style="warning" %}
**중요:** 다음과 같은 경우 **Matched** 상태에 **NVD** 배지가 표시되지 않는다면, 해당 항목이 NVD에서 매칭되지 않은 것입니다. 즉, 취약점이 없거나 NVD에서 다른 이름으로 등록되어 있을 수 있습니다. 자세한 내용은 [매칭 상태 해결](/ko/helm/match-unmatched-components.md) 을 참조하세요. 해당 구성 요소의 취약점을 확인하려면 NVD에서 정확히 일치하는 항목을 찾아야 합니다.
{% endhint %}

## 개요

각 구성 요소의 일치 상태는 구성 요소 표의 **일치 상태** 열에 표시됩니다. 상태 배지를 직접 클릭하여 해결 프로세스를 시작하거나, **작업** 열에서 작업을 선택할 수 있습니다. 일치를 식별하기 위해 다양한 메타데이터와 [일치 소스](/ko/helm/match-unmatched-components/understand-match-sources.md) 를 사용합니다. 여기에는 NVD, CPE, 별칭, 이름 및 지원되는 패키지 관리자(Cargo, NPM, NuGet, PyPI)가 포함됩니다.

### **구성 요소 일치에 대한 워크스페이스 컨텍스트 이해**

* **구성 요소 범위**: 모든 일치 상태 및 해결 작업은 현재 워크스페이스의 구성 요소에 적용됩니다
* **일치 소스**: 일치 여부를 확인할 때 조직 전체에서 제공되는 소스(NVD, 패키지 관리자, 별칭)를 사용합니다
* **별칭의 이점**: 관리자가 만든 별칭은 조직의 모든 워크스페이스에서 사용할 수 있습니다
* **워크스페이스 격리**: 한 워크스페이스에서 수행한 구성 요소 일치 작업은 다른 워크스페이스의 구성 요소에 영향을 주지 않습니다

## **NVD와 일치 상태**

이 상태는 해당 구성 요소가 National Vulnerability Database(NVD)에 등록된 소프트웨어와 정확히 일치함을 의미합니다. 즉, NVD에서 구성 요소와 정확히 일치하는 항목을 찾았으며 관련 취약점도 있으므로 이러한 위험의 [우선순위를 지정하고 수정하는](/ko/helm/manage-vulnerabilities.md) 작업을 시작할 수 있습니다.

## **패키지 관리자와 일치**

이 상태는 구성 요소가 패키지 관리자와 일치하지만 NVD에서는 찾을 수 없음을 나타내므로 취약점이 표시되지 않습니다. 패키지 관리자에서 NVD와 다른 이름이나 PURL을 사용하는 경우가 있으므로, 구성 요소가 다른 이름으로 등록되어 있지 않은지 NVD에서 확인해야 합니다. 자세한 내용은 [구성 요소 일치 또는 다시 일치시키기](/ko/helm/match-unmatched-components.md) 를 참조하세요.

패키지 관리자 Package URL(PURL)과 일치하면 Cargo, PyPI, NPM 또는 NuGet과 같은 패키지 관리자 배지가 표시됩니다.

## **별칭과 일치**

상태가 **일치** 이고 **ALIAS** 배지가 표시되면 구성 요소가 [별칭 규칙](/ko/helm/match-unmatched-components/create-and-manage-alias-rules-to-match-and-rematch-components-across-all-products.md)에 따라 일치된 것입니다. 자세한 내용은 [구성 요소 일치 또는 다시 일치시키기](/ko/helm/match-unmatched-components.md) 를 참조하세요.

### **그 밖의 일치 성공 사례:**

* **CPE와 일치:** 배지가 있는 **일치** 상태의 구성 요소에 **NVD** 배지와 **CPE** 배지가 표시되면, 해당 구성 요소에 NVD에 보고된 취약점이 하나 이상 있음을 의미합니다. CPE는 취약점이 NVD에 보고된 경우에만 소프트웨어에 할당됩니다. 자세한 내용은 [구성 요소 일치 또는 다시 일치시키기](/ko/helm/match-unmatched-components.md) 를 참조하세요. CPE는 가장 신뢰도가 높은 일치로 간주됩니다.
* **이름과 일치:** NAME 배지가 있는 일치 상태는 구성 요소의 이름/버전/공급업체 조합이 알려진 구성 요소의 이름/버전/공급업체 조합과 정확히 일치함을 나타냅니다.
* **사용자가 일치시킴:** 해당 **일치됨** 상태이며, **USER** 배지는 이 계정의 사용자가 수동으로 일치시켰음을 나타냅니다. 사용자가 일치시키는 과정에서 별칭 규칙을 만들었다면, 해당 항목은 **별칭** 일치 항목으로 간주됩니다.

### **일치 항목 선택**

이 상태는 Helm이 CPE, PURL, 별칭 또는 이름과 같은 식별자를 사용해 여러 잠재적 일치 항목을 찾았음을 나타냅니다. 배지 또는 기본 작업 링크를 클릭하여 제안된 일치 항목을 검토하고 평가할 수 있습니다. 자세한 내용은 [일치 상태 해결](/ko/helm/match-unmatched-components.md#resolve-select-match-or-not-found-status) 을 참조하세요.

### **찾을 수 없음**

찾을 수 없음 상태에는 검색한 소스가 표시됩니다. 이 상태는 해당 구성 요소가 NVD 또는 지원되는 패키지 관리자에서 알려진 소프트웨어와 일치하지 않음을 나타냅니다. 자세한 내용은 [일치 상태 해결](/ko/helm/match-unmatched-components.md#resolve-select-match-or-not-found-status) 을 참조하세요.

### **별칭 규칙을 만들어 알려진 소프트웨어에 자동으로 연결**

관리자는 [별칭 규칙](/ko/helm/match-unmatched-components/create-and-manage-alias-rules-to-match-and-rematch-components-across-all-products.md) 을 만들어 SBOM에서 여러 일치 항목이 있거나 NVD의 알려진 소프트웨어 구성 요소와 일치하지 않는 구성 요소를 일치시킬 수 있습니다.

### **기타 상태**

* **검사 중:** 이 임시 상태는 Helm이 일치 항목을 처리 중임을 나타냅니다. 기다렸는데도 이 업데이트가 표시되지 않으면 페이지를 새로고침해 보세요.
* [**버전 수정:**](/ko/helm/match-unmatched-components.md#resolve-fix-version-status) 이 구성 요소에 제공된 소프트웨어 버전이 예상 버전과 일치하지 않습니다. 드물게 발생하는 문제입니다. 이 메시지가 표시되면 버전 옆에 경고 아이콘도 표시됩니다. 자세한 내용은 [일치 상태 해결](/ko/helm/match-unmatched-components.md) 을 참조하여 이 문제를 해결하세요.
* [**문의:**](/ko/helm/match-unmatched-components.md#resolve-fix-version-status) Helm이 이 버전을 파싱하지 못했습니다. 이 문제를 기록했으며 신속하게 해결하기 위해 노력하겠습니다. 자세한 내용은 [일치 상태 해결](/ko/helm/match-unmatched-components.md) 을 참조하여 이 문제를 해결하세요.
* **오류:** 이 구성 요소를 파싱하는 중 다른 오류가 발생했습니다. [문의하기](mailto:support@medcrypt.com) 를 통해 이 문제 해결에 대한 도움을 받으세요.

### **자동 보강**

구성 요소에 올바른 CPE 또는 PURL 식별자가 있지만 공급업체 정보가 잘못된 경우, 원본 데이터를 보존하기 위해 시스템에서 Enriched CPE 또는 Enriched PURL 필드를 추가합니다. SBOM에 누락된 구성 요소의 CPE 또는 PURL을 식별할 수 있으면, 고유하게 일치하도록 해당 값을 이 필드에 자동으로 추가합니다.

### **자동 중복 제거**

Helm은 구성 요소의 고유성을 확인하기 위해 CPE 및 PURL ID를 검사합니다. 중복 항목이 감지되면 SBOM 관리를 간소화하기 위해 자동으로 제거됩니다.


---

# 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/understand-match-statuses.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.