# Import Access Users - CSV

{% hint style="info" %}
조직에서 액세스 제어를 위해 디렉터리를 사용하는 경우, 다음을 참조하세요. [디렉터리로 사용자 관리](https://app.gitbook.com/s/NRq5qDDjsYNxwNzF1bcB/users-and-permissions/manage-users-in-your-organization/directories-for-user-group-management) 변경하기 전에 확인하세요. 이 문서에서는 디렉터리가 사용자 관리 위치와 적용되는 권한에 어떤 영향을 미치는지 설명합니다.
{% 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** 앱, 그리고 사용자에게 [출입 통제 역할](https://help.verkada.com/access-control/ko/getting-started/roles-and-permissions-for-access-control) 이 Command에서 할당되었습니다.
* The **userId** 필드는 Verkada에서 생성되며 사용자를 식별하는 데 사용할 수 있습니다.
  {% endhint %}

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

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

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