# Verkada Guest를 PowerSchool에 연결하기

PowerSchool은 관리자, 교사, 학생이 사용하는 널리 쓰이는 학교 정보 시스템입니다. Verkada Guest는 학교 구역의 PowerSchool 서버에 연결하여 학생, 보호자, 출석 코드 정보 등을 포함한 학교 데이터를 동기화할 수 있습니다. 이 통합을 사용하면 학교는 지각 도착, 보호자 픽업 등에 맞는 학교별 Guest Type을 구축할 수 있습니다.

***

## 설정

### PowerSchool용 Verkada Guest 플러그인 다운로드

{% hint style="danger" %}
다음 권한이 필요합니다 **조직 관리자** PowerSchool용 Verkada Guest 플러그인을 다운로드할 수 있는 권한입니다.
{% endhint %}

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

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

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

{% step %}
**Download PowerSchool Plugin을 선택합니다.**
{% endstep %}
{% endstepper %}

### Verkada Guest 플러그인 설치

{% stepper %}
{% step %}
**관리자로 PowerSchool에 로그인합니다.**
{% endstep %}

{% step %}
**System Management > Server > Plugin Configuration을 클릭합니다.**

<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%2FJtqfpBTL3T6V75VD6KzH%2F806149555b0532626578ad626cb1a5adc5a76ab8.png?alt=media&#x26;token=609f7355-b8b9-4a45-a8bf-153ecdeb35ae" alt="" width="563"></div>
{% endstep %}

{% step %}
**Install을 클릭합니다.**
{% endstep %}

{% step %}
**Plugin Installation File 아래에서 Choose File을 클릭합니다.**
{% endstep %}

{% step %}
**기기에서 다운로드한 Verkada Guest 플러그인(.zip 파일)을 선택하고 Open을 클릭합니다(파일의 압축을 풀지 말고 .XML 파일을 설치하지 마세요).**&#x20;

{% hint style="warning" %}
플러그인 설치에는 몇 분 정도 걸릴 수 있습니다.
{% endhint %}
{% endstep %}

{% step %}
**Plugin Configuration 페이지에서 플러그인을 활성화하는 상자를 선택합니다.**
{% endstep %}

{% step %}
**열리는 사이드바에서 Enable을 클릭합니다.**
{% endstep %}
{% endstepper %}

### 플러그인용 Client ID 및 Client Secret 가져오기

{% stepper %}
{% step %}
**PowerSchool에서 System Management > Server > Plugin Configuration을 클릭합니다.**
{% endstep %}

{% step %}
**Verkada Guest 플러그인을 선택하여 플러그인 요약 페이지로 이동합니다.**
{% endstep %}

{% step %}
**하단에서 Data Provider Configuration을 선택합니다.**

이 페이지에서 Client ID와 Client Secret을 가져올 수 있습니다.
{% endstep %}
{% endstepper %}

### PowerSchool 서버를 Verkada Command에 연결

{% hint style="danger" %}
다음 권한이 필요합니다 **조직 관리자** PowerSchool 서버를 Command에 연결할 수 있는 권한입니다.
{% endhint %}

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

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

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

{% step %}
**Sync students with PowerSchool를 선택합니다.**
{% endstep %}

{% step %}
**Client ID, Client Secret, PowerSchool Server URL을 입력합니다.**

<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%2FymDtV2DJt39AbA1N2xLa%2F06d1ee1c3dc6943ba549f90c42acca09b4f00a95.png?alt=media&#x26;token=513579c6-0cd8-4ed7-9c9f-c3afdc639d84" alt="" width="188"></div>

{% hint style="warning" %}
PowerSchool Server URL은 PowerSchool 관리자 포털에 액세스할 때 사용하는 주소입니다.<br>

이 값을 얻으려면 웹 브라우저에서 PowerSchool에 로그인한 다음 주소 표시줄에서 URL을 그대로 복사합니다.
{% endhint %}
{% endstep %}

{% step %}
**Sync를 클릭합니다.**
{% endstep %}
{% endstepper %}

***

## 학교를 Guest 사이트에 연결

{% hint style="danger" %}
다음 권한이 필요합니다 **조직 관리자** PowerSchool 학교를 Guest 사이트에 연결할 수 있는 권한입니다.
{% endhint %}

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

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

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

{% step %}
**Sync students with PowerSchool 아래에서 Manage Schools를 선택합니다.**
{% endstep %}

{% step %}
**학교를 Guest 사이트에 연결합니다. 완료되면 오른쪽 상단의 체크 표시를 선택합니다.**
{% endstep %}
{% endstepper %}

***

## 출석 코드를 기록하도록 Guest Type 구성

