> 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/create-and-manage-alias-rules-to-match-and-rematch-components-across-all-products.md).

# 별칭 규칙 생성 및 관리

## 개요

특정 구성 요소의 취약점을 확인하려면 각 구성 요소를 NVD의 알려진 소프트웨어와 일치시켜야 합니다. 별칭 규칙 관리자를 사용하면 별칭에 대한 견고한 일치 조건을 설정할 수 있으므로 알려진 소프트웨어를 검색하는 과정이 간소화되고, 올바른 소프트웨어 항목을 선택하는 데 도움이 되는 정보를 더 많이 확인할 수 있습니다.

* 별칭 규칙은 사용자가 수동으로 일치시킨 구성 요소를 덮어쓰지 않습니다.
* Account 소유자만 별칭 규칙과 수명 주기 규칙을 생성하고 관리할 수 있습니다.

### 별칭 규칙의 워크스페이스 컨텍스트 이해

별칭 규칙을 생성하고 관리할 때:

* **조직 전체에 적용되는 이점**: 별칭 규칙은 모든 워크스페이스의 구성 요소에 적용됩니다.
* **규칙 관리**: 모든 Workspace 관리자는 현재 워크스페이스와 관계없이 조직의 별칭 규칙을 확인할 수 있습니다.

### 별칭 규칙 관리자의 이점

* **중앙 집중식 규칙 관리**: 한곳에서 별칭 규칙과 EOS/EOL 수명 주기 규칙을 모두 관리할 수 있습니다.
* **향상된 매칭 기능**: 다음 정보를 사용하여 조건을 생성할 수 있습니다. **구성 요소 이름, 공급업체, CPE, PURL, 버전** 정보
* **투명성 향상**: 취약점 수, 알려진 버전, CPE, PURL 및 참조 정보를 포함한 잠재적 일치 항목의 상세 정보를 확인할 수 있습니다.
* **영향 범위 확인**: 기존 규칙을 변경하기 전에 모든 워크스페이스에서 영향을 받는 제품, 버전 및 구성 요소의 수를 확인할 수 있습니다.
* **충돌 처리**: 시스템이 잠재적인 규칙 충돌을 감지합니다.
* **자동 적용**: 규칙은 기존 SBOM과 향후 SBOM 모두에 자동으로 적용됩니다.

### 별칭 규칙의 영향 이해

별칭 규칙이 적용되면 다음에 영향을 미칩니다.

* **기존 SBOM**: 이전에 업로드한 SBOM에서 규칙과 일치하는 모든 구성 요소에 별칭 규칙이 적용됩니다.
* **향후 SBOM**: 규칙과 일치하는 구성 요소가 포함된 새 업로드 항목에는 규칙이 자동으로 적용됩니다.
* **매칭 상태**: 구성 요소 상태가 미매칭에서 "Matched"로 변경되고 "ALIAS" 배지가 표시됩니다.
* **취약점 데이터**: 알려진 소프트웨어에 NVD의 취약점 정보가 있는 경우, 해당 정보가 이제 구성 요소와 연결됩니다.
* **보고**: 별칭 규칙을 통해 매칭된 구성 요소는 지정된 매칭 항목과 함께 취약점 보고서에 표시됩니다.
* **우선순위**: 수동 매칭은 항상 별칭 규칙보다 우선합니다.

별칭 규칙을 수정하거나 삭제하면:

* 해당 규칙으로 이전에 매칭된 구성 요소는 이전의 미매칭 상태로 돌아갑니다.
* 해당 매칭을 통해 연결된 취약점 데이터는 더 이상 구성 요소와 연결되지 않습니다.
* 취약점 데이터를 복원하려면 새 별칭 규칙을 생성하거나 영향을 받는 구성 요소를 수동으로 매칭해야 합니다.

### 별칭 매칭 항목 보기

