> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/access-control/ko/users-and-credentials/commission-access-control-cards/import-and-export-credentials-with-csv-files.md).

# CSV로 자격 증명 가져오기 및 내보내기

사용자와 해당 액세스 자격 증명은 [Verkada Command](/command/ko/getting-started/get-started-with-verkada-command.md). [액세스 제어 관리자](/access-control/ko/getting-started/roles-and-permissions-for-access-control.md) 및 관리자는 업로드한 .csv \[또는 쉼표로 구분된 값(CSV)] 파일로 Command에 자격 증명을 대량으로 가져오거나, Command에서 다운로드한 .csv 파일로 자격 증명을 내보낼 수 있습니다. 다음에 대해 자세히 알아보세요. [액세스 제어의 역할 및 권한](/access-control/ko/getting-started/roles-and-permissions-for-access-control.md).

{% hint style="warning" %}
다음을 통해 [사용자 가져오기 흐름](/access-control/ko/users-and-credentials/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md), 사용자당 단일 카드 자격 증명은 물론 차량 번호판과 출입 코드도 계속 가져올 수 있습니다. 더 많은 자격 증명을 가져오려면 아래에 설명된 자격 증명 가져오기 흐름을 사용하세요.
{% endhint %}

***

## 자격 증명 세부 정보 및 연결된 액세스 사용자 가져오기

...할 때 [액세스 제어 관리자](/access-control/ko/getting-started/roles-and-permissions-for-access-control.md) 및 관리자가 업로드한 .csv 파일로 Command에 자격 증명을 대량으로 가져오면, 파일에는 가져올 각 자격 증명마다 한 행이 포함되어야 하며, 여기에는 자격 증명 세부 정보와 해당 자격 증명이 연결될 액세스 사용자가 포함되어야 합니다.

{% hint style="warning" %}
Command에 이미 존재하는 사용자에 대해 새 자격 증명을 만들거나 기존 자격 증명을 수정할 수 있습니다. Command에서 새 액세스 사용자를 만들려면 [대량 액세스 사용자 가져오기](/access-control/ko/users-and-credentials/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md).
{% endhint %}

### .csv 파일 형식 지정

가져오기를 성공적으로 수행하려면, .csv 파일이 **필수 형식과 일치하도록** 아래와 일치해야 합니다:

* 파일은 UTF-8 인코딩의 .csv 파일이어야 합니다.
* 파일 크기는 250,000행을 초과하면 안 됩니다.
* 자격 증명은 Command의 기존 사용자와 일치되므로, *할 수 없습니다* 자격 증명 가져오기 과정에서 사용자를 생성할 수 없습니다.
* 가져오기에는 사용자를 Command에 이미 존재하는 사용자에 매핑하기 위한 "key" 열이 하나 포함되어야 합니다. 계층 순서로 3개의 "key" 열이 있습니다:
  * 사용자 ID
  * 외부 ID
  * 이메일 주소