{% hint style="danger" %}
최소한 다음 권한이 필요합니다 **Workplace Site Admin** Guest Type 설정을 수정할 수 있는 권한입니다.
{% endhint %}

Verkada Guest는 선택적으로 다음에 대해 일일 출석 코드를 PowerSchool에 다시 기록할 수 있습니다. [School Guest Types](https://app.gitbook.com/s/ZyuELZr7uIcXX3WnjX0N/schools/school-guest-types).

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

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

{% step %}
**Sites > Guest Types 아래에서 Manage Guest Types를 클릭합니다.**
{% endstep %}

{% step %}
**기존 School Guest Type을 선택하거나 새로 만듭니다.**
{% endstep %}

{% step %}
**Attendance Code를 클릭합니다.**

<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%2FUng5KlSlaFvUjKrGs51B%2F1c18fd135ee5120f85d33cd36a28841f32f73021.png?alt=media&#x26;token=ea03e7cf-f5e3-40cb-b963-11540e24d361" alt="" width="375"></div>
{% endstep %}

{% step %}
**출석 기록 방법을 선택합니다.**

* **Daily Attendance:** 하나의 출석 코드를 선택합니다.

{% hint style="warning" %}
일일 출석 코드가 있는 Guest Type으로 체크인하면 현재 날짜의 코드가 자동으로 PowerSchool에 다시 기록됩니다.
{% endhint %}

* **Meeting Attendance:** 현재 회의에 대한 출석 코드를 선택하고 필요에 따라 이전 또는 향후 모든 회의에 출석 코드를 적용합니다.

{% hint style="danger" %}
Verkada Guest는 Meeting 및 Daily 출석 기록 방법만 지원합니다. 하나의 Guest Type은 하나의 출석 기록 방법만 사용할 수 있습니다.
{% endhint %}

<div align="left" data-with-frame="true"><figure><img src="https://64756883-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZyuELZr7uIcXX3WnjX0N%2Fuploads%2FJTRbPTsYO8K7yCqnTZF7%2FScreenshot%202025-12-18%20at%2010.57.09%E2%80%AFAM.png?alt=media&#x26;token=355e6021-335a-44fe-a6d4-8dbde1b0212d" alt="" width="303"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**오른쪽 상단에서 Save를 클릭합니다.**
{% endstep %}
{% endstepper %}

***

## FAQ

<details>

<summary>PowerSchool Server URL이란 무엇인가요?</summary>

PowerSchool Server URL은 PowerSchool 관리자 포털의 URL을 의미합니다. 이 URL은 각 PowerSchool 서버마다 고유합니다.

</details>

<details>

<summary>전역 Guest Type에도 출석 코드를 구성할 수 있나요?</summary>

아니요. 사이트 수준의 School Guest Type만 출석 코드로 구성할 수 있습니다.

</details>

<details>

<summary>보호자-학생 연결이 잘못되었거나 누락된 것 같습니다.</summary>

Verkada는 보호자 연락처가 다음 조건을 충족할 때만 보호자를 학생과 연결합니다.

* 다음 항목에 **활성** 상자가 선택되어 있음
* 다음 항목에 **School Pickup** 플래그가 **True** 로 설정되어 있고 대상 학생에 대해

<div align="left" data-with-frame="true"><figure><img src="https://64756883-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZyuELZr7uIcXX3WnjX0N%2Fuploads%2FaYRTLgYuLJB3OhPGz5yr%2Fimage.png?alt=media&#x26;token=efe86d3c-e06c-496d-b8eb-2283bc630800" alt="" width="563"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>학교가 Verkada가 지원하는 방식으로 출석을 기록하는지 어떻게 확인할 수 있나요?</summary>

PowerSchool에는 여러 출석 기록 방법이 있습니다. Verkada Guest는 다음을 사용하는 학교에 출석 코드를 다시 기록하는 것을 지원합니다. **Daily** 및/또는 **Meeting** 출석 기록이 활성화된 경우입니다.

<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%2F3zeAiQC4yZBwKDeVCInz%2F51d1f3ddbd4cab5d90df5f63d554ea76fc6b8280.png?alt=media&#x26;token=7b516976-3d76-4c99-a96d-aa1314549e61" alt="" width="563"></div>

PowerSchool에서 출석 기록을 구성하는 방법에 대해 자세히 알아보세요 [여기](https://ps.powerschool-docs.com/pssis-admin/24.3/attendance-preferences).&#x20;

</details>

<details>

<summary>Attendance Code 기능이 PowerSchool의 Clock In 및 Clock Out 시간에도 기록하나요?</summary>

아니요, Verkada Guest는 출석 코드를 PowerSchool에 다시 기록할 때 Clock In 또는 Clock Out 시간을 채우지 않습니다.

</details>