# 출입 사용자 가져오기 - CSV

{% hint style="info" %}
조직에서 액세스 제어를 위해 디렉터리를 사용하는 경우, 다음을 참조하세요. [디렉터리로 사용자 관리](/command/ko/users-and-permissions/manage-users-in-your-organization/directories-for-user-group-management.md) 변경하기 전에 확인하세요. 이 문서에서는 디렉터리가 사용자 관리 위치와 적용되는 권한에 어떤 영향을 미치는지 설명합니다.
{% endhint %}

여러 Verkada 출입 통제 사용자를 동시에 관리할 수 있도록, 액세스 관리자는 쉼표로 구분된 값(CSV) 파일을 통해 조직의 사용자들을 내보내기, 가져오기 및 변경할 수 있습니다.

{% hint style="warning" %}
이메일 주소가 없는 동일한 이름의 사용자가 여러 명(Command 또는 CSV에 이미 존재) 있는 경우, 가져오기를 수행하면 동일한 이름의 중복 사용자가 생성됩니다.
{% endhint %}

***

## 기존 사용자 내보내기

사용자를 업데이트해야 할 때마다 사용자 목록을 수동으로 생성하지 않으려면, 가져오기 파일의 템플릿으로 사용할 현재 사용자 목록을 Command에서 내보낼 수 있습니다.

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

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

{% step %}
**CSV를 다운로드하려면 Export > Export Users를 클릭합니다.**
{% endstep %}
{% endstepper %}

***

## 필수 필드

액세스 사용자를 가져오는 경우, 다음 필드는 필수입니다:

* **이름**
* **성**

액세스 사용자를 덮어쓰는 경우, *최소 하나* 의 이러한 필드가 필요합니다:

* **userId**
* **externalId**
* **이메일**

{% hint style="danger" %}

* The **이메일** 필드는 사용자가 다음에 액세스하는 데 필요합니다. **Verkada Pass** 앱, 그리고 사용자에게 [출입 통제 역할](/access-control/ko/getting-started/roles-and-permissions-for-access-control.md) 이 Command에서 할당되었습니다.
* The **userId** 필드는 Verkada에서 생성되며 사용자를 식별하는 데 사용할 수 있습니다.
  {% endhint %}

사용자에게 카드 번호를 할당할 때는 다음 필드가 필요합니다:

* **cardFormat**
* **facilityCode** (카드 형식에 필요한 경우)
* **cardNumber** (카드 형식에 필요한 경우)
* **cardNumberHex** (카드 형식에 필요한 경우)

{% hint style="warning" %}
사용자 CSV 업로드로는 자격 증명을 삭제할 수 없습니다. 또한 기존 사용자에게 속한 자격 증명은 새 사용자에게 재할당되지 않습니다. 다음을 사용하여 자격 증명을 재할당할 수 있습니다. [자격 증명 가져오기](/access-control/ko/users-and-credentials/commission-access-control-cards/import-and-export-credentials-with-csv-files.md) 기능.
{% endhint %}

***

## CSV 업로드용 열 헤더

