> 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/guardian/understand-device-provisioning/manage-device-provisioning.md).

# 기기 프로비저닝 관리

Guardian의 **Devices**  페이지에서 디바이스 프로비저닝을 관리하고 프로비저닝 보고서를 내보낼 수 있습니다. 프로비저닝 절차는 [Provisioning](/ko/guardian/understand-device-provisioning/begin-device-provisioning.md)  페이지에서 시작할 수 있습니다.

**연결이 끊긴 상태에서의 프로비저닝**

연결이 끊긴 상태에서 프로비저닝하려면 명령줄 또는 [Provisioning](/ko/guardian/understand-device-provisioning/begin-device-provisioning.md)  페이지에서 PR을 제출하고 인증된 프로필(CP)을 다운로드할 수 있습니다. 그런 다음 **Devices**  페이지에서 디바이스 프로비저닝을 관리하고 프로비저닝 보고서를 내보낼 수 있습니다. 이는 전체 프로비저닝 수명 주기 지원을 **Devices**  페이지에 추가하는 동안 제공되는 임시 솔루션입니다. 전체 워크플로 안내는 [디바이스 프로비저닝 이해하기](/ko/guardian/understand-device-provisioning.md).

**연결형 프로비저닝**

연결된 상태에서 프로비저닝하는 경우 디바이스가 자동으로 [Devices](/ko/guardian/understand-device-provisioning/manage-device-provisioning.md)  페이지에 요청을 제출합니다.

## 시스템 선택

1. 기본 탐색 모음의 이동 경로에서 **Select system name**  드롭다운을 클릭합니다. 페이지의 빠른 필터 드롭다운에서도 선택할 수 있습니다. 시스템 이름은 하나만 선택할 수 있으며, 이를 시스템 정의라고도 합니다.
2. 다음 드롭다운을 클릭합니다: **Filters** . 여기에서 시스템 인스턴스, 구성 요소 및 기타 기준으로 필터링할 수 있습니다.

## 승인 워크플로 이해하기

### 자동 승인 유형

이 승인 워크플로 유형에서는 프로비저닝 요청(PR)이 자동으로 확인, 승인 및 프로비저닝됩니다. 이 승인 유형에서는 PR을 수동으로 승인하거나 거부할 수 없습니다. 승인 워크플로는 다음 단계로 진행됩니다.

**확인 중** → **자동 승인됨** → **프로비저닝 중** → **프로비저닝 완료**

