> 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/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md).
# 출입 사용자 가져오기 - CSV
{% hint style="info" %}
귀하의 조직이 출입 통제에 디렉터리를 사용하는 경우, 다음을 참조하세요. [디렉터리로 사용자 관리](/command/ko/users-and-permissions/manage-users-in-your-organization/directories-for-user-group-management.md) 변경하기 전에 확인하세요. 디렉터리가 사용자가 관리되는 위치와 적용되는 권한에 어떤 영향을 미치는지 설명합니다.
{% endhint %}
여러 Verkada 출입 통제 사용자를 동시에 관리하는 데 도움을 주기 위해, Access 관리자들은 쉼표로 구분된 값(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" %}
* 해당 **이메일** 필드는 사용자가 다음에 액세스하려면 필요합니다: **Verkada Pass** 앱이며, 다음이 할당된 사용자들은 [출입 통제 역할](/access-control/ko/getting-started/roles-and-permissions-for-access-control.md) Command에서.
* 해당 **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) 사용자 가져오기 페이지에서 기억해야 할 몇 가지 사항은 다음과 같습니다:
* **필수 열:** 필수 열은 별표로 표시됩니다 :asterisk:. 각 행에는 별표가 표시된 필드 중 적어도 하나가 필요합니다. 행에 필수 열이 하나도 없으면 해당 사용자의 업로드가 실패합니다.
* **키 열:** 키 열은 다음 표시로 표시됩니다: :key:. *적어도 하나* 사용자 데이터를 덮어써야 하는 경우 기존 사용자와 일치시키려면 키 열이 하나 이상 필요합니다.
* **추가 방식:** 열에 다음 표시가 있으면 :plus:, 기존 사용자를 덮어쓸 때 새 값이 사용자 프로필에 추가됩니다. 기존 값은 제거되지 않습니다.
* **시작일 및 종료일 형식:** MM/DD/YYYY hh:mm:ss AM/PM.
{% hint style="warning" %}
사용자의 전화번호를 자동으로 확인하려면, 다음 형식 중 하나로 번호를 CSV에 추가하세요:
* +1 XXX XXX XXXX
* +1 XXX-XXX-XXXX
{% endhint %}
{% hint style="info" %}
하나 이상 추가할 수 있습니다 **번호판** 또는 **그룹** 을 사용자에게 추가할 수 있습니다. 각 항목은 세미콜론으로 구분해야 합니다.
{% 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 %}
**업로드에서:**
1. (선택 사항) 다음을 클릭합니다 [**템플릿 다운로드**](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 권장 템플릿을 업로드의 기반으로 사용합니다.
2. 다음 항목에서 **CSV 업로드,** 사용자 정보가 포함된 CSV를 끌어놓거나 **컴퓨터에서 선택합니다.**
3. 클릭합니다 **계속** 을 눌러 다음 단계로 진행합니다 **구성**.
{% hint style="warning" %}
CSV 파일에 특수 문자가 포함되어 있으면 UTF-8로 인코딩되어 있는지 확인하세요.
{% endhint %}
{% endstep %}
{% step %}
**구성에서:**
1. **기존 사용자 덮어쓰기:** 만약 *예* 가 선택되면, 다음과 일치하는 모든 사용자는 **userId, externalId,** 또는 **이메일** (해당 우선 순서대로) CSV의 정보로 업데이트됩니다.
2. **생략된 그룹에서 사용자 제거:** 다음을 선택하여 *예* CSV에 지정되지 않은 모든 그룹에서 사용자를 제거합니다. 지정된 그룹이 없는 사용자(빈 셀)는 그룹 멤버십이 변경되지 않습니다.
3. **Pass 앱 초대 보내기:** Verkada Pass 앱 다운로드 링크를 모든 사용자, 새 사용자 또는 아무 사용자에게도 보내세요. 이 링크는 새 사용자에게 보내는 것을 권장합니다.
4. 클릭합니다 **다음으로, 열 검토.**
{% endstep %}
{% step %}
**열 검토에서:**
1. 가져오는 열의 정보를 검토하세요.
2. 가져올 수 없는 열이 있으면, 어떤 열이 가져오기용으로 인식되지 않았는지 자세히 설명하는 메시지가 이 화면에 표시됩니다.
3. 클릭합니다 **다음으로, 행 검토.**
{% endstep %}
{% step %}
**행 검토에서:**
1. 행에서 문제가 감지되면, 문제를 설명하는 메시지가 표시됩니다.
2. 클릭합니다 **행 보기** 을 눌러 영향을 받는 행을 확인하세요.
3. CSV에서 문제를 수정한 다음 업로드를 다시 시작하세요. 이러한 오류가 표시된 행도 업로드될 수 있지만, 성공할 가능성은 매우 낮습니다.
{% hint style="warning" %}
이 초기 검토는 기존 사용자 데이터와의 충돌과 같은 모든 가능한 오류를 설명하지는 않습니다.
{% endhint %}
{% endstep %}
{% step %}
**Proceed with Import를 클릭합니다.**
1. 가져오기가 완료되면 가져오기 성공 여부를 자세히 설명하는 이메일을 받게 됩니다.
2. 실패한 가져오기가 있으면 다음을 클릭하세요 **오류가 포함된 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
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/add-a-user-to-the-verkada-access-system/import-access-control-users-csv.md?ask=&goal=
```
`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.