# ClassLink를 Verkada Guest와 통합

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

* 지각 도착(학교에 늦게 도착한 학생 추적)
* 학생 인계(학생이 부모/보호자에게 인계될 때 추적)
* 자진 퇴실(학생이 일찍 학교를 떠날 때 추적)

***

## ClassLink 구성

### 통합 요구 사항

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

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

{% step %}
**해당 ClassLink Roster Server 사용자는 role: administrator를 가지고 있어야 합니다.**
{% endstep %}

{% step %}
**해당 ClassLink Roster Server 사용자는 ClassLink org type: 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="https://64756883-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZyuELZr7uIcXX3WnjX0N%2Fuploads%2Fgit-blob-c852ee5554a68fdbe736532bdc31011d024d3cb5%2F4a2973a6d1c7f61506b1cc1712f575614873eb4c.png?alt=media" alt="" width="375"></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

어떤 사용자가 다음을 충족하는지 검토하려면 [요구 사항](https://help.verkada.com/guest/ko/schools/integrate-classlink-with-verkada-guest) Guest와의 통합을 위해 3과 4:

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

</details>

<details>

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

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

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

</details>

***

{% hint style="info" %}
**실제로 보고 싶으신가요?** 다음을 확인해 보세요 [동영상 튜토리얼](https://www.youtube.com/watch?v=WFUluswVNJ0).
{% endhint %}