* **확인 중...**: PR이 막 접수되었으며 시스템에서 아직 자동 승인하지 않았습니다.
* **자동 승인됨:** PR이 시스템에서 자동 승인되었으며 곧 **프로비저닝 중**.
* **프로비저닝 중:** PR이 프로비저닝 중이거나 곧 프로비저닝되도록 대기열에 있습니다.
* **프로비저닝 완료:** PR의 프로비저닝이 완료되었습니다.
* **다양한 오류 코드:** 자세한 내용은 [문제 해결](#troubleshooting) 을 참조하세요.**.**

### 수동 승인 유형

프로비저닝 요청을 처리하려면 수동 승인이 필요합니다.

승인 워크플로는 다음 단계로 진행됩니다.

**확인 중** → **승인 필요** → **승인 중** → **프로비저닝 완료** → **프로비저닝 중** → **프로비저닝 완료**

* **확인 중...:** PR이 막 접수되었으며 시스템에서 아직 이를 **Needs approval** 상태입니다.
* **Needs approval:** 사용자가 PR을 수동으로 승인해야 합니다.
* **Approving...:** PR 승인이 진행 중입니다.
* **Complete provisioning:** 사용자가 PR을 수동으로 프로비저닝해야 합니다.
* **프로비저닝 중:** PR이 프로비저닝 중이거나 곧 프로비저닝되도록 대기열에 있습니다.
* **프로비저닝 완료:** PR의 프로비저닝이 완료되었습니다.
* **Rejecting...**: PR 거부가 진행 중입니다.
* **Rejected by user:** 사용자가 PR을 수동으로 거부했습니다.
* **다양한 오류 코드:** 자세한 내용은 [문제 해결](#troubleshooting) 을 참조하세요.**.**

### 개별 PR 승인

승인 유형이 **Manual** 인 경우 하나 이상의 기기에 대한 PR을 승인할 수 있습니다. 승인된 PR의 상태는 다음으로 변경됩니다: **Approved** 상태입니다.

1. 상태가 **Needs approval** 인 PR의 경우 다음 버튼을 확인할 수 있습니다: **Approve** 및 **Reject** 버튼은 다음 열에 있습니다: **Actions** 열입니다.
2. 다음 버튼을 클릭합니다: **Approve.** 확인 패널이 표시됩니다.
3. 패널에서 다음 버튼을 클릭합니다: **Approve PR** 그러면 PR 상태가 다음으로 변경됩니다: **Approving...**, 그다음 다음 상태로 변경됩니다: **Complete provisioning.** 성공 메시지가 표시됩니다.
4. 이 시점에서 PR을 거부하려면 다음 버튼을 클릭합니다: **Reject PR**. 그러면 상태가 다음으로 변경됩니다: **Rejected by user**. 성공 메시지가 표시됩니다.
5. 다음 정보를 확인할 수 있습니다: **Approved on** 및 **Approved by** 정보입니다. 테이블 상단의 다음 링크를 클릭하면 표시 항목을 사용자 지정할 수 있습니다: **Columns** 링크입니다.

### PR 일괄 승인

다음의 경우 **수동** 승인 유형에서는 하나 이상의 디바이스에 대한 PR을 승인하거나 거부할 수 있습니다. 승인된 PR은 다음 상태로 이동합니다. **승인됨**  상태입니다.

1. 다음 상태인 모든 PR에서 **승인 필요**  상태인 경우, 다음 버튼이 표시됩니다. **승인** 및 **거부** 버튼은 **작업** 열에 있습니다. 또한 일괄 작업 도구 모음의 **PR X개 승인** 작업 링크에 이 상태의 전체 PR 수도 표시됩니다(X는 해당 개수입니다).
2. 클릭합니다. **PR X개 승인** 도구 모음에서 클릭합니다. 확인 패널이 표시됩니다.
3. 클릭합니다. **패널에서 X개의 PR 승인** 합니다. PR 상태가 다음으로 변경됩니다. **승인 중...**, 그다음 **프로비저닝을 완료합니다.** 성공 메시지가 표시됩니다.
4. 이 시점에 PR을 거부하려면 다음을 클릭합니다. **X개의 PR 거부**. 그러면 해당 PR의 상태가 다음으로 변경됩니다. **사용자가 거부함** 성공 메시지가 표시됩니다.

### 개별 PR 거부

다음의 경우 **Manual**  승인 유형에서는 하나 이상의 장치에 대한 PR을 거부할 수 있습니다. 거부된 PR에는 다음 상태가 표시됩니다. **사용자가 거부함**  상태입니다.

1. 상태가 **Needs approval** 인 PR의 경우 다음 버튼을 확인할 수 있습니다: **Approve** 및 **Reject** 버튼은 다음 열에 있습니다: **Actions** 열입니다.
2. 클릭합니다. **거부.** 확인 패널이 표시됩니다.
3. 클릭합니다 **PR 거부** 패널에서. 그러면 **프로비저닝 상태** 다음으로 변경됩니다 **사용자가 거부함** 상태가 됩니다. 성공 메시지가 표시됩니다.
4. 다음에서 확인할 수 있습니다 **거부 날짜** 및 **거부한 사용자** 정보입니다. 테이블 상단의 **열** 링크를 클릭하여 표시 항목을 맞춤 설정하세요.

### PR 일괄 거부

다음 **수동** 승인 유형의 경우 하나 이상의 디바이스에 대한 PR을 일괄 거부할 수 있습니다. 거부된 PR은 다음 상태로 이동합니다. **거부됨** **사용자가 거부** 상태입니다.

1. 의 모든 PR에 대해 **승인 필요** 상태이면 **승인** 및 **거부** 버튼이 **작업** 열에서 표시됩니다. 또한 일괄 작업에서 이 상태의 전체 PR 수도 확인할 수 있습니다. **PR X개 거부** 도구 모음의 작업 링크(X는 이 숫자입니다).
2. 클릭합니다 **PR X개 거부** 도구 모음에서 클릭합니다. 거부할 PR의 요약을 검토할 수 있습니다.
3. 거부를 확인합니다.  **프로비저닝 상태** 다음 상태로 변경됩니다 **거부 중...**, 그런 다음 **사용자가 거부함** 상태입니다. 성공 메시지가 표시됩니다.
4. 다음에서 확인할 수 있습니다 **거부 날짜** 및 **거부한 사용자** 정보입니다. 테이블 상단의 **열** 링크를 클릭하여 표시 항목을 맞춤 설정하세요.

### 개별 장치 프로비저닝

다음의 경우 **수동** 승인 유형에서는 장치 PR을 승인한 후 해당 장치를 개별적으로 또는 일괄적으로 프로비저닝할 수 있습니다.

1. 다음 상태의 모든 PR에 대해 **프로비저닝 완료** 상태이면 **프로비저닝** 열의 버튼을 **Actions** 에서 클릭합니다.
2. 클릭합니다. **Provision**. 확인 패널이 표시됩니다.
3. 패널에서 **Provision device** 를 클릭합니다. 그러면 **Provisioning status** 로 이동합니다 **프로비저닝 중...**, 그다음 Provisioned 상태로 변경됩니다. 성공 메시지가 표시됩니다.
4. 다음 정보를 확인할 수 있습니다 **거부 날짜** 및 **거부자** 정보입니다. 테이블 상단의 **Columns**  링크를 클릭하여 표시 항목을 맞춤 설정하세요. 성공 메시지가 표시됩니다.

### 디바이스 일괄 프로비저닝

다음의 경우 **수동** 승인 유형에서는 장치 PR을 승인한 후 해당 장치를 개별적으로 또는 일괄적으로 프로비저닝할 수 있습니다.

1. 상태가 **프로비저닝 완료** 인 PR의 경우, 해당 디바이스가 **디바이스 X개 프로비저닝** 도구 모음의 작업 링크에서 표시됩니다. 또한 **프로비저닝** 버튼이 **Actions** 열에 표시됩니다.
2. 클릭합니다. **Provision**. 확인 패널이 표시됩니다.
3. 패널에서 **디바이스 X개 프로비저닝** 을 클릭합니다. **프로비저닝 상태** 는 **프로비저닝 중...**으로 변경된 다음 **프로비저닝 완료** 상태가 됩니다. 성공 메시지가 표시됩니다.
4. 다음 정보를 확인할 수 있습니다 **거부 날짜** 및 **거부자** 정보입니다. 테이블 상단의 **Columns**  링크를 클릭하여 표시 항목을 맞춤 설정하세요. 성공 메시지가 표시됩니다.

## 날짜 형식 변경

기본적으로 디바이스 프로비저닝 데이터는 UTC 시간과 **dd mmm yyyy** 형식으로 표시됩니다. ISO 형식으로 표시하거나 현지 시간으로 날짜를 표시하도록 변경할 수 있습니다.

1. 날짜 형식을 변경하려면 도구 모음의 **Settings** 드롭다운을 클릭하세요.**.**
2. 해당 날짜 설정을 전환하면 변경 사항이 자동으로 적용됩니다.

## Columns

기본적으로 모든 열이 표시되지는 않습니다. 테이블 상단의 **Columns**  링크를 클릭하여 표시 항목을 맞춤 설정하세요.

* **시스템 이름:** 시스템 정의입니다. 이를 시스템이라고도 합니다.
* **시스템 인스턴스 이름:** 시스템 이름의 특정 인스턴스입니다.
* **시스템 인스턴스 ID:** 시스템 인스턴스의 고유 ID입니다.
* **구성 요소 이름:** 시스템 인스턴스에 포함된 구성 요소입니다.
* **구성 요소 인스턴스 ID:** 구성 요소의 고유 ID입니다.
* **구성 요소 인스턴스 생성일:** 구성 요소 인스턴스가 생성된 날짜입니다.
* **기기 HW ID:** 기기의 고유 ID입니다.
* **승인 유형:** 조직에서 시스템 정의에 지정한 **수동** 또는 **자동**중 하나입니다.
* **프로비저닝 상태:** PR의 프로비저닝 상태를 표시합니다. 상태는 시스템에 정의된 승인 유형에 따라 달라집니다.
* **요청 ID:** 프로비저닝 요청의 고유 ID입니다.
* **요청 생성 날짜:** 프로비저닝 요청이 생성된 날짜입니다.
* **응답 ID:** 프로비저닝 응답의 고유 ID입니다.
* **응답 생성 날짜:** 프로비저닝 응답이 생성된 날짜입니다.
* **프로비저닝 소스:** 다음 중 하나입니다. **어플라이언스** 또는 **클라우드**. 이는 시스템 정의에서 조직이 지정한 값입니다.
* **승인 날짜:** 프로비저닝 요청이 승인된 날짜입니다.
* **승인자:** 다음 중 하나입니다. **시스템** 또는 사용자 이름입니다. 승인 유형으로 **자동** 을 사용하는 경우, 이 값은 **시스템**(으)로 설정됩니다. 또한 PR에는
* **거부 날짜:** 프로비저닝 요청이 거부된 날짜입니다.
* **거부자:** 다음 중 하나입니다. **시스템** 또는 사용자 이름입니다. 승인 유형으로 **자동** 을 사용하는 경우, PR이 당사 시스템에 의해 거부되면 이 값은 **시스템** (으)로 설정됩니다. 또한 다음 프로비저닝 상태가 표시됩니다. **시스템에 의해 거부됨** .
* **프로비저닝 날짜:** 프로비저닝 요청이 프로비저닝된 날짜입니다.
* **프로비저닝 수행자:** 다음 중 하나입니다. **시스템** 또는 사용자 이름입니다. 승인 유형으로 **자동** 을 사용하는 경우, PR이 당사 시스템에 의해 자동으로 프로비저닝되면 이 값은 **시스템** (으)로 설정됩니다. 또한 다음 프로비저닝 상태가 표시됩니다. **프로비저닝됨** .
* **작업:** PR을 승인해야 하는 경우 다음 버튼이 표시됩니다. **승인** 및 **거부** 버튼입니다. 수행할 수 있는 추가 작업이 있으면 다음 버튼이 표시됩니다. **... 작업 더보기** 버튼입니다.

## 문제 해결

프로비저닝 과정에서 PR에 오류가 발생하면 **프로비저닝 상태** 에 문제가 표시됩니다.

* **사용자에 의해 거부됨:** 사용자가 PR을 수동으로 거부했습니다. 이 항목은 다음 경우에만 표시됩니다. **수동** 승인 유형입니다.
* **시스템에서 거부됨:** PR이 시스템에 의해 자동으로 거부되었습니다. 이는 매우 드물게 발생해야 합니다.
* **어플라이언스를 통해 프로비저닝해야 함:** 이 장치는 어플라이언스에 대해서만 최초 프로비저닝할 수 있습니다. 오류 코드: `APPLIANCE_ONLY`
* **중복 HW ID:** PR에 제공된 하드웨어 ID가 기존 장치의 하드웨어 ID와 일치하며, 조직의 PR 승인 정책을 충족하지 않습니다. 오류 코드: `DUPLICATE_HW_ID_FAILURE`
* **PR 서명자 키 누락:** PR 서명에 사용된 키가 존재하지 않거나 아직 PR을 확인하는 데 사용할 수 없습니다. 오류 코드: `MISSING_PR_SIGNER_KEY`
* **잘못된 PR 서명**: PR의 서명이 예상된 요건을 충족하지 않아 확인할 수 없습니다. 오류 코드: `PR_SIGNATURE_MALFORMED`
* **최대 인스턴스 수 초과:** 시스템 정의에 명시된 이 장치(구성 요소)의 최대 수에 이미 도달했습니다. 오류 코드: `MAX_INSTANCE_FAILURE`

### Vault 오류

* **Vault에서 인증서에 서명할 수 없음:** Vault에서 장치 인증서에 서명할 수 없습니다. 오류 코드: `FAIL_SIGN_DEVICE_CERTIFICATES`
* **Vault에서 프로필에 서명할 수 없음:** Vault에서 장치 인증 프로필에 서명할 수 없습니다. 오류 코드: `FAIL_SIGN_DEVICE_CERTIFIED_PROFILE`
* **Vault 요청 시간 초과:** 프로비저닝을 처리하는 서비스에서 Vault에 요청을 보내는 중 시간이 초과되었습니다. 오류 코드: `VAULT_REQUEST_TIMEOUT`
* **Vault에서 PR 서명자를 찾을 수 없음:** Vault에서 PR에 서명한 장치의 장치 ID를 찾을 수 없습니다. 오류 코드: `UNABLE_LOOKUP_PROVISION_REQUEST_SIGNER`
* **Vault에서 장치 리프 인증서를 찾을 수 없음:** Vault에서 장치의 리프 인증서를 찾을 수 없습니다. 오류 코드: `UNABLE_LOOKUP_DEVICE_CERTIFICATES`
* **Vault에서 Vault 서명자 인증서를 찾을 수 없음:** Vault에서 Vault 서명자의 인증서를 찾을 수 없습니다. 오류 코드: `FAIL_SIGN_MISSING_SIGNER_CERTIFICATE`

### 재프로비저닝 오류

일부 오류는 장치를 재프로비저닝할 때만 발생할 수 있습니다.

* **구성 요소 불일치:** PR에 포함된 구성 요소 이름이 PR에 서명한 구성 요소의 이름과 다릅니다. 오류 코드: `REPROVISIONING_MISMATCH_COMPONENT`
* **HW ID 불일치:** PR의 하드웨어 ID가 PR에 서명한 장치의 하드웨어 ID와 다릅니다. 오류 코드: `REPROVISIONING_MISMATCH_HARDWARE_IDENTIFIER`
* **인스턴스 불일치:** PR의 대상 장치는 PR에 서명한 장치와 다른 시스템 인스턴스에 속합니다. 오류 코드: `REPROVISIONING_MISMATCH_INSTANCE`
* **장치가 이미 프로비저닝 중임:** PR은 현재 프로비저닝 중인 장치에 대한 재프로비저닝 요청입니다. 오류 코드: 오류 코드: `REPROVISIONING_PROVISIONING_COMPONENT`

## 디바이스 필터링

시스템, 디바이스 및 프로비저닝 정보를 기준으로 필터링할 수 있습니다.

**일반 섹션**

* **시스템 이름:** 조회할 기본 시스템을 선택합니다. 시스템 정의라고도 합니다.
* **시스템 인스턴스:** 조회할 시스템 인스턴스를 하나 이상 선택합니다.
* **구성 요소 이름:** 조회할 구성 요소를 하나 이상 선택합니다.
* **디바이스 하드웨어 ID:** 필터링할 특정 디바이스 하드웨어 ID를 지정합니다.

**프로비저닝 세부 정보 섹션**

* 전환하여 모든 디바이스의 현재 프로비저닝 상태 또는 디바이스가 거쳐 온 모든 상태를 조회합니다.
* **프로비저닝 상태:** 프로비저닝 상태를 하나 이상 선택합니다. 선택할 수 있는 상태는 현재 조회 중인 시스템의 승인 유형에 따라 달라집니다.
* **프로비저닝 날짜:** 해당 기간에 **프로비저닝됨** 상태로 변경된 디바이스를 확인하려면 날짜 범위를 선택하세요.

## 프로비저닝 보고서 내보내기

모든 디바이스의 현재 프로비저닝 상태를 내보내거나, 최신 프로비저닝 상태를 내보낼 디바이스를 선택할 수 있습니다.

1. 모든 디바이스를 내보내려면 도구 모음에서 **내보내기** 드롭다운을 선택합니다.  **모든 디바이스** 그룹에서 **디바이스 프로비저닝 보고서**.
2. 선택한 디바이스를 내보내려면 상태를 내보낼 디바이스를 선택한 다음 도구 모음에서 **내보내기** 드롭다운을 선택합니다.  **선택한 디바이스** 그룹에서 **디바이스 프로비저닝 보고서**를 선택합니다. 그러면 디바이스 프로비저닝 보고서가 CSV 형식으로 내보내집니다.


---

# 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/guardian/understand-device-provisioning/manage-device-provisioning.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.