> 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/new-alarms/ko/configuration/keycode-management.md).

# 키코드 관리

Verkada 알람의 키코드 관리에 대해 알아보세요

{% hint style="success" %}
이 문서는 New Alarms용 가이드입니다. 이 문서를 참조하세요 [문서](/classic-alarms/ko/configuration/configure-classic-alarms-site-settings/classic-alarms-sites.md) 기존 Alarms를 사용하는 경우. 다음을 참조하세요 [New Alarms와 기존 Alarms 비교](/new-alarms/ko/getting-started/new-alarms-vs-classic-alarms.md) 어떤 버전의 Alarms를 사용 중인지 확실하지 않은 경우.
{% endhint %}

***

키코드 관리를 사용하면 각 사용자에게 Command 프로필과 연결된 키코드가 하나씩 있습니다. 사용자는 무장/해제 권한이 있는 모든 알람 사이트에서 자신의 키코드를 사용할 수 있습니다. 이를 통해 세 가지 주요 이점이 있습니다:

* **사이트 전반에서 하나의 키코드:** 사용자는 무장/해제 권한이 있는 모든 알람 사이트에서 동일한 키코드를 사용할 수 있습니다. 사이트마다 별도의 키코드를 설정할 필요가 없습니다.
* **사용자와 그룹을 통해 액세스 관리:** Command 사용자 또는 그룹에 무장/해제 권한을 직접 부여하세요. 권한은 특정 파티션, 전체 사이트 또는 여러 사이트에 적용될 수 있습니다.
* **Alarm User 역할로 명확한 가시성 확보:** 이 **Alarm User** 역할을 사용하면 각 사이트 또는 파티션에 무장/해제 권한이 있는 사용자를 쉽게 확인할 수 있습니다.

### 권한

조직 관리자와 사이트 관리자는 자동으로 Alarm User(사이트) 역할 권한을 상속합니다:

* 조직 관리자는 Command와 키패드를 통해 조직 내 모든 사이트의 모든 파티션을 무장/해제할 수 있습니다.
* 사이트 관리자는 Command와 키패드를 통해 사이트 전체의 모든 파티션을 무장/해제할 수 있지만, 자신이 사이트 관리자 권한을 가진 사이트에만 적용됩니다.

{% hint style="danger" %}
이는 임시 조직 관리자 또는 사이트 관리자에게는 적용되지 않습니다.
{% endhint %}

***

## 통합 키코드 관리로 마이그레이션

다음을 선택하세요: **새 키코드 환경으로 마이그레이션** Command의 배너에서 조직의 마이그레이션 상태를 확인하세요. 아무 조치도 하지 않으면 Verkada가 2026년 11월 9일 이후 조직을 자동으로 마이그레이션합니다.&#x20;

<div align="left" data-with-frame="true"><figure><img src="https://2064114606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNU1He6Uj2tgInV2VdCLQ%2Fuploads%2FHpMETykcQweCS200H1wF%2FMigrate%20to%20a%20new%20keycode%20experience.png?alt=media&amp;token=3f5c781c-81f9-4ecf-b676-2cd12e1ec2b3" alt="" width="375"><figcaption></figcaption></figure></div>

조직이 통합 키코드 관리로 마이그레이션되기 전에 Command는 기존 키코드 충돌을 확인합니다:

#### 충돌이 없습니다

조직을 즉시 마이그레이션할 수 있습니다. 다음을 선택하세요: **마이그레이션** 통합 키코드 관리를 시작합니다.&#x20;

<div align="left" data-with-frame="true"><figure><img src="https://2064114606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNU1He6Uj2tgInV2VdCLQ%2Fuploads%2FpIyfo62pWYWMGMvbSnIo%2Fimage.png?alt=media&amp;token=4b4c1e87-205c-4cbc-a3df-a1e46ab70e36" alt="" width="375"><figcaption></figcaption></figure></div>

#### 충돌이 발견됨&#x20;