별칭을 보려면 사이드바에서 **Rules** 항목을 클릭합니다. 필요한 [권한](broken://pages/1e59bf2cd0925e84fae4b762be3306a5e3094fa7)이 있는 경우 **Alias rules** 탭에서 기존 별칭 규칙을 확인할 수 있습니다.

별칭과 일치하는 모든 구성 요소에는 다음이 표시됩니다. **일치함** 상태와 함께 다음 **별칭** 배지가 **일치 상태** 열의 **제품** 페이지에 표시됩니다.

### 별칭 규칙 추가

해결하려면 [**일치 항목 선택**](/ko/helm/match-unmatched-components.md#resolve-select-match-or-not-found-status), [**찾을 수 없음**](/ko/helm/match-unmatched-components.md#resolve-select-match-or-not-found-status), 기타 [일치 상태](/ko/helm/match-unmatched-components.md), Helm Account 소유자는 알 수 없는 구성 요소에서 직접 또는 사이드바의 **규칙** 항목에서 별칭 규칙을 만들 수 있습니다.

### **Rules manager에서 별칭 규칙 만들기**

에서 별칭 규칙을 만들 때 **규칙 관리자**, 별칭 규칙을 적용할 구성 요소 일치 조건을 지정해야 합니다.

1. 사이드바에서 **규칙** 항목을 클릭합니다. 그러면 별칭 및 수명 주기 규칙을 관리할 수 있는 **규칙** 페이지가 표시됩니다.
2. 다음을 클릭합니다. **별칭 추가** **규칙** 버튼 **별칭 규칙** 탭입니다. 그러면 다음 항목이 표시됩니다. **별칭 규칙 만들기** 마법사입니다.
3. 첫 번째 단계에서는 이 별칭 규칙을 자동으로 적용할 조건을 지정합니다. 각 메타데이터 필드마다 조건을 하나씩 추가할 수 있습니다.
   * 각 조건에는 AND 논리가 적용되므로, 효과를 적용하려면 모든 조건이 참이어야 합니다.
   * 기준과 정확히 일치하는 기존 별칭 규칙이 있으면, 보류 중인 편집 내용을 취소하거나 기준을 변경하라는 메시지가 표시됩니다.
4. 두 번째 단계에서는 알려진 구성 요소 이름 및/또는 공급업체를 지정한 다음, 다음을 클릭합니다. **알려진 소프트웨어 검색**.
   * 찾으려는 소프트웨어를 알고 있는 경우, 해당 소프트웨어 옆의 옵션 버튼을 클릭한 다음 다음을 클릭합니다. **Create alias rule**.
   * 어떤 소프트웨어가 가장 적합한 일치 항목인지 확실하지 않은 경우, 옵션 버튼을 클릭하여 해당 알려진 소프트웨어 구성 요소의 세부 정보를 확인합니다. 여기에는 취약점 정보, 관련 CPE 및 PURL, 참조 자료가 포함됩니다. 올바른 일치 항목을 확인하고 선택한 후 다음 버튼을 클릭합니다. **Create alias rule**.
5. 새 별칭 규칙이 규칙 목록의 맨 아래에 표시됩니다. 이 규칙의 우선순위를 높이려면 규칙 목록에서 더 높은 위치로 끌어다 놓을 수 있습니다.
6. 이 조건에 일치하는 구성 요소의 **Match status** 가 다음 상태로 업데이트됩니다: **Matched** , 별칭 유형: **ALIAS** 배지. Helm이 이 새 별칭 규칙을 모든 SBOM에 적용하고 기존 별칭 규칙과 대조하여 평가하므로 시간이 걸릴 수 있습니다. 해당 소프트웨어가 NVD에 등록되어 있거나 알려진 취약점이 있는 패키지 관리자에 포함되어 있으면, 관련 취약점이 반영되도록 업데이트됩니다.

### **구성 요소에서 별칭 규칙 만들기**

의 구성 요소에서 별칭 규칙을 만들면 **Products** 페이지에서 구성 요소 일치 조건이 자동으로 입력되며, 필요에 따라 수정할 수 있습니다. Helm 계정 소유자는 알 수 없는 구성 요소에서 직접 별칭 규칙을 만들거나 사이드바의 **Rules** 항목에서 별칭 규칙을 만들 수 있습니다.

1. 사이드바에서 **Products** 를 클릭합니다. 그러면 이 SBOM의 모든 구성 요소 목록인 **Products** 페이지가 표시됩니다.
2. 일치하지 않는 상태인 구성 요소의 경우, **Match status** 열의 배지 또는 **Actions** 열의 기본 버튼을 클릭합니다. 또는 **View match suggestions** 을 **... actions overflow** 버튼에서 선택할 수 있습니다. 그러면 **Select match suggestions** 패널이 표시됩니다.
3. 구성 요소 일치 조건을 변경하려면 1단계에서 변경한 다음 **Continue** 를 클릭하여 2단계에서 가능한 일치 항목을 업데이트합니다. 기준과 정확히 일치하는 기존 별칭 규칙이 있으면, 보류 중인 편집 내용을 취소하거나 기준을 변경하라는 메시지가 표시됩니다.
4. 의 **Component name** 필드에 필터링을 시작할 문자를 세 개 이상 입력합니다. 모든 조건 규칙은 영숫자로 구성해야 합니다. 구성 요소에 대해 알고 있는 다른 정보를 입력한 다음 **Continue**를 클릭합니다. 기준과 정확히 일치하는 기존 별칭 규칙이 있으면 기존 규칙을 유지하거나 새 규칙으로 대체하라는 메시지가 표시됩니다.
5. 다음 섹션에서 알려진 소프트웨어 구성 요소 이름 및/또는 공급업체를 입력한 다음 **Search known software** 를 클릭하여 잠재적 일치 항목을 확인합니다.
   * 찾으려는 소프트웨어를 알고 있는 경우, 해당 소프트웨어 옆의 옵션 버튼을 클릭한 다음 다음을 클릭합니다. **Create alias rule**.
   * 어떤 소프트웨어가 가장 적합한 일치 항목인지 확실하지 않은 경우, 옵션 버튼을 클릭하여 해당 알려진 소프트웨어 구성 요소의 세부 정보를 확인합니다. 여기에는 취약점 정보, 관련 CPE 및 PURL, 참조 자료가 포함됩니다. 올바른 일치 항목을 확인하고 선택한 후 다음 버튼을 클릭합니다. **Create alias rule**.
6. 새 별칭 규칙이 규칙 목록의 맨 아래에 표시됩니다. 이 규칙의 우선순위를 높이려면 규칙 목록에서 더 높은 위치로 끌어다 놓을 수 있습니다.
7. 이 구성 요소와 이 기준에 일치하는 모든 구성 요소의 **Match status** 가 **Matched** 로 업데이트되고 **ALIAS** 배지가 표시됩니다. Helm이 이 새 별칭 규칙을 모든 SBOM에 적용하고 기존 별칭 규칙과 대조하여 평가하므로 모든 구성 요소를 업데이트하는 데 시간이 걸릴 수 있습니다. 해당 소프트웨어가 NVD에 등록되어 있거나 알려진 취약점이 있는 패키지 관리자에 포함되어 있으면, 관련 취약점이 반영되도록 업데이트됩니다.

#### **규칙 명명 규칙**

규칙 이름은 지정된 기준에 따라 다음과 같이 정해집니다. `[Supplier name]/[Component name]/[Version]`. 현재 규칙 이름은 수정할 수 없습니다. 이 기능이 중요하다면 [알려주세요](mailto:support@medcrypt.com).

### 별칭 규칙 편집

별칭 규칙을 편집해야 하는 경우, 변경 사항이 기존 및 향후 SBOM 모두에 적용된다는 점에 유의하세요.

1. 사이드바에서 **Rules** 항목을 클릭합니다.
2. 클릭합니다 **Alias rules** 탭을 클릭합니다.
3. 의 **Alias rules** 탭에서 **Edit** 을 클릭합니다. 그러면 **Manage alias rule** 마법사가 표시됩니다. 현재 구성 요소 일치 조건과 선택된 알려진 소프트웨어 일치 항목이 표시됩니다.
4. 구성 요소 일치 조건을 변경하려면 1단계에서 변경한 다음 **Continue** 를 클릭하여 2단계에서 가능한 일치 항목을 업데이트합니다.
   * 기준과 정확히 일치하는 기존 별칭 규칙이 있으면, 보류 중인 편집 내용을 취소하거나 기준을 변경하라는 메시지가 표시됩니다.
5. 두 번째 단계에서는 현재 선택된 일치 항목과 검색 기준에 따라 가능한 다른 일치 항목을 확인할 수 있습니다. 선택한 일치 항목의 세부 정보 섹션에는 기존 규칙이 포트폴리오 전반에 미치는 영향, 알려진 취약점, 알려진 CPE 및 PURL, 추가 참고 자료를 확인하는 데 도움이 되는 여러 탭이 표시됩니다.
6. 일치 기준을 변경하려면 찾고 있는 알려진 소프트웨어의 일부 또는 전체를 입력한 다음 **Search known software**.
7. 일치 조건이나 선택한 알려진 일치 항목을 변경하면 변경 사항을 적용한 후 규칙을 다시 편집하기 전까지는 그 영향을 확인할 수 없습니다.
8. 클릭합니다 **Save & apply changes**. 변경 사항이 적용되면 성공 알림이 표시됩니다. 규칙을 편집해도 목록에서 현재 위치는 바뀌지 않으므로 우선순위를 변경하려면 규칙을 끌어다 놓아 위나 아래로 이동합니다.

### Alias rules의 우선순위 설정

Alias rules는 규칙 목록에서의 위치에 따라 적용됩니다.

1. 우선순위를 높이려면 규칙을 끌어다 위로 이동하고, 낮추려면 아래로 이동합니다.
2. 규칙 순서의 우선순위만 변경했고 삭제할 규칙을 표시하지 않았다면 **Save & apply changes**를 클릭합니다. 그러면 우선순위 변경 사항이 적용됩니다.
3. 규칙의 우선순위를 변경하는 동시에 삭제할 규칙도 표시했다면 이 버튼은 **Review changes** 로 바뀌며, 변경 사항을 확정하기 전에 예정된 삭제가 미치는 영향을 확인할 수 있습니다.

### Alias rule 삭제

팀에서 잘못된 Alias rule을 추가한 경우, **Administrator**.

1. 사이드바에서 **Rules** 항목을 클릭합니다.
2. 클릭합니다 **Alias rules** 탭을 클릭합니다.
3. 라면 쉽게 삭제할 수 있습니다. 삭제하려는 Alias rules에서 **Mark for deletion** 을 클릭합니다.
4. 예정된 삭제로 인해 규칙의 우선순위를 변경해야 하는 경우 해당 규칙을 목록에서 위나 아래로 끌어다 놓습니다.
5. 클릭합니다 **Review changes** 버튼을 클릭합니다.
6. 그러면 포트폴리오 전반에서 삭제할 경우의 영향을 보여 주는 확인 패널이 표시됩니다. 삭제 대기 중인 항목이 여러 개라면 **Continue** 를 클릭하여 다음 항목으로 이동합니다. 삭제 영향 검토가 필요하지 않으면 **Save & apply changes** 를 클릭할 수도 있습니다. 현재는 이 영향을 변경할 수 없습니다. [필요한 기능이라면](mailto:support@medcrypt.com) 저희에게 알려 주세요!
7. 변경을 마친 후 별도의 **Save & apply** **changes** 버튼을 Alias rules 목록 하단에서 클릭합니다. 그러면 해당 규칙은 기존 SBOM과 더 이상 연결되지 않으며 향후 SBOM에도 적용되지 않습니다.

### 문제 해결 및 모범 사례

* **규칙 이름 지정**: 현재는 규칙 이름을 수정할 수 없습니다. 규칙 이름은 조건에 따라 자동으로 생성됩니다.
* **규칙 충돌**: 조건이 유사한 규칙을 만들 때는 의도치 않게 서로 겹치지 않도록 확인하세요. 시스템은 완전히 중복되는 규칙이 있으면 경고합니다.
* **세션 지속성**: 페이지를 벗어나기 전에 변경 사항을 반드시 저장하세요. 저장하지 않은 변경 사항은 사라집니다.
* **규칙 우선순위 지정**: 더 구체적인 규칙이 일반적인 규칙보다 우선 적용되므로 목록의 위쪽에 배치하세요.
* **성능 고려 사항**:
  * 복잡한 조건을 포함하는 규칙을 많이 만들면 처리 시간이 늘어날 수 있습니다.
  * 대규모 규칙 변경 사항이 모든 SBOM에 반영되기까지 시간이 걸릴 수 있습니다.
* **확인**: 규칙을 적용한 후 일부 구성 요소를 표본으로 확인하여 규칙이 예상대로 작동하는지 검증하세요.
* **유지 관리**: 별칭 규칙이 현재 소프트웨어 매칭 요구 사항을 계속 반영하는지 주기적으로 검토하세요.

### 별칭 권한

* [**계정 소유자**](/ko/helm/administration/manage-access.md#account-owner-role)**:** 이 사용자는 모든 제품을 조회하고 수정할 수 있으며, 별칭을 만들고 기존 별칭을 사용하여 SBOM의 소프트웨어를 NVD에 등록된 소프트웨어와 연결할 수 있습니다. 계정 소유자는 한 명뿐입니다.
* [워크스페이스 관리자](/ko/helm/administration/manage-access.md#workspace-admin-role): 이 사용자는 모든 제품을 조회하고 수정할 수 있으며 기존 별칭을 사용할 수 있습니다.
* [**사용자:**](/ko/helm/administration/manage-access.md#user-role) SBOM 수정 권한이 있는 사용자만 기존 별칭을 사용할 수 있습니다. 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/create-and-manage-alias-rules-to-match-and-rematch-components-across-all-products.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.