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

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

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

***

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

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

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

### .csv 파일 형식 지정

가져오기를 성공적으로 수행하려면 .csv 파일이 다음을 **필수 형식과 일치하도록** 하는 것을 강력히 권장합니다:

* 파일은 UTF-8 인코딩의 .csv 파일이어야 합니다.
* 파일 크기는 250,000행을 초과해서는 안 됩니다.
* 자격 증명은 Command의 기존 사용자와 매칭되므로, *할 수 없습니다* 자격 증명 가져오기 과정 중에 사용자를 생성할 수 없습니다.
* 가져오기에는 사용자를 Command에 이미 존재하는 사용자와 매핑하기 위한 하나의 "키" 열이 포함되어야 합니다. 계층적 순서의 "키" 열은 3개가 있습니다:
  * 사용자 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).                                                                                                 |
| **시설 코드**     | 자격 증명과 연결된 시설 코드(해당하는 경우).                                                                                                                                                                                             |
| **카드 번호**     | 자격 증명과 연결된 숫자 카드 번호(해당하는 경우).                                                                                                                                                                                          |
| **카드 번호 Hex** | 자격 증명과 연결된 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 %}