> 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는 학교 관리자, 교사, 학생들이 사용하는 인기 있는 ID 공급자(IdP)입니다. 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 유형: 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
  * 이메일
  * 전화
* 컬렉션: **조직**
  * sourcedId
  * dateLastModified
  * 유형
  * status
  * 이름
    {% 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와 연결할 수 없습니다.

***

## FAQ

<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) Guest와의 통합을 위해 3과 4:

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

</details>

<details>

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

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

* **sourcedId** – 모든 보호자 사용자에게 존재해야 합니다
* **enabledUser** – 다음으로 설정되어야 합니다 `true`
* **orgSourcedIds** – 모든 보호자 사용자에 대해 최소 하나의 값이 설정되어야 합니다
* **role** – 다음으로 설정되어야 합니다 `보호자`
* **username** – 모든 보호자 사용자에게 존재해야 합니다
* **agentSourcedIds** – 보호자가 접근하도록 승인된 학생의 sourcedId를 포함해야 합니다. 여러 학생의 경우 각 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.
