# ClassLink를 Verkada Guest와 통합

ClassLink는 학교 관리자, 교사, 학생들이 사용하는 널리 쓰이는 IdP(Identity Provider)입니다. Verkada Guest를 사용하면 ClassLink에서 학생 명단(roster) 정보를 동기화할 수 있습니다. 이를 통해 다음을 포함하는 Student Guest 유형을 사용할 수 있습니다:

* 지각 도착(학교에 늦게 도착하는 학생 추적)
* 학생 픽업(학생이 부모/보호자에게 인계되는 시점 추적)
* 자기 퇴실(학생이 일찍 학교를 떠나는 시점 추적)

***

## ClassLink 구성

### 통합 요구 사항

{% stepper %}
{% step %}
**통합을 설정하는 Command 사용자는 Org Admin이어야 합니다**
{% endstep %}

{% step %}
**Command 사용자의 이메일은 대상 ClassLink 테넌트에 있는 ClassLink Roster Server 사용자의 이메일과 일치해야 합니다.**
{% endstep %}

{% step %}
**해당 ClassLink Roster Server 사용자는 역할이 administrator여야 합니다**
{% endstep %}

{% step %}
**해당 ClassLink Roster Server 사용자는 ClassLink org 유형: district에 연결되어 있어야 합니다**
{% endstep %}
{% endstepper %}

2\~4번 요구 사항을 충족하는 해당 ClassLink Roster Server 사용자가 없는 경우, ClassLink 테넌트 관리자는 Roster Server에 수동 레코드를 추가할 수 있습니다.

### Verkada Guest를 ClassLink에 추가

{% stepper %}
{% step %}
**ClassLink Roster Server에서 Apps로 이동한 다음 ADD를 클릭합니다.**
{% endstep %}

{% step %}
**"Verkada Guest"를 검색한 다음 + Add를 클릭합니다.**
{% endstep %}

{% step %}
**Apps 메뉴에서 Verkada Guest의 Enabled를 켭니다.**
{% endstep %}

{% step %}
**다음 필드가 공유되도록 Verkada Guest 앱의 권한을 구성합니다:**

* 컬렉션: **사용자**
  * sourcedid
  * dateLastModified
  * orgSourcedids
  * username
  * familyName
  * status
  * enabledUser
  * role
  * givenName
  * identifier
  * agentSourcedIds
  * middleName
  * email
  * phone
* 컬렉션: **조직**
  * sourcedId
  * dateLastModified
  * type
  * status
  * name
    {% endstep %}
    {% endstepper %}

### Command에서 ClassLink 연결

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

{% step %}
**왼쪽 탐색 메뉴에서 Guest Settings를 클릭합니다.**
{% endstep %}

{% step %}
**Organization 아래에서 Schools를 선택합니다.**
{% endstep %}

{% step %}
**ClassLink와 학생 동기화를 클릭합니다.**

a. 테넌트 ID를 입력합니다.\
b. 선택 **동기화**.
{% endstep %}

{% step %}
**통합을 설정하는 Command 사용자에게 확인 이메일이 전송됩니다. 이 이메일의 링크를 클릭하여 통합을 확인합니다.**
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
다음의 [통합 요구 사항](#h_d9bc5d61fa) ClassLink 통합을 완료하려면 충족되어야 합니다.
{% endhint %}

***

## Command 구성

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

{% step %}
**왼쪽 탐색 메뉴에서 Guest Settings를 클릭합니다.**
{% endstep %}

{% step %}
**Organization 아래에서 Schools를 선택합니다.**
{% endstep %}

{% step %}
**ClassLink의 학교를 Guest 사이트에 할당합니다.**

<div align="left" data-with-frame="true"><img src="/files/96d3572b29ff271353c2b0f021d96607d32611c6" alt=""></div>
{% endstep %}
{% endstepper %}

하나의 학교는 하나 또는 여러 Guest 사이트에 할당될 수 있습니다. 하나의 Guest 사이트에는 학교 하나만 할당할 수 있습니다. 하나의 ClassLink 테넌트만 하나의 Command Org와 페어링할 수 있습니다. ClassLink 테넌트는 여러 Command Org와 페어링할 수 없습니다.

***

## 자주 묻는 질문

<details>

<summary>어떤 ClassLink Roster Server 사용자들이 Verkada Guest와 공유되고 있는지 어떻게 확인하나요?</summary>

Verkada Guest와 공유되는 사용자를 확인하려면:

ClassLink Launchpad에서 Roster Server로 이동Select ApplicationsSelect Verkada GuestSelect Users

어떤 사용자들이 다음을 충족하는지 검토하려면 [요구 사항](/guest/ko/schools/integrate-classlink-with-verkada-guest.md) 3번과 4번을 충족하여 Guest와 통합:

Role 열을 administrator로 필터링합니다Filter School을 ClassLink의 구/지역 이름으로 필터링합니다. 이 이름은 Orgs 탭으로 이동하여 org type: district인 항목을 찾아 확인할 수 있습니다.

</details>

<details>

<summary>학생과 보호자를 연결하려면 무엇이 필요한가요?</summary>

ClassLink에서 보호자를 학생과 연결하려면 각 보호자 사용자에 대해 다음 필드가 구성되어 있어야 합니다:

* **sourcedId** – 모든 보호자 사용자에게 있어야 함
* **enabledUser** – 다음으로 설정되어야 함 `true`
* **orgSourcedIds** – 모든 보호자 사용자에 대해 최소 하나의 값이 설정되어 있어야 함
* **role** – 다음으로 설정되어야 함 `guardian`
* **username** – 모든 보호자 사용자에게 있어야 함
* **agentSourcedIds** – 보호자가 접근 권한이 있는 학생의 sourcedIds를 포함해야 합니다. 여러 학생의 경우 각 ID를 쉼표로 구분합니다(예: `id1,id2,id3`).

</details>

***

{% hint style="info" %}
**실제 사용 모습을 보고 싶으신가요?** 다음을 확인해 보세요 [비디오 튜토리얼](https://www.youtube.com/watch?v=WFUluswVNJ0).
{% 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/guest/ko/schools/integrate-classlink-with-verkada-guest.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.