* 가져오기 파일의 CSV 열 헤더는 다음에서 정의된 예상 열 헤더와 일치해야 합니다: [열 헤더](#h_f385fad83f) 아래.
* 각 행에는 고유한 단일 자격 증명 하나만 포함되어야 합니다. 한 행에 여러 자격 증명을 가져오지 마세요.

### 자격 증명 가져오기

파일 형식을 지정한 후 자격 증명을 가져올 수 있습니다:

{% stepper %}
{% step %}
**Verkada Command에서 All Products > Access로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색에서 Access Users and Groups 를 클릭합니다.**
{% endstep %}

{% step %}
**오른쪽 상단에서 Import 드롭다운을 클릭하고 Import Credentials를 선택합니다.**
{% endstep %}

{% step %}
**자격 증명 정보를 입력할 때 Card Type은 다음 목록과 일치해야 합니다** [**지원되는 카드 유형**](https://docs.verkada.com/docs/access-control-supported-card-formats-datasheet.pdf)**, Accepted Formats 아래에 나열된 대로.**
{% endstep %}

{% step %}
**Import Credentials에서 형식이 지정된** [**열 헤더**](#h_f385fad83f) **및 샘플 자격 증명 행이 포함된 템플릿을 다운로드할 수 있습니다.**
{% endstep %}

{% step %}
**가져오기를 위해 형식이 지정된 .csv 파일을 끌어다 놓거나 업로드합니다.**
{% endstep %}

{% step %}
**(선택 사항) 자격 증명 재할당을 선택합니다. 그러면 Command의 기존 자격 증명이 CSV 파일 입력에 맞게 재할당됩니다.**

a. 자격 증명을 재할당하지 않기로 선택하면 중복 자격 증명(이미 기존 사용자에게 할당됨)이 발견될 경우 해당 행에 오류가 표시됩니다.\
b. CSV 파일을 단일 기준 원본으로 사용하려는 경우에만 자격 증명을 재할당하세요.\
c. 클릭 **자격 증명 가져오기.**
{% endstep %}

{% step %}
**검토 중인 열:**

a. 열에서 오류가 감지되면 이 페이지에서 파일을 검토하고 오류를 수정하라는 메시지가 표시됩니다.\
b. 오류를 수정한 후 .csv 파일을 다시 업로드합니다.\
c. 클릭 **다음**.
{% endstep %}

{% step %}
**검토 중인 행:**

a. 행에서 오류가 감지되면 이 페이지에서 파일을 검토하고 오류를 수정하라는 메시지가 표시됩니다.\
b. 오류를 수정한 후 .csv 파일을 다시 업로드합니다.\
c. 클릭 **다음**.
{% endstep %}

{% step %}
**행이나 열에 오류가 없으면 Proceed with Import를 클릭합니다. 검토 제안을 무시하기로 선택하면 가져오기에서 해당 행이 실패합니다.**
{% endstep %}

{% step %}
**가져오기가 완료된 후:**

a. 다음을 수신해야 합니다 **이메일** 성공한 행 수와 실패한 행 수에 대한 확인.\
b. 실패한 행과 실패 사유가 포함된 .csv 파일을 받아야 합니다.\
c. 실패한 행을 수정한 후 이러한 자격 증명을 다시 가져와 원하는 모든 자격 증명을 성공적으로 가져옵니다.
{% endstep %}
{% endstepper %}

***

## 사용자 및 해당 자격 증명 내보내기

{% stepper %}
{% step %}
**Verkada Command에서 All Products > Access로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색에서 Access Users and Groups 를 클릭합니다.**
{% endstep %}

{% step %}
**오른쪽 상단에서 Export를 클릭하고 Export Credentials를 선택합니다.**
{% endstep %}
{% endstepper %}

.csv 파일이 즉시 내보내지며, 지정한 **다운로드** 폴더에서 찾을 수 있습니다.

### 파일의 열 헤더

귀하의 .csv 파일에는 다음 자격 증명이 포함되어 있습니다:

|                |                                                                                                                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **사용자 자격 증명**  | **설명**                                                                                                                                                                                                         |
| **이름**         | Command의 이름.                                                                                                                                                                                                   |
| **성**          | Command의 성.                                                                                                                                                                                                    |
| **사용자 ID**     | 사용자와 연결된 Verkada 관리 고유 ID.                                                                                                                                                                                     |
| **외부 ID**      | 사용자와 연결된 고객 관리 고유 ID.                                                                                                                                                                                          |
| **직원 ID**      | <p>사용자와 연결된 고객 관리 ID.</p><p><strong>참고</strong>: 직원 ID의 고유성은 강제되지 않습니다.</p>                                                                                                                                    |
| **이메일**        | 사용자와 연결된 이메일 주소.                                                                                                                                                                                               |
| **카드 유형**      | 사용자와 연결된 카드 유형입니다. 다음을 참조하세요: [지원되는 카드 형식](https://docs.verkada.com/docs/access-control-supported-card-formats-datasheet.pdf).                                                                                 |
| **시설 코드**      | 자격 증명과 연결된 시설 코드(해당하는 경우).                                                                                                                                                                                     |
| **카드 번호**      | 자격 증명과 연결된 숫자 카드 번호(해당하는 경우).                                                                                                                                                                                  |
| **카드 번호 16진수** | 자격 증명과 연결된 16진수 카드 번호(해당하는 경우).                                                                                                                                                                                |
| **차량 번호판**     | 사용자 차량 번호판 번호(해당하는 경우)도 사용자의 자격 증명으로 표시됩니다.                                                                                                                                                                    |
| **출입 코드**      | 고유한 출입 코드(해당하는 경우)도 사용자의 자격 증명으로 표시됩니다.                                                                                                                                                                        |
| **자격 증명 상태**   | <p>Verkada가 새로 도입한 <strong>자격 증명 상태</strong> 열입니다.</p><p>자격 증명이 현재 사용자와 연결되어 있으면 <strong>활성</strong> 자격 증명으로 표시됩니다.</p><p>자격 증명이 일시 중지되어 있으면 <strong>비활성</strong>.</p><p>사용자가 일시 중지되어도 자격 증명은 계속 활성 상태입니다.</p> |
| **수정됨**        | 자격 증명이 마지막으로 업데이트된 날짜와 시간을 표시합니다.                                                                                                                                                                              |

***

{% hint style="info" %}
**직접 보고 싶으신가요?** 다음을 확인해 보세요 [동영상 튜토리얼](https://www.youtube.com/watch?v=8r7YcbrnGZY).
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.verkada.com/access-control/ko/users-and-credentials/commission-access-control-cards/import-and-export-credentials-with-csv-files.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.