> 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/guest/ko/schools/integrate-classlink-with-verkada-guest.md).

# ClassLink를 Verkada Guest와 통합

ClassLink는 학교 관리자, 교사, 학생들이 사용하는 널리 쓰이는 IdP(Identity Provider)입니다. Verkada Guest를 사용하면 ClassLink에서 학생 명단 정보를 동기화할 수 있습니다. 이를 통해 다음을 포함한 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 type: district에 연결되어 있어야 합니다**
{% endstep %}
{% endstepper %}

요구 사항 2-4를 충족하는 해당 ClassLink Roster Server 사용자가 없는 경우, ClassLink Tenant Admin이 Roster Server에 수동 레코드를 추가할 수 있습니다.

### ClassLink에 Verkada Guest 추가

{% 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 %}
**왼쪽 탐색에서 게스트 설정을 클릭합니다.**
{% endstep %}

{% step %}
**조직 아래에서 학교를 선택합니다.**
{% 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 %}
**왼쪽 탐색에서 게스트 설정을 클릭합니다.**
{% endstep %}

{% step %}
**조직 아래에서 학교를 선택합니다.**
{% 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 Orgs와 연결할 수 없습니다.

***

## 자주 묻는 질문

<details>

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

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

ClassLink Launchpad에서 Roster Server로 이동한 다음 ApplicationsSelect Verkada GuestSelect Users를 선택합니다

어떤 사용자가 충족하는지 검토하려면 [요구 사항](/guest/ko/schools/integrate-classlink-with-verkada-guest.md) Guest와의 통합에 대한 3 및 4번:

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

</details>

<details>

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

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

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

</details>

***

{% hint style="info" %}
**실제로 보고 싶으신가요?** 다음 항목을 확인하세요. [동영상 튜토리얼](https://www.youtube.com/watch?v=WFUluswVNJ0).
{% 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/guest/ko/schools/integrate-classlink-with-verkada-guest.md?ask=<question>&goal=<endgoal>
```

`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.