Command는 해결해야 할 충돌을 표시합니다. 조직 관리자만 충돌 보고서를 다운로드하고 이러한 충돌을 해결할 수 있습니다. 아무 조치도 하지 않으면 Verkada가 2026년 12월 7일에 조직을 강제 마이그레이션합니다.

<div align="left" data-with-frame="true"><figure><img src="https://2064114606-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNU1He6Uj2tgInV2VdCLQ%2Fuploads%2FDVnK5b3KwaGqoDz3Hs0P%2FScreenshot%202026-09-03%20at%202.03.49%E2%80%AFPM.png?alt=media&amp;token=b1cd466e-f2bc-47b7-b912-e089451f4f74" alt="" width="375"><figcaption></figcaption></figure></div>

다음이 있습니다: **세 가지** 유형의 충돌:

{% hint style="warning" %}
조직을 마이그레이션하기 전에 모든 충돌을 해결해야 합니다.&#x20;
{% endhint %}

1. **같은 사용자가 서로 다른 사이트에서 다른 키코드를 가지고 있음**&#x20;

   사용자에게 하나의 키코드를 선택하고 각 알람 사이트에서 해당 키코드를 업데이트하여 모든 사이트에서 동일하게 만드세요.
2. **둘 이상의 사용자가 같은 키코드를 가지고 있음**

   각 사용자에게 고유한 키코드를 할당하여 두 사용자가 같은 키코드를 공유하지 않도록 하세요.
3. **사용자의 키코드가 일반 키코드와 일치함**

   해당 사이트에서 사용자의 키코드 또는 일반 키코드 중 하나를 업데이트하여 더 이상 일치하지 않게 하세요.

문의 [Verkada 지원](/command/ko/need-help/contact-verkada-support.md) 충돌 해결에 도움이 필요하면.

***

## Alarm User 역할 권한 부여