에서 [**업로드**](#h_763fa8346a) 사용자 가져오기의 페이지에서, 유의해야 할 몇 가지 사항은 다음과 같습니다:

* **필수 열:** 필수 열은 별표로 표시됩니다. 별표가 있는 필드 중 최소 하나가 각 행마다 필요합니다. 행에 필수 열이 하나도 없으면 해당 사용자는 업로드에 실패합니다.
* **키 열:** 키 열은 .으로 표시됩니다. *최소 하나* 의 키 열은 사용자 데이터를 덮어써야 하는 경우 기존 사용자와 일치시키기 위해 필요합니다.
* **추가형:** 열에 가 표시되어 있으면, 기존 사용자를 덮어쓸 때 새 값이 사용자 프로필에 추가됩니다. 기존 값은 제거되지 않습니다.
* **시작일 및 종료일 형식:** MM/DD/YYYY hh:mm:ss AM/PM

{% hint style="warning" %}
두 개 이상의 **차량 번호판**와 **그룹** 을(를) 사용자에게 추가할 수 있습니다. 각 항목은 세미콜론으로 구분해야 합니다.
{% endhint %}

***

## 사용자 일괄 가져오기

{% hint style="warning" %}
CSV 업로드는 최대 20,000명의 사용자를 지원합니다.
{% endhint %}

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

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

{% step %}
**Import > Import Users를 클릭합니다.**
{% endstep %}

{% step %}
**업로드에서:**

a. (선택 사항) 클릭 [**템플릿 다운로드**](https://verkada.intercom-attachments-2.com/i/o/q5re5q6g/1338754475/5ed2df67ad764a6d5fd2e74fb5fb/UsersTemplate.csv?expires=1760022000\&signature=6b78b69cd9394d3b54e948fc31230545c419470b330cbdd04652f5246c4531f6\&req=dSMkHs57mYVYXPMW3Hu4gVzXus8N8mMmr%2FjcW1UHpNu28VPJSWD4Lb%2FLHNkv%0Afw%3D%3D%0A) 하여 Verkada 권장 템플릿을 업로드의 기본 템플릿으로 사용합니다.\
b. 아래의 **CSV 업로드에서,** 사용자 정보가 포함된 CSV를 끌어다 놓거나 **컴퓨터에서 선택**\
을 선택합니다.\
c. 클릭 **계속** 하여 다음으로 진행합니다. **구성**.

**참고:** CSV 파일에 특수 문자가 포함되어 있는 경우 CSV UTF-8 인코딩으로 인코딩되어 있는지 확인하세요.
{% endstep %}

{% step %}
**구성에서:**

a. **기존 사용자 덮어쓰기:** 만약 *예* 가 선택되면, **userId, externalId,** 또는 **이메일** (해당 계층적 순서로)와 일치하는 모든 사용자가 CSV의 정보로 업데이트됩니다.\
b. **누락된 그룹에서 사용자 제거:** 선택 *예* 하여 CSV에 지정되지 않은 모든 그룹에서 사용자를 제거합니다. 지정된 그룹이 없는 사용자(빈 셀)는 그룹 멤버십이 수정되지 않습니다.\
c. **Pass 앱 초대 보내기:** 모든 사용자, 신규 사용자 또는 아무 사용자에게도 Verkada Pass 앱용 다운로드 링크를 보내지 않습니다. 이 링크는 신규 사용자에게 보내는 것을 권장합니다.\
d. 클릭 **다음, 열 검토.**
{% endstep %}

{% step %}
**열 검토에서:**

a. 가져오는 열의 정보를 검토합니다.\
b. 가져올 수 없는 열이 있는 경우, 이 화면에 어떤 열이 가져오기로 인식되지 않았는지 자세히 설명하는 메시지가 표시됩니다.\
c. 클릭 **다음, 행 검토.**
{% endstep %}

{% step %}
**행 검토에서:**

a. 행에서 문제가 감지되면, 문제를 설명하는 메시지가 표시됩니다.\
b. 클릭 **행 보기** 를 문제 옆에서 클릭하여 어떤 행이 영향을 받는지 확인합니다.\
c. CSV에서 문제를 수정하고 업로드를 다시 시작합니다. 이러한 오류가 표시된 행은 업로드될 수는 있지만, 성공할 가능성은 매우 낮습니다.

**참고**: 이 초기 검토는 기존 사용자 데이터와의 충돌과 같은 모든 가능한 오류를 설명하지는 않습니다.
{% endstep %}

{% step %}
**가져오기를 진행하려면 Proceed with Import를 클릭합니다.**

a. 가져오기가 완료되면, 가져오기 성공 여부를 자세히 설명하는 이메일을 받게 됩니다.\
b. 실패한 가져오기가 있는 경우, 클릭 **오류가 포함된 CSV 다운로드** 하여 가져오기가 실패한 원인이 된 오류를 확인합니다. [UsersTemplate.csv](https://verkada.intercom-attachments-2.com/i/o/q5re5q6g/1338754475/5ed2df67ad764a6d5fd2e74fb5fb/UsersTemplate.csv?expires=1760022000\&signature=6b78b69cd9394d3b54e948fc31230545c419470b330cbdd04652f5246c4531f6\&req=dSMkHs57mYVYXPMW3Hu4gVzXus8N8mMmr%2FjcW1UHpNu28VPJSWD4Lb%2FLHNkv%0Afw%3D%3D%0A)
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
자격 증명 재할당 또는 유효하지 않은 차량 번호판 번호와 같은 경미한 오류는 사용자 업로드를 차단하지 않습니다. 이러한 오류가 있는 상태로 생성된 사용자는 가져오기가 완료되면 발송되는 이메일에서 다운로드할 수 있습니다. 오류를 수정할 때 사용자의 이메일이 없는 경우, 해당 사용자의 **userId** 을(를) 지정하여 중복 사용자가 생성되는 것을 방지할 수 있습니다.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://help.verkada.com/access-control/ko/users-and-credentials/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.