사용자에게 사이트의 무장/해제 권한을 부여하는 방법은 세 가지입니다. 다음을 참조하세요: [역할 및 권한](https://help.verkada.com/command/users-and-permissions/roles-and-permissions-for-command#set-permissions) 자세한 내용은.

{% hint style="danger" %}
사용자에게 Alarm User 역할을 부여해도 해당 사용자의 키코드가 자동으로 생성되지는 않습니다. 다음에서 해당 키코드를 별도로 생성해야 합니다: **키코드** 탭.
{% endhint %}

{% tabs %}
{% tab title="Alarms 사이트 사용자 키코드 페이지" %}
{% stepper %}
{% step %}
**Verkada Command에서 All Products > New Alarms로 이동합니다.**
{% endstep %}

{% step %}
**알람 사이트를 선택합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색 메뉴에서 Keycodes를 선택합니다.**
{% endstep %}

{% step %}
**오른쪽 상단에서 다음을 클릭합니다:** <i class="fa-plus">:plus:</i> **추가.**

1. 사용자를 검색하여 선택한 다음 다음을 클릭합니다: **추가.**
2. 사용자가 추가되면 사이트 전체 권한을 부여할지, 아니면 일부 파티션에만 권한을 부여할지 선택합니다.&#x20;
3. 다음을 선택합니다: **저장.**
   {% endstep %}
   {% endstepper %}
   {% endtab %}

{% tab title="사용자 페이지" %}
{% stepper %}
{% step %}
**Verkada Command에서 All Products > Admin으로 이동합니다.**
{% endstep %}

{% step %}
**Users & Permissions > Users를 선택합니다.**
{% endstep %}

{% step %}
**권한을 부여할 사용자를 선택합니다.**
{% endstep %}

{% step %}
**Site Roles 오른쪽의 Manage를 클릭합니다.**&#x20;

1. 다음을 선택합니다: **알람.**
2. 다음을 선택하세요: **Alarm User(사이트)** 사이트 전체 액세스를 위한 역할 또는 **Alarm User(파티션)** 사이트 내 특정 파티션에 액세스하기 위한 역할입니다.
3. 다음을 클릭합니다: **저장.**
   {% endstep %}
   {% endstepper %}
   {% endtab %}

{% tab title="그룹 페이지" %}
{% stepper %}
{% step %}
**Verkada Command에서 All Products > Admin으로 이동합니다.**
{% endstep %}

{% step %}
**Users & Permissions > Groups를 선택합니다.**
{% endstep %}

{% step %}
**Alarm User 역할 권한이 부여된 Command 그룹을 선택합니다. 그룹에 권한을 부여해야 하는 경우:**

1. 상단에서 다음을 클릭합니다: **역할.**
2. 다음을 클릭합니다: **관리** 오른쪽의 **Site Roles.**
   1. 다음을 선택합니다: **알람**.
   2. 다음을 선택하세요: **Alarm User(사이트)** 사이트 전체 액세스를 위한 역할 또는 **Alarm User(파티션)** 사이트 내 특정 파티션에 액세스하기 위한 역할입니다.
   3. 다음을 클릭합니다: **저장**.
      {% endstep %}

{% step %}
**상단에서 Members > Add Member를 클릭합니다.**

1. 사용자를 검색하여 선택합니다.
2. 다음을 클릭합니다: **완료.**
   {% endstep %}
   {% endstepper %}

***

그룹의 액세스는 다음에 적용될 수 있습니다:

* 전체 사이트.
* 사이트 내 하나 이상의 파티션.
* 조직 기반 그룹을 통한 여러 사이트.

{% hint style="warning" %}

* 기본적으로 사용자는 다음 역할을 받습니다: **Alarm User(사이트)** 역할을 받으며 모든 파티션을 무장/해제할 수 있습니다.
* 특정 파티션으로 액세스를 제한하려면 다음을 클릭합니다: **사이트 전체** 다음의 **파티션** 열. 선택을 해제한 뒤 **모든 파티션**를 선택한 다음, 사용자가 무장/해제할 수 있어야 하는 파티션을 선택합니다. 역할은 자동으로 다음으로 변경됩니다: **Alarm User(파티션)**.
* 사이트 전체 역할은 사용자가 Command와 키패드 모두를 통해 무장/해제할 수 있게 합니다. 파티션 범위 역할은 사용자가 키패드를 통해서만 무장/해제할 수 있게 하며 Command 액세스는 제공하지 않습니다.
  {% endhint %}
  {% endtab %}
  {% endtabs %}

***

## 키코드 관리

{% tabs %}
{% tab title="편집" %}
{% stepper %}
{% step %}
**Verkada Command에서 All Products > New Alarms로 이동합니다.**
{% endstep %}

{% step %}
**알람 사이트를 선택합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색 메뉴에서 Keycodes를 선택합니다.**
{% endstep %}

{% step %}
**사용자 > Keycodes를 선택합니다.**
{% endstep %}

{% step %}
**사용자 키코드 오른쪽에서 Regenerate를 선택해 무작위 키코드를 생성하거나, Edit를 선택해 직접 키코드를 입력합니다.**
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="제거" %}
{% stepper %}
{% step %}
**Verkada Command에서 All Products > New Alarms로 이동합니다.**
{% endstep %}

{% step %}
**알람 사이트를 선택합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색 메뉴에서 Keycodes를 선택합니다.**
{% endstep %}

{% step %}
**사용자 > Keycodes를 선택합니다.**
{% endstep %}

{% step %}
**사용자 키코드 오른쪽에서 다음을 클릭합니다:** <i class="fa-trash-can">:trash-can:</i> **삭제.**

{% hint style="danger" %}
이로 인해 **Alarm User** 해당 사이트에서 사용자의 역할이 제거됩니다.
{% endhint %}
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

### 일반 및 긴급 키코드

일반 키코드와 긴급 키코드는 계속 사이트 범위로 유지됩니다. 둘 다 다음에서 추가하고 관리합니다: **일반 자격 증명** 및 **긴급 키코드** 탭에서 알람 사이트의 **키코드** 페이지.

{% hint style="warning" %}
다음을 참조하세요: [새 알람 사이트 설정 구성](/new-alarms/ko/configuration/alarm-sites/configure-new-alarms-site-settings.md#keycodes) 자세한 내용은.&#x20;
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.verkada.com/new-alarms/ko/configuration/keycode-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
